Skip to content

Latest commit

 

History

History

Show

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Beauty
Beauty
 
 
Common
Common
 
 
Controller
Controller
 
 
Debug
Debug
 
 
Models
Models
 
 
Service
Service
 
 
Utils
Utils
 
 
View
View
 
 
image
image
 
 
showResource.bundle
showResource.bundle
 
 
README.md
README.md
 
 

README.md

秀场直播

本文档主要介绍如何快速跑通 秀场直播 示例工程

Demo 效果:

1. 环境准备

  • 最低兼容 iOS 13.0
  • Xcode

2. 运行示例

  • 2.1 进入声网控制台获取 APP ID 和 APP 证书 控制台入口

    • 点击创建项目

      图片

    • 选择项目基础配置, 鉴权机制需要选择安全模式

      图片

    • 拿到项目 APP ID 与 APP 证书

      图片

    • 在项目的功能配置中启用"实时消息 RTM"功能, 同时启用下列子模块

      • 状态同步（Storage） 配置
      • 分布式锁（Lock ）配置 
        注: 如果没有启动"实时消息 RTM"功能, 将无法体验项目完整功能

    • 秒切机器人服务配置（CloudPlayer）

      注: 请联系声网技术支持为您的 APPID 开通 rte-cloudplayer 权限, 开通权限后才能启动默认的机器人房间推流

      图片 图片 图片

  • 2.2 在项目的KeyCenter.swift里填写需要的声网 App ID 和 App证书

    xxx

    static let AppId: String = 声网AppID
static let Certificate: String? = 声网App证书

  • 2.3 美颜配置

    注: 项目使用的美颜资源需要向第三方美颜提供商获取, 没有美颜资源仅影响直播过程中的美颜效果, 不会影响 Demo 的运行

商汤

  • 1.新建一个文件夹命名为SenseLib放在Podfile的同级目录下，并将商汤SDK里的资源文件复制到SenseLib 目录下。如图：

    xxx

    注意：以上只包含基础美颜功能。
    如果需要贴纸或者风格效果，需要联系商汤获取，同样将资源放到SenseLib指定路径下即可，如图：

    xxx xxx

  • 2.将申请到的商汤的license文件命名为“SENSEME.lic”并放入SenseLib指定路径下即可，如图：

    xxx

  • 3.注意事项：

    申请商汤美颜的bundle id一定要和工程的bundle id保持一致，否则美颜是无效的

相芯

  • 1.新建一个文件夹命名为FULib放在Podfile的同级目录下

    注意：默认不放入资源只包含基础美颜功能。
    如果需要贴纸或者风格效果，需要联系相芯获取，同样将资源放到FULib/Resources路径下即可。如图：

    xxx

  • 2.将申请到的相芯的license文件命名为“authpack.h”并拖入FULib路径下 如图：

    xxx

  • 3.注意事项：

    申请相芯美颜的bundle id一定要和工程的bundle id保持一致，否则美颜是无效的

火山/字节

  • 1.新建一个文件夹命名为ByteEffectLib放在Podfile的同级目录下，并将火山SDK里的资源文件复制到ByteEffectLib 目录下。如图：

    xxx

    注意：以上只包含基础美颜功能。
    如果需要贴纸或者风格效果，需要联系相芯获取，同样将资源放到ByteEffectLib/Resources路径下即可。如图：

    xxx

  • 2.将申请到的火山的license文件“LicenseBag.bundle”拖入ByteEffectLib/Resources路径下,并修改Config.h文件中的LICENSE_NAME 如图：

    xxx xxx

  • 3.注意事项：

    申请火山美颜的bundle id一定要和工程的bundle id保持一致，否则美颜是无效的

  • 更新pod

    打开终端，cd到Podfile所在目录，执行

    pod install

    如果xcode14编译失败并遇到下图错误

    xxx

    在终端执行如下命令将cocoapods升级到1.12.0以上：

    sudo gem install -n /usr/local/bin cocoapods

    如果网络不好升级失败，也可以手动给三方库签名

    将Team里的None替换成你自己的签名即可

  • 运行项目即可开始您的体验

3. 项目介绍

3.1 概述

秀场直播项目是声网秀场直播场景的开源代码，开发者可以获取并添加到您的APP工程里，本源码会伴随声动互娱Demo同步更新，为了获取更多新的功能和更佳的体验，强烈推荐您下载最新代码集成。

3.2 功能介绍

秀场直播场景目前已涵盖以下功能

   func onCapture(_ videoFrame: AgoraOutputVideoFrame) -> Bool {
        videoFrame.pixelBuffer = BeautyManager.shareManager.processFrame(pixelBuffer: videoFrame.pixelBuffer)
        return true
    }

商汤美颜功能的详细封装请参考SenseBeautyManager

  • 虚拟背景和虚化背景

    相关代码请参考： ShowAgoraKitManager的函数enableVirtualBackground和seVirtualtBackgoundImage

3.3 场景化 API

声动互娱-秀场直播项目内使用了

  • 美颜场景化 API (简称 BeautyAPI)来实现多第三方美颜快速接入, 对应代码文件: BeautyAPI,如果您想进一步了解 BeautyAPI, 可以参考 BeautyAPI Demo

  • 秒开秒切场景化 API (简称 VideoLoaderAPI)来实现观众看播视频秒出图、秒切换直播间的能力, 对应代码文件: VideoLoaderAPI, 如果您想进一步了解 VideoLoaderAPI, 可以参考 VideoLoaderAPI Demo

4. FAQ

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

    • 方案1：可以从智能客服获取帮助或联系技术支持人员 声网支持

    • 方案2：加入微信群提问