ARTC のサンプルプロジェクトをすばやく実行して、リアルタイムの音声・ビデオ機能を体験できます。
サンプルソースコードのダウンロード
Alibaba Cloud は、ARTC SDK API の使用方法を示すオープンソースのサンプルプロジェクトを提供しています。このプロジェクトは、SDK の機能の理解と統合に役立ちます。iOS サンプルプロジェクトリポジトリをご参照ください。
前提条件
サンプルプロジェクトを実行する前に、お使いの開発環境が以下の要件を満たしていることを確認してください。
-
開発ツール: Xcode 14.0 以降。可能な限り最新の安定バージョンを使用してください。
-
推奨設定: CocoaPods 1.9.3 以降。
-
テストデバイス: iOS 9.0 以降が動作する物理 iOS デバイス。
テストには物理デバイスを使用してください。シミュレーターでは、一部の機能が利用できない場合があります。
-
ネットワーク: 安定したネットワーク接続が必要です。
-
アプリケーション設定: ApsaraVideo Real-time Communication (ARTC) アプリケーションの AppID と AppKey を取得してください。詳細については、「アプリケーションの作成」をご参照ください。
操作手順
手順1:サンプルプロジェクトの取得
ARTC サンプルプロジェクトをローカルマシンにクローンします:
git clone https://github.com/MediaBox-Demos/amdemos-artc
このリポジトリには、ARTC SDK を使用した複数のネイティブプラットフォーム用サンプルプロジェクトが含まれています。iOS サンプルプロジェクトは iOS/ フォルダーにあります。
サンプルプロジェクトには、テストに役立つトークンを生成するためのクライアント側コードが含まれています。
以下に、iOS/ARTCExample プロジェクトのファイル構造を示します。
├── iOS // iOS プロジェクトのルートディレクトリ
│ ├── ARTCExample // API サンプルソースコード
│ ├── Common // 共通モジュール
│ ├── ARTCTokenHelper.swift // AppId、AppKey、その他の情報を設定
│ ├── ... // その他のファイル
│ ├── QuickStart // クイックスタートモジュール
│ ├── TokenGenerate // トークン生成とチャンネル参加
│ ├── VideoCall // ビデオ通話の簡単な実装
│ ├── VoiceChat // ボイスチャットの簡単な実装
│ ├── BasicUsage // 基本機能
│ ├── AudioBasicUsage // 一般的なオーディオ操作と設定
│ ├── VideoBasicUsage // 一般的なビデオ操作と設定
│ ├── CameraCommonSetting // 標準的なカメラ設定
│ ├── SEIUsage // SEI メッセージの送受信
│ ├── DataChannelMessage // カスタムメッセージの送受信
│ ├── ScreenShare // 画面共有
│ ├── StreamMonitoring // 通話中のストリーム品質の監視
│ ├── PlayAudioFiles // 背景音楽と効果音の再生
│ ├── AdvancedUsage // 高度な機能
│ ├── ProcessAudioRawData // raw オーディオデータ
│ ├── ProcessVideoRawData // raw ビデオデータ
| |—— CustomAudioCapture // カスタムオーディオキャプチャ
| |—— CustomAudioRender // カスタムオーディオ再生
| |—— CustomVideoCapture // カスタムビデオキャプチャ
| |—— CustomVideoRender // カスタムビデオレンダリング
│ ├── CustomVideoProcess // カスタムビデオ処理
| |—— PreJoinChannelTest // チャンネル参加前のネットワークとデバイスの検出
| |—— PictureInPicture // ピクチャーインピクチャー (PiP)
| |—— H265 // H.265 エンコーディング
| |—— IntelligentDenoise // インテリジェントノイズリダクション
| |—— LocalRecord // ローカル録画
│ ├── Setting // 設定モジュール
│ ├── ... // その他のプロジェクトファイル
│ ├── ARTCExample.xcodeproj // デモプロジェクトファイル
│ ├── ARTCExample.xcworkspace // デモワークスペースファイル
│ ├── Podfile // デモ Podfile
手順2:サンプルプロジェクトの設定
-
ソースコードをダウンロードした後、iOS フォルダーを開きます。
-
iOS フォルダーで、「pod install --repo-update」 コマンドを実行し、必要な SDK 依存関係を自動的にインストールします。
-
プロジェクトファイル
ARTCExample.xcworkspaceを開きます。 -
ARTC の AppID と AppKey を設定します。
iOS/ARTCExample/Common/ARTCTokenHelper.swiftを開き、コンソールから取得した AppID と AppKey を入力します。
// ARTCTokenHelper.swift
class ARTCTokenHelper: NSObject {
/**
* RTC の AppID
*/
public static let AppId = "<ApsaraVideo Real-time Communication の AppID>"
/**
* RTC の AppKey
*/
public static let AppKey = "<ApsaraVideo Real-time Communication の AppKey>"
...
}
手順3:サンプルプロジェクトのコンパイルと実行
-
「ARTCExample」 ターゲットを選択し、物理デバイスを接続して、プロジェクトをコンパイルします。
-
アプリを実行して、API の例を体験します。
|
物理デバイスでデモを実行し、[ビデオ通話の実装] をクリックします。 |
2台のデバイスを同じチャンネルに参加させます。 アプリのインターフェイスで同じ ChannelID (例: |
リアルタイムの音声・ビデオ通話を開始します。 |
次のステップ
ARTC SDK を独自のプロジェクトに組み込むには、「iOSでのビデオ通話の実装」をご参照ください。