Mac

更新时间:
复制为 MD 格式

本文档将介绍如何快速跑通 ARTC 示例项目,体验实时音视频功能。

示例源码下载

阿里云提供了开源示例项目,用于演示 ARTC SDK 的 API 使用方法,帮助开发者更直观地理解和集成 SDK 的各项功能。Mac示例项目仓库

前提条件

在运行示例项目之前,请确保开发环境满足以下要求:

  • 开发工具:Xcode 14.0 及以上版本,推荐使用最新正式版本。

  • 测试设备:macOS 10.13 及以上版本的 Mac 设备。

  • 网络环境:需要稳定的网络连接。

  • 应用准备:获取实时音视频应用的AppIDAppKey,详情请参见创建应用

操作步骤

步骤一:获取示例项目

克隆 ARTC 示例项目到本地:

git clone https://github.com/MediaBox-Demos/amdemos-artc
说明

该仓库包含 ARTC SDK 的多个 Native 平台的示例项目,其中 Mac 平台示例项目位于Mac/目录下。

示例项目中包含了在客户端生成 Token 的相关代码以帮助您进行测试。

下面将介绍Mac/ARTCExample项目的文件结构。

├── Mac                                // Mac 平台工程结构根目录
│   ├── ARTCExample                    // API Example源码目录
│       ├── Common                     // 通用模块
│           ├── AppDefine.h            // 设置AppId/AppKey等信息
│           ├── ...                    // 其他文件
│       ├── QuickStart                 // 快速开发模块
│           ├── TokenGenerate           // Token生成及入会
│           ├── VideoCall               // 快速实现音视频通话
│           ├── VoiceChat               // 快速实现语聊房
│       ├── BasicUsage                 // 基础功能模块
│       ├── ...                        // 工程其他文件
│   ├── ARTCExample.xcodeproj          // Demo的Project

步骤二:配置示例项目

  1. 源码下载后,打开Mac目录。

  2. 前往SDK下载/集成下载 Mac ARTC SDK,放到ARTCExample目录内。

  3. Mac目录下打开工程文件ARTCExample.xcodeproj

  4. 配置实时音视频AppIDAppKey:进入Mac/ARTCExample/Common/AppDefine.h文件,将从控制台获取的AppIDAppKey填入。

#define ARTC_APP_ID  <实时音视频AppID>
#define ARTC_APP_KEY <实时音视频AppKey>

步骤三:编译并运行示例项目

  1. 在 Xcode 中选择ARTCExample Target,进行编译。

  2. 编译成功后运行 App,即可体验 API Example。