跑通示例项目

概览

声网在 GitHub 上提供一个开源的视频通话示例项目 Agora-macOS-Tutorial-Swift-1to1。本文介绍如何快速跑通该示例项目，体验声网视频通话效果。你也可以直接观看下面的视频教程。

前提条件

• Xcode 11.0 或以上版本（本文 Xcode 的界面描述以 Xcode 11.0 为例）
• macOS 10.10 或以上版本的设备
• 有效的声网账户
• 有效的开发者签名、设备权限设置

操作步骤

1. 创建声网项目

参考以下步骤创建一个声网项目：

1. 进入声网控制台的项目管理页面。
2. 在项目管理页面，点击创建按钮。
3. 在弹出的对话框内输入项目名称、使用场景，依次选择场景标签和鉴权机制。其中鉴权机制推荐选择安全模式，调试模式的安全性较低。
4. 点击提交按钮。新建的项目会显示在项目管理页中。

2. 获取 App ID

声网会给每个项目自动分配一个 App ID 作为项目唯一标识。

在声网控制台的项目管理页面，找到你的项目，点击 App ID 右侧的 图标，即可获取项目的 App ID。

3. 生成临时 Token

为提高项目的安全性，声网推荐使用 Token 对即将加入频道的用户进行鉴权。

为了方便测试，声网控制台提供生成 RTC 临时 Token 的功能。参考以下步骤获取 RTC 临时 Token：

1. 在控制台的项目管理页面，找到你的项目，点击配置。
   
2. 在主要证书下面，点击生成临时音视频 token。
   
3. 输入一个频道名，例如 testroom，然后点击生成。后续调用 API 加入频道时，请确保填入的频道名与这里的频道名一致。
   
4. 点击复制图标，即可复制生成的临时 token。

4. 配置示例项目

1. 克隆 Basic-Video-Call 仓库至本地，进入 Basic-Video-Call/One-to-One-Video/Agora-macOS-Tutorial-Swift-1to1/Agora-Mac-Tutorial-Swift 文件夹。

2. 打开 AppID.swift 文件，填入 App ID 和临时 Token。

   // 将 <#Your App ID#> 替换为你的声网项目的 App ID，并加引号，如 "xxxxxx"
   let AppID: String = <#Your App ID#>
   // 将 <#Temp Token#> 替换为你在控制台生成的临时 Token，并加引号，如 "xxxxxx"
   let Token: String? = <#Temp Token#>

3. 打开 VideoChatViewController.swift 文件，将 demoChannel1替换为你生成临时 Token 时使用的频道名。

   func joinChannel() {
        AgoraKit.joinChannel(byToken: Token, channelId: "demoChannel1", info:nil, uid:0) { (sid, uid, elapsed) -> Void in
        }
    }

5. 集成声网 SDK

按照以下步骤将声网macOS SDK 集成到示例项目中。

1. 前往 SDK 下载页面，获取最新版的视频 SDK，然后解压。
2. 将 libs 文件夹下的所有文件复制到 Agora-Mac-Tutorial-Swift 文件夹下即可。

6. 运行示例项目

在 macOS 设备上打开 Agora-Mac-Tutorial-Swift.xcodeproj 示例项目，运行该项目。运行成功后，你会在 macOS 设备上看到如下画面。

现在你就可以开始体验视频通话了。如果想体验一对一通话效果，你可以邀请一位朋友克隆 API-Examples-Web 项目到本地，在浏览器中打开 Demo/index.html 文件，并输入相同的 App ID、频道名和临时 Token，加入同一频道与 macOS 端互通。

示例项目结构

你可以参考示例项目的 VideoChatViewController.swift 文件中的主要功能及页面样式代码，根据自己的需求进行调整。

相关链接

除本文介绍的示例项目外，我们在 GitHub 上还提供以下开源的视频通话示例项目供你参考：

• One-to-One-Video/Agora-macOS-Tutorial-Objective-C-1to1
• Group-Video/OpenVideoCall-macOS