百度一镜数字人SDK集成教程:在Android/iOS应用中嵌入虚拟人

月夜之吻

月夜之吻

2026-07-15

686人浏览

原创

必须严格匹配人像包、鉴权文件、平台架构与调用链路,任一环节错位都将导致白屏、崩溃或静音;人像包解压后放入assets/case/,license文件置于assets根目录且文件名与代码中setlicensefilename()参数完全一致。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

百度一镜数字人sdk集成教程:在android/ios应用中嵌入虚拟人

要在Android或iOS原生应用中稳定加载并驱动百度“一镜数字人”SDK,必须严格匹配人像包、鉴权文件、平台架构与调用链路,任一环节错位都将导致白屏、崩溃或静音。

准备人像包与License文件

从百度运营侧获取两样核心资源:一是人像资源压缩包(如yuki_h5_250206.zip),二是以.license为后缀的鉴权文件(如xuniren-avatar-debug-0004.license)。

解压人像包,将全部子目录(含config.jsonmodel/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)
小猿AI (iOS)

小猿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 DescriptionPrivacy - 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()即可立即终止当前语音与口型动画。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

android 百度 百度一镜

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

4

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

1

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

6

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

3

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

0

10

火山引擎对象存储使用教程
火山引擎对象存储使用教程

火山引擎对象存储适合用于网站图片、视频文件、备份数据、静态资源和应用附件管理。本专题整理TOS控制台入口、存储桶创建、地域选择、权限设置、文件上传、访问链接生成、CDN加速、费用查看和常见上传或访问失败问题,帮助用户快速掌握对象存储基础操作。

2026.08.04

1

10

火山引擎云服务器使用教程
火山引擎云服务器使用教程

火山引擎云服务器使用教程适合第一次购买、部署和管理云服务器的用户参考。本专题整理控制台入口、实例创建、地域和配置选择、系统镜像设置、安全组放行、远程连接、网站部署、续费计费和常见连接失败问题,帮助用户快速完成云服务器基础使用流程。

2026.08.04

3

10

火山引擎API Key绑定大模型教程
火山引擎API Key绑定大模型教程

火山引擎API Key怎么绑定大模型适合需要在火山方舟、应用后台、脚本工具或AI编程软件中调用模型的开发者参考。本专题整理控制台服务开通、API Key创建、模型权限检查、模型ID选择、Base URL填写、调用测试和鉴权失败排查,帮助用户完成从密钥到模型调用的配置流程。

2026.08.04

2

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
百度一镜学习中心
百度一镜学习中心

共0课时 | 0人学习

百度一镜互动对外接口文档
百度一镜互动对外接口文档

共0课时 | 0人学习

Excel 教程
Excel 教程

共162课时 | 39.4万人学习