快速跑通ARTC iOS示例项目-视频直播-阿里云

本文档将介绍如何快速跑通 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                   // 快速实现语聊房
│       ├── BasicUsage                  // 基础功能模块
│           ├── AudioBasicUsage             // 常用音频操作和配置
│           ├── VideoBasicUsage             // 常用视频操作和配置
│           ├── CameraCommonSetting         // 摄像头常规配置
│           ├── SEIUsage                    // SEI消息发送和接收
│           ├── DataChannelMessage          // 用户自定义消息发送和接收
│           ├── ScreenShare                 // 屏幕共享
│           ├── StreamMonitoring            // 通话中推拉流质量监测
│           ├── PlayAudioFiles              // 播放伴奏和音效
│       ├── AdvancedUsage               // 高级功能模块
│           ├── ProcessAudioRawData         // 原始音频数据
│           ├── ProcessVideoRawData         // 原始视频数据
|           |—— CustomAudioCapture          // 自定义音频采集
|           |—— CustomAudioRender           // 自定义音频播放
|           |—— CustomVideoCapture          // 自定义视频采集
|           |—— CustomVideoRender           // 自定义视频渲染
│           ├── CustomVideoProcess          // 自定义视频处理
|           |—— PreJoinChannelTest          // 入会前网络和设备检测
|           |—— PictureInPicture            // 画中画
|           |—— H265                        // H.265编码
|           |—— IntelligentDenoise          // 智能降噪
|           |—— LocalRecord                 // 本地录制
│       ├── 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，点击实现音视频通话。

两设备加入同一频道。

开始实时音视频通话。

下一步

将ARTC SDK集成到您的项目中，详情请参见iOS实现音视频通话。