Skip to content

Latest commit

 

History

History
102 lines (70 loc) · 4.02 KB

README.zh.md

File metadata and controls

102 lines (70 loc) · 4.02 KB
Raw

Open Live iOS for Swift

English | 中文

这个开源示例项目演示了如何快速集成Agora视频SDK，实现多人视频连麦直播。

在这个示例项目中包含了以下功能：

  • 加入通话和离开通话；
  • 主播和观众模式；
  • 静音和解除静音；
  • 发送和停止发送视频流；
  • 切换前置摄像头和后置摄像头；
  • 开启美颜；
  • 选择分辨率、帧率；

问题描述

iOS 系统版本升级至 14.0 版本后，用户首次使用集成了声网 iOS 语音或视频 SDK 的 app 时会看到查找本地网络设备的弹窗提示。默认弹窗界面如下图所示：

解决方案

环境准备

  • XCode 10.0 +
  • iOS 真机设备
  • 不支持模拟器

运行示例程序

这个段落主要讲解了如何编译和运行实例程序。

创建Agora账号并获取AppId

在编译和启动实例程序前，您需要首先获取一个可用的App Id:

  1. 在agora.io创建一个开发者账号。

  2. 前往后台页面，点击左部导航栏的 项目 > 项目列表 菜单。

  3. 复制后台的 App Id 并备注，稍后启动应用时会用到它。

  4. 在项目页面生成临时 Access Token (24小时内有效)并备注，注意生成的Token只能适用于对应的频道名。

  5. 将 AppID 和 Token 填写进 KeyCenter.swift。

static let AppId: String = <#Your App Id#>
// 如果你没有打开Token功能，token可以直接给nil
static var Token: String? = <#Temp Access Token#>

为提高项目的安全性，Agora 使用 Token（动态密钥）对即将加入频道的用户进行鉴权。

临时 Token 仅作为演示和测试用途。在生产环境中，你需要自行部署服务器签发 Token，详见[生成 Token](https://docs.agora.io/cn/Interactive Broadcast/token_server)。

集成 Agora 视频 SDK

  1. 切换到 iOS 目录，运行以下命令使用 CocoaPods 安装依赖，Agora 视频 SDK 会在安装后自动完成集成。
pod install

  1. 使用 Xcode 打开生成的 Openlive.xcworkspace。

  2. 编辑 KeyCenter.swift 文件。

    • 将 YOUR APP ID 替换为你的 App ID。
    • 将 YOUR ACCESS TOKEN 替换为你的 Access Token。
    struct KeyCenter {
static let AppId: String = <#Your App Id#>

// assign token to nil if you have not enabled app certificate
static var Token: String? = <#Temp Access Token#>
}

    参考 校验用户权限 了解如何获取 App ID 和 Token。你可以获取一个临时 token，快速运行示例项目。

    生成 Token 使用的频道名必须和加入频道时使用的频道名一致。

    为提高项目的安全性，Agora 使用 Token（动态密钥）对即将加入频道的用户进行鉴权。

    临时 Token 仅作为演示和测试用途。在生产环境中，你需要自行部署服务器签发 Token，详见生成 Token。

  3. 构建并在 iOS 设备中运行项目。

联系我们

  • 如果你遇到了困难，可以先参阅 常见问题
  • 如果你想了解更多官方示例，可以参考 官方SDK示例
  • 如果你想了解声网SDK在复杂场景下的应用，可以参考 官方场景案例
  • 如果你想了解声网的一些社区开发者维护的项目，可以查看 社区
  • 完整的 API 文档见 文档中心
  • 若遇到问题需要开发者帮助，你可以到 开发者社区 提问
  • 如果需要售后技术支持, 你可以在 Agora Dashboard 提交工单
  • 如果发现了示例代码的 bug，欢迎提交 issue

代码许可

The MIT License (MIT)