すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:iOS 向け ARTC デモプロジェクトを実行する

    ドキュメントセンター

    ApsaraVideo Live:iOS 向け ARTC デモプロジェクトを実行する

    最終更新日:Aug 15, 2025

    このトピックでは、ApsaraVideo Real-time Communication (ARTC) のデモプロジェクトを実行して、iOS で ARTC 機能を試す方法について説明します。

    ソースコードをダウンロードする

    ApsaraVideo Live は、ARTC SDK の API 使用法を示すオープンソースのサンプルプロジェクトを提供しており、開発者が ARTC 機能を理解し、統合するのに役立ちます。 ソースコードをダウンロードするには、GitHub リポジトリにアクセスしてください。

    環境要件

    デモプロジェクトを実行する前に、開発環境が以下の要件を満たしていることを確認してください。

    • 開発ツール: Xcode 14.0 以降。 最新の公式バージョンを推奨します。

    • 推奨構成: CocoaPods 1.9.3 以降。

    • テストデバイス: iOS 9.0 以降を実行しているデバイス。

    説明

    エミュレータはすべての機能をサポートしていない可能性があるため、テストには物理デバイスを使用することをお勧めします。

    • ネットワーク: 安定したインターネット接続。

    • アプリケーションの設定: ARTC アプリケーションの AppID と AppKey を取得します。

    手順

    ステップ 1: デモプロジェクトを取得する

    ARTC デモプロジェクトをローカルデバイスにクローンします。

    git clone https://github.com/MediaBox-Demos/amdemos-artc
    説明

    このリポジトリには、複数のネイティブプラットフォーム向けのデモプロジェクトが含まれています。 iOS デモプロジェクトは、iOS/ ディレクトリにあります。

    デモプロジェクトには、クライアント側でトークンを生成するためのコードが含まれています。 これは、デモとテストの目的でのみ使用されます。 本番環境では、AppKey を保護するために、安全なサーバーでトークンを生成する必要があります。

    iOS/ARTCExample プロジェクトのファイル構造:

    ├── iOS                                    // iOSプロジェクトのルートディレクトリ
│   ├── ARTCExample                        // APIサンプルプロジェクトのディレクトリ
│       ├── Common                         // 共通モジュール
│           ├── ARTCTokenHelper.swift      // AppIdとAppKeyの情報
│           ├── ...                        // その他のファイル
│       ├── QuickStart                     // クイックスタートモジュール
│           ├── TokenGenerate              // トークン生成とチャンネル参加
│           ├── VideoCall                  // 音声/ビデオ通話のクイック実装
│           ├── VoiceChat                  // 音声チャットルームのクイック実装
│       ├── Setting                        // 設定モジュール
│       ├── ...                            // その他のプロジェクトファイル
│   ├── ARTCExample.xcodeproj              // デモのXcodeプロジェクトファイル
│   ├── ARTCExample.xcworkspace            // デモのXcodeワークスペース
│   ├── Podfile                            // デモのPodfile

    ステップ 2: デモプロジェクトを構成する

    1. ソースコードをダウンロードした後、ターミナルで iOS ディレクトリを開きます。

    2. iOS ディレクトリで、pod install --repo-update コマンドを実行して、必要な SDK 依存関係をインストールします。

    3. Xcode で ARTCExample.xcworkspace ファイルを開きます。

    4. iOS/ARTCExample/Common/ARTCTokenHelper.swift ファイルに移動し、コンソールから取得した AppID と AppKey を入力します。

    // ARTCTokenHelper.swift
class ARTCTokenHelper: NSObject {
    /**
     * RTC AppId
     */
    public static let AppId = "<ARTC アプリケーションの AppID>"
    /**
     * RTC AppKey
     */
    public static let AppKey = "<ARTC アプリケーションの AppKey>"
    
    ...
}

    ステップ 3: デモプロジェクトをコンパイルして実行する

    1. ARTCExample ターゲットを選択し、物理デバイスをコンピュータに接続して、コンパイルしてアプリケーションをインストールします。

    2. テストデバイスでアプリケーションを実行して、ARTC 機能を試します。

    テストデバイスで、アプリケーションを開き、[ビデオ通話] をタップして、この機能をテストします。

    image

    ビデオ通話をテストするには、同じチャネル ID を使用して 2 つのデバイスで通話に参加します。

    image.png

    通話が開始され、両方のデバイスからのビデオストリームが表示されます。

    image.png