跑通商汤示例项目

  • iOS

更新时间

了解如何快速接入秀场直播,完成环境准备、参数配置、示例运行和核心流程验证。

本文介绍如何快速跑通 BeautyAPI 示例项目,体验商汤美颜效果。

前提条件

开始前,请确保满足以下前提条件:

  • Git
  • CocoaPods
  • Xcode 13.0 及以上
  • 有效的苹果开发者账号
  • 开通秀场直播服务
  • iOS 设备,版本 11.0 及以上

    注意

    声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。

克隆仓库

运行以下命令克隆仓库到本地:

Shell
git clone git@github.com:AgoraIO-Community/BeautyAPI.git

集成第三方美颜 SDK

按照如下步骤进行集成:

  1. 联系商汤技术支持获取最新的美颜 SDK、美颜资源、美颜证书。

  2. 下载并解压美颜 SDK 等文件,然后将如下文件添加到美颜示例项目对应的文件路径下:

    文件项目路径
    SenseAR_Effects_<version_id>_iOS/libs/ios_os-universal/libst_mobile.aiOS/SenseLib/st_mobile_sdk/libs/ios_os/libst_mobile.a
    SenseAR_Effects_<version_id>_iOS/include/*.hiOS/SenseLib/st_mobile_sdk/include/*.h
    SenseAR_Effects_<version_id>_iOS/models/*.modeliOS/SenseLib/st_mobile_sdk/models/*.model
    SenseAR_Effects_<version_id>_iOS/models/*.bundleiOS/SenseLib/st_mobile_sdk/models/*.bundle
    SenseAR_Effects_<version_id>_iOS/samples/SenseMeEffects/SenseMeEffects/datasource/resources/StickerZipAndIcons/lianxingface.zipiOS/SenseLib/sticker_face_shape/lianxingface.zip
    SenseAR_Effects_<version_id>_iOS/samples/SenseMeEffects/SenseMeEffects/datasource/resources/Makeup/qingzhuang.bundle/*.zipiOS/SenseLib/style_lightly/*.zip
    证书:SENSEME.liciOS/SenseLib/SENSEME.lic
    表格内容超出当前宽度,可横向滚动查看更多列。

配置示例项目

按照如下步骤进行配置:

  1. 运行美颜项目前,你需要在 iOS/BeautyAPI/KeyCenter.swift 文件中设置如下参数:

    Swift
    static let AppId: String = <#YOUR_APP_ID#>

    你可以在创建声网项目后,从控制台获取这些参数的值,详情如下:

    参数描述获取方式
    AppId声网项目的 App ID获取 App ID
    表格内容超出当前宽度,可横向滚动查看更多列。
  2. 在 iOS/ 目录下运行 pod install,然后等待依赖库安装完成。

编译并运行示例项目

按照如下步骤进行操作:

  1. 连接上 iOS 设备后,点击 BeautyAPi.xcodeproj 文件以通过 Xcode 打开项目,并在 iOS Device 选项中勾选上你的 iOS 设备。

  2. 在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的苹果开发者账号和 Bundle Identifier。Bundle ID 是设备上应用程序的唯一标识。在开发应用时,你需要设置 Bundle ID。在此处设置的 Bundle ID 需要与你申请商汤美颜 SDK 时提供的 Bundle ID 一致。

  3. 点击 开始运行 开始编译。

  4. 编译成功后,你的 iOS 设备上会出现美颜应用。在 iOS 系统设置中将该应用设为信任开发者后你才能打开应用。

  5. 打开美颜应用,进行体验。