Agora 在 GitHub 上提供一个开源的视频直播示例项目 OpenLive-macOS。本文介绍如何快速跑通该示例项目,体验 Agora 视频直播效果。你也可以直接观看下面的视频教程。
按照以下步骤,在控制台创建一个 Agora 项目。
在项目管理页面,点击创建按钮。
在弹出的对话框内输入项目名称,选择鉴权机制为 APP ID + Token。
点击提交,新建的项目就会显示在项目管理页中。
Agora 会给每个项目自动分配一个 App ID 作为项目唯一标识。
在 Agora 控制台的项目管理页面,找到你的项目,点击 App ID 右侧的眼睛图标就可以直接复制项目的 App ID。
为提高项目的安全性,Agora 使用 Token(动态密钥)对即将加入频道的用户进行鉴权。
为了方便测试,Agora 控制台提供生成临时 Token 的功能,具体步骤如下:
在控制台的项目管理页面,点击已创建项目的 图标,打开 Token 页面。
输入一个频道名,例如 test,然后点击生成临时Token。临时 Token 的有效期为 24 小时。
OpenLive-macOS
示例项目文件夹。OpenLive/KeyCenter.swift
文件,将 <#Your App Id#>
替换为你的 Agora 项目的 App ID,将 <#Temp Access Token#>
替换为你在控制台生成的临时 Token。struct KeyCenter {
static let AppId: String = <#Your App Id#>
static var Token: String? = <#Temp Access Token#>
}
按照以下步骤将 Agora macOS SDK 集成到示例项目中。
Agorafdkaac.framework
、Agoraffmpeg.framework
、AgoraRtcKit.framework
、AgoraSoundTouch.framework
复制到 OpenLive
文件夹下即可。按照以下步骤运行示例项目:
在 macOS 设备上打开并运行 OpenLive.xcodeproj
示例项目。运行成功后,你会看到如下画面。
选择你的角色,输入你之前生成 Token 时使用的频道名,并点击 Start Live Streaming 开始直播。如果你选择的角色为主播,则示例应用会弹出对话框要求麦克风和摄像头权限,点击允许,即可在页面上看到本地的视频画面。
如果想体验直播效果,你可以通过声网的 Web 端示例应用,输入相同的 App ID、频道名和临时 Token,加入同一频道与 macOS 端互通。
下表列出示例项目的代码结构,你可以参考示例项目的代码,根据自己的需求进行调整。
文件/文件夹 | 描述 |
---|---|
RoomViewController.swift |
主要功能及频道内页面样式的代码。 |
KeyCenter.swift |
鉴权代码。 |
MainViewController.swift |
频道外页面样式的代码。 |
除本文介绍的示例项目外,我们在 GitHub 上还提供 OpenLive-macOS-Objective-C 示例项目供你参考。