コードスニペットを使用したエージェントの統合 - Intelligent Media Services

このトピックでは、サーバーをデプロイせずに、コンソールで生成されたトライアルトークンを使用してエージェントを迅速にテストする方法について説明します。

説明

このソリューションはテスト目的のみです。本番環境では使用しないでください。本番環境で使用すると、shareToken が不正利用される可能性があります。

トライアルトークンの生成

エージェント管理ページに移動し、テストするエージェントを選択します。エージェントを作成していない場合は、「エージェントの作成と管理」をご参照のうえ作成してください。
[デモ QR コード] ボタンをクリックし、QR コードの生存時間 (TTL) を選択します。
トライアルトークンを生成して保存します。

エージェントの統合

Web

統合テストコード

インストールコードを Web ページの <body> セクションに追加します。

<script src="https://g.alicdn.com/apsara-media-aui/amaui-web-aicall/2.5.0/aicall-ui.js"></script>
<script>
  new ARTCAICallUI({
    userId: '123',                          // Alibaba Real-Time Communication (ARTC) セッションに参加するユーザーの ID。ビジネスログインにはユーザー ID を使用することを推奨します。
    root: document.getElementById('root'),  // ページがレンダリングされるノード。ビューはエリア全体を塗りつぶします。
    shareToken: 'xxxx',                     // コンソールからコピーしたトークン。
  }).render();
</script>

Android

ソースコードのダウンロードと統合

GitHub オープンソースプロジェクトに移動してソースコードをダウンロードします。
AUIAICall のインポート：リポジトリからコードをダウンロードした後、Android Studio で [File] > [New] > [Import Module] に移動し、インポートするフォルダを選択します。

build.gradle ファイル内のサードパーティライブラリの依存関係を変更します。

dependencies {
    implementation 'androidx.appcompat:appcompat:x.x.x'                     // x.x.x をプロジェクトと互換性のあるバージョンに変更します
    implementation 'com.google.android.material:material:x.x.x'             // x.x.x をプロジェクトと互換性のあるバージョンに変更します
    androidTestImplementation 'androidx.test.espresso:espresso-core:x.x.x'  // x.x.x をプロジェクトと互換性のあるバージョンに変更します
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:x.x.x'                  // x.x.x をプロジェクトと互換性のあるバージョンに変更します
    implementation 'com.aliyun.auikits.android:ARTCAICallKit:x.x.x'
    implementation 'com.alivc.live.component:PluginAEC:2.0.0'
}

説明

最新の ARTC SDK バージョン：7.9.1
最新の AICallKit SDK バージョン：2.9.1

同期が完了するまで待ちます。

統合テストコード

Context currentActivity = AUIAICallEntranceActivity.this;
// ARTC セッションに参加するユーザーの ID。ビジネスログインにはユーザー ID を使用することを推奨します。
String loginUserId = "123";
// shareToken はコンソールからコピーしたトークンです。
String shareToken = "xxxxx";
ARTCAICallController.launchCallActivity(currentActivity, shareToken, loginUserId, "");

iOS

ソースコードのダウンロードと統合

GitHub オープンソースプロジェクトに移動してソースコードをダウンロードします。
AUIAICall のインポート：リポジトリからコードをダウンロードした後、iOS フォルダをアプリのコードディレクトリにコピーします。フォルダ名を AUIAICall に変更し、Podfile と同じ階層に配置します。Example および AICallKit フォルダは削除できます。

Podfile を変更して、次のコンポーネントをインポートします：

AliVCSDK_ARTC：リアルタイムインタラクションのためのオーディオ/ビデオクライアント SDK です。AliVCSDK_Standard または AliVCSDK_InteractiveLive も使用できます。統合の詳細については、「iOS」をご参照ください。
ARTCAICallKit：リアルタイム対話型 AI 通話シナリオ用の SDK です。
AUIFoundation：基本的な UI コンポーネントです。
AUIAICall：AI 通話シナリオの UI コンポーネントのソースコードです。

# iOS 11.0 以降が必要です。
platform :ios, '11.0'

target 'Your app target' do
    # ビジネスシナリオに基づいて、適切なオーディオ/ビデオクライアント SDK を統合します。AliVCSDK_ARTC、AliVCSDK_Standard、および AliVCSDK_InteractiveLive がサポートされています。
    pod 'AliVCSDK_ARTC', '~> 7.5.0'

    # リアルタイム対話型 AI 通話シナリオ用の SDK。
    pod 'ARTCAICallKit', '~> 2.8.0'

    # 基本的な UI コンポーネントのソースコード。
    pod 'AUIFoundation', :path => "./AUIAICall/AUIBaseKits/AUIFoundation/", :modular_headers => true

    # AI 通話シナリオの UI コンポーネントのソースコード。
    pod 'AUIAICall',  :path => "./AUIAICall/"
end

説明

最新の ARTC SDK バージョン：7.9.1
最新の AICallKit SDK バージョン：2.9.1

pod install --repo-update を実行します。
ソースコードの統合は完了です。

統合テストコード

import AUIFoundation
import AUIAICall

// 次のコードはエージェントとの通話を開始します。このコードをボタンのクリックイベントに追加してください。
AUIAICallManager.defaultManager.checkDeviceAuth(agentType: .VisionAgent) {
    let topVC = viewController ?? UIViewController.av_top()
    let controller = AUIAICallStandardController(userId: "123")   // userId：ARTC セッションに参加するユーザーの ID。ビジネスログインにはユーザー ID を使用することを推奨します。
    controller.agentShareInfo = "xxxxx"   // コンソールからコピーしたトークン。
    let vc = AUIAICallViewController(controller)
    vc.enableVoiceprintSwitch = false
    topVC.av_presentFullScreenViewController(vc, animated: true)
}