iOS

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

示例源码下载

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

前提条件

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

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

  • 配置推荐:CocoaPods 1.9.3 及以上版本。

  • 测试设备:iOS 9.0 及以上版本的测试设备。

说明

推荐使用真机测试,模拟机可能存在功能缺失。

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

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

操作步骤

步骤一:获取示例项目

克隆 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文件

步骤二:配置示例项目

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

  2. iOS目录里执行命令“pod install --repo-update”,自动安装依赖SDK

  3. 打开工程文件ARTCExample.xcworkspace

  4. 配置实时音视频AppIDAppKey

    进入iOS/ARTCExample/Common/ARTCTokenHelper.swift将控制台申请的AppIDAppKey填入

// 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,点击实现音视频通话

image

两设备加入同一频道。

image.png

开始实时音视频通话。

image.png