Integrasikan agen dengan potongan kode - Intelligent Media Services

Topik ini menjelaskan cara menguji agen secara cepat menggunakan token uji coba yang dihasilkan di Konsol, tanpa perlu men-deploy server.

Catatan

Solusi ini hanya untuk tujuan pengujian. Jangan menggunakannya di lingkungan produksi. Penggunaan di lingkungan produksi dapat menyebabkan penyalahgunaan shareToken.

Generate token uji coba

Buka halaman Agent Management dan pilih agen yang ingin Anda uji. Jika belum membuat agen, lihat Create and manage agents untuk membuatnya.
Klik tombol Demo QR Code dan pilih waktu hidup (TTL) untuk kode QR tersebut.
Hasilkan dan simpan token uji coba tersebut.

Integrasi agen

Web

Kode pengujian integrasi

Tambahkan kode instalasi ke bagian <body> halaman web Anda.

<script src="https://g.alicdn.com/apsara-media-aui/amaui-web-aicall/2.5.0/aicall-ui.js"></script>
<script>
  new ARTCAICallUI({
    userId: '123',                          // ID pengguna yang bergabung ke sesi Alibaba Real-Time Communication (ARTC). Disarankan menggunakan ID pengguna untuk logon bisnis.
    root: document.getElementById('root'),  // Node tempat halaman dirender. Tampilan akan mengisi seluruh area.
    shareToken: 'xxxx',                     // Token yang disalin dari Konsol.
  }).render();
</script>

Android

Unduh dan integrasikan kode sumber

Buka proyek open source GitHub untuk mengunduh kode sumber.
Impor AUIAICall: Setelah mengunduh kode dari repositori, buka File > New > Import Module di Android Studio dan pilih folder yang akan diimpor.

Ubah dependensi library pihak ketiga dalam file build.gradle.

dependencies {
    implementation 'androidx.appcompat:appcompat:x.x.x'                     // Ubah x.x.x ke versi yang kompatibel dengan proyek Anda
    implementation 'com.google.android.material:material:x.x.x'             // Ubah x.x.x ke versi yang kompatibel dengan proyek Anda
    androidTestImplementation 'androidx.test.espresso:espresso-core:x.x.x'  // Ubah x.x.x ke versi yang kompatibel dengan proyek Anda
    implementation 'com.aliyun.aio:AliVCSDK_ARTC:x.x.x'                  // Ubah x.x.x ke versi yang kompatibel dengan proyek Anda
    implementation 'com.aliyun.auikits.android:ARTCAICallKit:x.x.x'
    implementation 'com.alivc.live.component:PluginAEC:2.0.0'
}

Catatan

Versi terbaru SDK ARTC: 7.9.1
Versi terbaru SDK AICallKit: 2.9.1.

Tunggu hingga proses sinkronisasi selesai.

Kode pengujian integrasi

Context currentActivity = AUIAICallEntranceActivity.this;
// ID pengguna yang bergabung ke sesi ARTC. Disarankan menggunakan ID pengguna untuk logon bisnis.
String loginUserId = "123";
// shareToken adalah token yang disalin dari Konsol.
String shareToken = "xxxxx";
ARTCAICallController.launchCallActivity(currentActivity, shareToken, loginUserId, "");

iOS

Unduh dan integrasikan kode sumber

Buka proyek open source GitHub untuk mengunduh kode sumber.
Impor AUIAICall: Setelah mengunduh kode dari repositori, salin folder iOS ke direktori kode aplikasi Anda. Ganti nama folder tersebut menjadi AUIAICall dan letakkan pada level yang sama dengan Podfile Anda. Anda dapat menghapus folder Example dan AICallKit.

Ubah Podfile untuk mengimpor komponen berikut:

AliVCSDK_ARTC: kit pengembangan perangkat lunak (SDK) client audio dan video untuk interaksi real-time. Anda juga dapat menggunakan AliVCSDK_Standard atau AliVCSDK_InteractiveLive. Untuk informasi lebih lanjut tentang integrasi, lihat iOS.
ARTCAICallKit: SDK untuk skenario panggilan AI percakapan real-time.
AUIFoundation: komponen UI dasar.
AUIAICall: kode sumber komponen UI untuk skenario panggilan AI.

# Diperlukan iOS 11.0 atau yang lebih baru.
platform :ios, '11.0'

target 'Your app target' do
    # Integrasikan SDK client audio dan video yang sesuai berdasarkan skenario bisnis Anda. AliVCSDK_ARTC, AliVCSDK_Standard, dan AliVCSDK_InteractiveLive didukung.
    pod 'AliVCSDK_ARTC', '~> 7.5.0'

    # SDK untuk skenario panggilan AI percakapan real-time.
    pod 'ARTCAICallKit', '~> 2.8.0'

    # Kode sumber komponen UI dasar.
    pod 'AUIFoundation', :path => "./AUIAICall/AUIBaseKits/AUIFoundation/", :modular_headers => true

    # Kode sumber komponen UI untuk skenario panggilan AI.
    pod 'AUIAICall',  :path => "./AUIAICall/"
end

Catatan

Versi terbaru SDK ARTC: 7.9.1
Versi terbaru SDK AICallKit: 2.9.1.

Jalankan pod install --repo-update.
Integrasi kode sumber telah selesai.

Kode pengujian integrasi

import AUIFoundation
import AUIAICall

// Kode berikut memulai panggilan dengan agen. Tambahkan kode ini ke event klik tombol Anda.
AUIAICallManager.defaultManager.checkDeviceAuth(agentType: .VisionAgent) {
    let topVC = viewController ?? UIViewController.av_top()
    let controller = AUIAICallStandardController(userId: "123")   // userId: ID pengguna yang bergabung ke sesi ARTC. Disarankan menggunakan ID pengguna untuk logon bisnis.
    controller.agentShareInfo = "xxxxx"   // Token yang disalin dari Konsol.
    let vc = AUIAICallViewController(controller)
    vc.enableVoiceprintSwitch = false
    topVC.av_presentFullScreenViewController(vc, animated: true)
}