跑通示例项目
声网在 GitHub 上提供一个开源的 MetaWorld 示例项目供你参考。
MetaWorld 包含元语聊和元直播场景:
- 在元语聊场景中,用户可以在 3D 场景中自由走动,与其他用户或 NPC 进行语音聊天,开始 K 歌等。
- 在元直播场景中,用户可以在 3D 场景中直播。声网面部捕捉插件使用户可以通过模拟脸部表情的 Avatar 形象进行直播,增加直播趣味性。
- 在融合元语聊和元直播的场景中,用户可以进行在元语聊和元直播场景中支持的所有操作。
本文介绍如何快速跑通该示例项目,体验效果。
前提条件
开始前请确保你的开发环境满足如下要求:
-
Android Studio 4.1 及以上
-
Android API 级别 22 及以上
-
Android 设备,版本 Android 5.1 及以上
信息声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
-
可以访问互联网的计算机。如果你的网络环境部署了防火墙,参考应对防火墙限制以正常使用声网服务
-
联系 sales@shengwang.cn 并提供你的声网项目的 App ID,开通声网内容中心的权限,并获取声网面部捕捉插件的 App ID 和 Certificate
获取示例项目
参考如下步骤获取 MetaWorld 示例项目:
-
运行以下命令克隆仓库到本地:
Shellgit clone git@github.com:AgoraIO-Community/Agora-MetaWorld.git
-
运行以下命令切换到
dev_metasdk1.0
分支:Shellgit checkout dev_metasdk1.0
配置示例项目
参考如下步骤配置示例项目。
集成 SDK 和依赖库
声网 Meta SDK 是基于声网 RTC SDK 4.0.1 版开发的元系列特殊版 SDK。参考如下步骤获取并将 SDK 集成到你的项目中:
-
联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
-
打开解压的 SDK,将以下文件或子文件夹复制到你的项目路径中。
文件或子文件夹 项目路径 agora-rtc-sdk.jar
文件/app/libs/
AgoraMetaKit.aar
文件/app/libs/
face_capture.jar
文件/app/libs/
FaceCapture.aar
文件/app/libs/
metakit.jar
文件/app/libs/
arm64-v8a
文件夹/app/src/main/jniLibs/
armeabi-v7a
文件夹/app/src/main/jniLibs/
x86_64
文件夹/app/src/main/jniLibs/
x86
文件夹/app/src/main/jniLibs/
设置 ID 和证书
运行示例项目前,你需要在 ./Agora-MetaWorld/Android/local.properties
文件中添加并设置如下参数:
APP_CERTIFICATE="<#Certificate#>"
APP_ID="<#AppId#>"
FACE_CAP_APP_ID="<#Face Capture App Id#>"
FACE_CAP_APP_KEY="<#Face Capture Certificate#>"
其中:
<#Certificate#>
填入你在控制台获取到的声网项目的 App 证书。<#AppId#>
填入你在控制台获取到的声网项目的 App ID。<#Face Capture App Id#>
和<#Face Capture Certificate#>
为声网面部捕捉插件相关,需要联系 sales@shengwang.cn 获取。
编译并运行示例项目
参考如下步骤在 Android Studio 中编译并运行项目:
-
用 Android Studio 打开
Agora-MetaWorld/Android
文件夹。 -
开启 Android 设备的开发者选项,打开 USB 调试,通过 USB 连接线将 Android 设备接入电脑,并在 Android 设备选项中勾选你的 Android 设备。
-
在 Android Studio 中,点击 Sync Project with Gradle Files 按钮,以让项目与 Gradle 文件同步。
-
待同步成功后,点击 开始编译。
-
编译成功后,你的 Android 设备上会出现 AgoraMetaExample App。
-
打开 App,体验 MetaWorld 场景。登录后默认进入融合元语聊和元直播的场景,点击右上角的 即可切换至元直播场景。