跑通商汤示例项目
- iOS
更新时间
了解如何快速接入秀场直播,完成环境准备、参数配置、示例运行和核心流程验证。
本文介绍如何快速跑通 BeautyAPI 示例项目,体验商汤美颜效果。
前提条件
开始前,请确保满足以下前提条件:
- Git
- CocoaPods
- Xcode 13.0 及以上
- 有效的苹果开发者账号
- 开通秀场直播服务
- iOS 设备,版本 11.0 及以上
注意
声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
克隆仓库
运行以下命令克隆仓库到本地:
git clone git@github.com:AgoraIO-Community/BeautyAPI.git集成第三方美颜 SDK
按照如下步骤进行集成:
-
联系商汤技术支持获取最新的美颜 SDK、美颜资源、美颜证书。
-
下载并解压美颜 SDK 等文件,然后将如下文件添加到美颜示例项目对应的文件路径下:
表格内容超出当前宽度,可横向滚动查看更多列。文件 项目路径 SenseAR_Effects_<version_id>_iOS/libs/ios_os-universal/libst_mobile.aiOS/SenseLib/st_mobile_sdk/libs/ios_os/libst_mobile.aSenseAR_Effects_<version_id>_iOS/include/*.hiOS/SenseLib/st_mobile_sdk/include/*.hSenseAR_Effects_<version_id>_iOS/models/*.modeliOS/SenseLib/st_mobile_sdk/models/*.modelSenseAR_Effects_<version_id>_iOS/models/*.bundleiOS/SenseLib/st_mobile_sdk/models/*.bundleSenseAR_Effects_<version_id>_iOS/samples/SenseMeEffects/SenseMeEffects/datasource/resources/StickerZipAndIcons/lianxingface.zipiOS/SenseLib/sticker_face_shape/lianxingface.zipSenseAR_Effects_<version_id>_iOS/samples/SenseMeEffects/SenseMeEffects/datasource/resources/Makeup/qingzhuang.bundle/*.zipiOS/SenseLib/style_lightly/*.zip证书: SENSEME.liciOS/SenseLib/SENSEME.lic
配置示例项目
按照如下步骤进行配置:
-
运行美颜项目前,你需要在
iOS/BeautyAPI/KeyCenter.swift文件中设置如下参数:Swift static let AppId: String = <#YOUR_APP_ID#>你可以在创建声网项目后,从控制台获取这些参数的值,详情如下:
表格内容超出当前宽度,可横向滚动查看更多列。参数 描述 获取方式 AppId声网项目的 App ID 获取 App ID -
在
iOS/目录下运行pod install,然后等待依赖库安装完成。
编译并运行示例项目
按照如下步骤进行操作:
-
连接上 iOS 设备后,点击
BeautyAPi.xcodeproj文件以通过 Xcode 打开项目,并在 iOS Device 选项中勾选上你的 iOS 设备。 -
在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的苹果开发者账号和 Bundle Identifier。Bundle ID 是设备上应用程序的唯一标识。在开发应用时,你需要设置 Bundle ID。在此处设置的 Bundle ID 需要与你申请商汤美颜 SDK 时提供的 Bundle ID 一致。
-
点击
开始编译。
-
编译成功后,你的 iOS 设备上会出现美颜应用。在 iOS 系统设置中将该应用设为信任开发者后你才能打开应用。
-
打开美颜应用,进行体验。