本文档将介绍如何快速跑通 ARTC 示例项目,体验实时音视频功能。
示例源码下载
阿里云提供了开源示例项目,用于演示 ARTC SDK 的 API 使用方法,帮助开发者更直观地理解和集成 SDK 的各项功能。iOS示例项目仓库。
前提条件
在运行示例项目之前,请确保开发环境满足以下要求:
开发工具:Xcode 14.0 及以上版本,推荐使用最新正式版本。
配置推荐:CocoaPods 1.9.3 及以上版本。
测试设备:iOS 9.0 及以上版本的测试设备。
说明
推荐使用真机测试,模拟机可能存在功能缺失。
网络环境:需要稳定的网络连接。
应用准备:获取实时音视频应用的AppID和AppKey,详情请参见创建应用。
操作步骤
步骤一:获取示例项目
克隆 ARTC 示例项目到本地:
git clone https://github.com/MediaBox-Demos/amdemos-artc
说明
该仓库包含 ARTC SDK 的多个 Native 平台的示例项目,其中 iOS 平台示例项目位于iOS/
目录下。
示例项目中包含了在客户端生成 Token 的相关代码以帮助您进行测试。
下面将介绍 iOS/ARTCExample
项目的文件结构。
├── iOS // iOS平台工程结构根目录
│ ├── ARTCExample // API Example源码目录
│ ├── Common // 通用模块
│ ├── ARTCTokenHelper.swift // 设置AppId/AppKey等信息
│ ├── ... // 其他文件
│ ├── QuickStart // 快速开发模块
│ ├── TokenGenerate // Token生成及入会
│ ├── VideoCall // 快速实现音视频通话
│ ├── VoiceChat // 快速实现语聊房
│ ├── Setting // 设置模块
│ ├── ... // 工程其他文件
│ ├── ARTCExample.xcodeproj // Demo的Project
│ ├── ARTCExample.xcworkspace // Demo的workspace
│ ├── Podfile // Demo的podfile文件
步骤二:配置示例项目
源码下载后,打开iOS目录
在iOS目录里执行命令“pod install --repo-update”,自动安装依赖SDK
打开工程文件
ARTCExample.xcworkspace
配置实时音视频AppID和AppKey
进入
iOS/ARTCExample/Common/ARTCTokenHelper.swift
将控制台申请的AppID和AppKey填入
// ARTCTokenHelper.swift
class ARTCTokenHelper: NSObject {
/**
* RTC AppId
*/
public static let AppId = "<实时音视频AppID>"
/**
* RTC AppKey
*/
public static let AppKey = "<实时音视频AppKey>"
...
}
步骤三:编译并运行示例项目
选择"ARTCExample" Target, 连接真机,进行编译
运行App,即可体验API Example
在真机上运行Demo,点击实现音视频通话。 | 两设备加入同一频道。 | 开始实时音视频通话。 |
该文章对您有帮助吗?