全部產品
Search
文件中心

ApsaraVideo Live:iOS

更新時間:Dec 23, 2025

本文檔將介紹如何快速跑通 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檔案

步驟二:配置樣本專案

  1. 源碼下載後,開啟iOS目錄

  2. 在iOS目錄裡執行命令“pod install --repo-update”,自動安裝依賴SDK

  3. 開啟工程檔案ARTCExample.xcworkspace

  4. 配置即時音視頻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,點擊實現音視訊通話

image

兩裝置加入同一頻道。

image.png

開始即時音視訊通話。

image.png

下一步

將ARTC SDK整合到您的專案中,詳情請參見iOS實現音視訊通話