Skip to content

README.zh.md

Latest commit

 

History

History
140 lines (103 loc) · 5.21 KB

README.zh.md

File metadata and controls

140 lines (103 loc) · 5.21 KB
Raw

美颜场景化API Demo

English | 中文

本文档主要介绍如何快速跑通美颜场景化API示例代码。

Demo 效果：

1. 环境准备

  • 最低兼容 Android 6.0（SDK API Level 23）
  • Android Studio Hedgehog（2023.1.1）及以上版本，使用 JDK 17
  • Android 6.0 及以上的手机设备

2. 运行示例

2.1 获取声网 App ID

声网Agora - 文档中心 - 如何获取 App ID

  • 选择调试模式并创建（本示例仅支持调试模式）
  • 复制 App ID

2.2 配置 App ID

在 Android 目录下创建 local.properties，并在 Android/local.properties 里填写上面复制的声网 App ID：

AGORA_APP_ID=你的声网AppID

2.3 配置美颜 SDK

重要说明： 本 Demo 中的美颜 SDK 是通过脚本自动下载的，仅用于演示目的。在实际项目中，请根据业务需求选择合适的美颜 SDK。

联系美颜厂家获取对应的美颜证书和资源，并做以下配置（如果没有配置美颜证书和资源，对应厂家美颜会显示黑屏）：

商汤美颜（可选）

  • 在 app/build.gradle 里配置证书对应的包名 applicationId

  • SDK 集成方式：将商汤美颜 SDK 的 .aar 文件放置在 lib_sensetime/libs/ 对应子目录下：

    • HardwareBuffer/HardwareBuffer-release.aar
    • SenseArSourceManager/SenseArSourceManager-release.aar
    • STMobileJNI/STMobileJNI-release.aar

  • 解压商汤美颜SDK并复制以下文件/目录到对应路径下

商汤SDK文件/目录 项目路径
Android/models app/src/main/assets/beauty_sensetime/models
Android/smaple/SenseMeEffects/app/src/main/assets/sticker_face_shape app/src/main/assets/beauty_sensetime/sticker_face_shape
Android/smaple/SenseMeEffects/app/src/main/assets/style_lightly app/src/main/assets/beauty_sensetime/style_lightly
Android/smaple/SenseMeEffects/app/src/main/assets/makeup_lip app/src/main/assets/beauty_sensetime/makeup_lip
SenseME.lic app/src/main/assets/beauty_sensetime/license/SenseME.lic

相芯美颜（可选）

  • 在 app/build.gradle 里配置证书对应的包名 applicationId

  • SDK 集成方式：通过 lib_faceunity/build.gradle 文件中的依赖配置

  • 将相芯美颜资源放入对应路径下

美颜资源 项目路径
美妆资源(如naicha.bundle) app/src/main/assets/beauty_faceunity/makeup
贴纸资源(如fashi.bundle) app/src/main/assets/beauty_faceunity/sticker
证书authpack.java app/src/main/java/io/agora/beautyapi/demo/module/faceunity/authpack.java

字节火山美颜（可选）

  • 在 app/build.gradle 里配置证书对应的包名 applicationId

  • SDK 集成方式：将字节火山美颜 SDK 的 .aar 文件放置在 lib_bytedance/libs/ 对应子目录下：

    • EffectAAR/effectAAR-release.aar

  • 修改 ByteDanceBeautySDK.kt 文件里 LICENSE_NAME 为申请到的证书文件名

  • 解压字节/火山美颜资源并复制以下文件/目录到对应路径下

字节SDK文件/目录 项目路径
resource/LicenseBag.bundle app/src/main/assets/beauty_bytedance
resource/ModelResource.bundle app/src/main/assets/beauty_bytedance
resource/ComposeMakeup.bundle app/src/main/assets/beauty_bytedance
resource/StickerResource.bundle app/src/main/assets/beauty_bytedance

2.4 运行项目

  • 使用 Android Studio 打开 Android 项目，点击运行即可

3. 集成到项目

重要提醒： 本 Demo 中的美颜 SDK 仅用于演示，实际项目集成时请使用官方提供的正式版本 SDK。

每个美颜可以单独集成到自己的项目，详见对应的集成说明文档

美颜 集成说明
商汤 官网文档
相芯 官网文档
字节火山 官网文档

4. 集成遇到困难，该如何联系声网获取协助

方案1： 如果您已经在使用声网服务或者在对接中，可以直接联系对接的销售或服务

方案2： 发送邮件给 support@agora.io 咨询

方案3： 扫码加入我们的微信交流群提问

5. 代码许可

The MIT License (MIT)