本文檔將介紹如何快速跑通 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實現音視訊通話。


