必须严格匹配人像包、鉴权文件、平台架构与调用链路,任一环节错位都将导致白屏、崩溃或静音;人像包解压后放入assets/case/,license文件置于assets根目录且文件名与代码中setlicensefilename()参数完全一致。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Android或iOS原生应用中稳定加载并驱动百度“一镜数字人”SDK,必须严格匹配人像包、鉴权文件、平台架构与调用链路,任一环节错位都将导致白屏、崩溃或静音。
准备人像包与License文件
从百度运营侧获取两样核心资源:一是人像资源压缩包(如yuki_h5_250206.zip),二是以.license为后缀的鉴权文件(如xuniren-avatar-debug-0004.license)。
解压人像包,将全部子目录(含config.json、model/、texture/等)完整放入assets/case/路径下;【license文件必须直接放在assets根目录,不可嵌套子文件夹】。
确认license文件名与代码中设置的字符串完全一致,包括大小写和下划线——例如xuniren-avatar-debug-0004.license对应代码中setLicenseFilename("xuniren-avatar-debug-0004")。
Android端集成步骤
第一步:在app/build.gradle中添加SDK依赖:
implementation 'com.baidu.digitalhuman:3d-sdk:1.0.9.12'
第二步:初始化配置对象,填入正确路径与参数:
Avatar3DConfig avatar3DConfig = digitalHumanSettings.getAvatarConfig();
avatar3DConfig.setLicenseFilename("xuniren-avatar-debug-0004");
avatar3DConfig.setCasePath("case"); // 指向assets/case/下的解压目录
第三步:启动引擎前,务必检查设备是否满足最低性能要求:【骁龙730G / 天玑820 或同等性能以上芯片,否则渲染将卡顿或黑屏】。
第四步:调用DigitalHumanEngine.start()启动渲染,传入SurfaceView容器及上下文。
小猿AI(iOS)3.136.0版本更新重点优化拍照批改与题目识别速度,提升复杂手写题的识别准确率,并新增“错题智能归类”与“AI分步骤讲解”功能,帮助学生更清晰理解解题过程。同时优化学习数据面板展示,让家长可更直观掌握学习进度,整体提升作业检查与学习辅导体验。
iOS端集成流程
方法一:CocoaPods自动集成
在Podfile中添加:pod 'BDAIDigitalHumanSDK', '1.0.9.12',执行pod install。
方法二:手动Framework集成
将BDAIDigitalHumanSDK.framework拖入Xcode工程,勾选Embed & Sign;同时在Info.plist中声明两项权限:Privacy - Camera Usage Description和Privacy - Microphone Usage Description,【缺一不可,否则APP启动即闪退】。
初始化BDH5Browser实例时,必须设置homeUrl为含&useNative=1参数的认证URL,例如:https://brain.baidu.com/face/print/?token=xxx&useNative=1。
启动数字人并驱动播报
1. 确保网络通畅且License未过期——过期license会静默失败,无任何报错日志。
2. 文本驱动调用方式(推荐):
digitalHumanEngine.speakText("您好,欢迎使用数字人服务", ttsId, ttsKey);
3. 音频驱动需确保PCM数据采样率为16000Hz或24000Hz,且声道数为1(单声道);若传入MP3或AAC格式,SDK将直接拒绝处理。
4. 播报过程中如需打断,调用digitalHumanEngine.stopSpeaking()即可立即终止当前语音与口型动画。










