# 一、SDK 说明

声纹识别（Voice-print Recognize），是一项提取说话人声音特征和说话内容信息，自动核验说话人身份的技术。
SDK 详细的接口介绍及说明请参考：HarmonyOS 文档。

示例 demo (opens new window)

SDK 包 (opens new window)

# 二、SDK 集成步骤

# 1.调用流程

项目引用 SDK 集成 har 包，调用对应 api 方法

# 三、Demo 使用方法

将 SDK 中 libs 下面的 har 包拷贝到工程的 libs 目录下；
工程结构图如下：

"dependencies":
  {
    "unievallibrary": "file:libs/UniEvalLibrary.har"
  }

该代码加入到 oh-package.json5
动态获取权限，运行过程需要给予应用所需要的录音权限

# 四、SDK 说明

1、创建声纹群组

{
	"code": 0,
	  "msg": "success",
	  "sid": "b3605dd0822545f6b62471a0b4b8fb7e",
	  "data": {    
		"groupId": "30A74309-679A-4B51-8711-7C75D40507EA",
		    "groupInfo": "声纹识别组"  
	}
}
1
2
3
4
5
6
7
8
9

输入群组内容，返回创建的群组 id 和描述

2、创建声纹

{  
	"code": 0,
	  "msg": "success",
	  "sid": "a4e6d40bfd804cc3ad9ae684d96f445e",
	  "data": {    
		"featureId": "62D151CE-C572-4EC2-8F59-D26B53F6CCD9",
		    "featureInfo": "创建声纹,2025-03-03 15:22"  
	}
}
1
2
3
4
5
6
7
8
9

输入 audioData 音频数据通过 base64 转 string 后，返回声纹 id

3、声纹辨认 1:1

{  
	"code": 0,
	  "msg": "success",
	  "sid": "ae625962246749a395d12bfd9cbf4427",
	  "data": {    
		"score": 81.56086,
		    "featureId": "62D151CE-C572-4EC2-8F59-D26B53F6CCD9",
		    "featureInfo": "创建声纹,2025-03-03 15:22"  
	}
}
1
2
3
4
5
6
7
8
9
10

选择对应的声纹辨认，返回对应的分数 score 在 60-100 内匹配算成功

# 六、错误码

错误码查询 (opens new window)

← WebAPI文档 →