Read this in other languages: English
这个开源示例项目演示了如何结合 Agora视频SDK 和ARKit，实现 AR 场景下的视频连麦直播。
在这个示例项目中包含了以下功能：
- 使用自定义采集协议，将 ARCamera 的视频数据直播到频道中；
- 使用自定义渲染协议，将频道内连麦端的视频数据渲染到 AR 场景中。
- XCode 10.0 +
- iOS 真机设备
- 不支持模拟器
这个段落主要讲解了如何编译和运行实例程序。
在编译和启动实例程序前，您需要首先获取一个可用的App Id:
-
在agora.io创建一个开发者账号。
-
前往后台页面，点击左部导航栏的 项目 > 项目列表 菜单。
-
复制后台的 App Id 并备注，稍后启动应用时会用到它。
-
在项目页面生成临时 Access Token (24小时内有效)并备注，注意生成的Token只能适用于对应的频道名。
-
将 AppID 和 Token 填写进 KeyCenter.swift。
static let AppId: String = <#Your App Id#>
// 如果你没有打开Token功能，token可以直接给nil
static var Token: String? = <#Temp Access Token#>
- 在 Agora.io SDK 下载 视频通话 + 直播 SDK，解压后将其中libs文件夹中的下列文件拷贝到 iOS&macOS/libs/iOS 文件夹下。
- AgoraRtcKit.framework
- AgoraRtcCryptoLoader.framework
- libcrypto.a
- 最后使用 Xcode 打开 Agora-Video-With-ARKit.xcodeproj，连接 iPhone／iPad 测试设备，设置有效的开发者签名后即可运行。
##使用方法
- 对着一个较大的水平面缓慢移动，直到 ARKit 识别出平面(会有一个红色矩形闪现)；
- 在识别出的平面任意位置点击，添加虚拟现实屏；
- 使用同一个 AppId 运行 OpenLive，以主播身份加入 "agoraar" 频道；
- 虚拟显示屏上会出现主播的画面。
- 如果你遇到了困难，可以先参阅 常见问题
- 如果你想了解更多官方示例，可以参考 官方SDK示例
- 如果你想了解声网SDK在复杂场景下的应用，可以参考 官方场景案例
- 如果你想了解声网的一些社区开发者维护的项目，可以查看 社区
- 完整的 API 文档见 文档中心
- 若遇到问题需要开发者帮助，你可以到 开发者社区 提问
- 如果需要售后技术支持, 你可以在 Agora Dashboard 提交工单
- 如果发现了示例代码的 bug，欢迎提交 issue
The MIT License (MIT).