Panduan Android - Intelligent Media Services

Topik ini menjelaskan cara mengintegrasikan agen AI percakapan real-time ke dalam aplikasi Android Anda.

Kode sumber

Tautan unduh

Anda dapat mengunduh kode sumber dari GitHub.

Struktur direktori

├── Android       		// Direktori root proyek Android.
│   ├── AUIBaseKits     // Komponen dasar AUI Kits.
│   ├── AUIAICall       // Komponen UI.
│   ├── README.md
│   ├── app             // Demo.
│   ├── build.gradle  
│   └── settings.gradle

Persyaratan lingkungan

Plug-in Android Studio V4.1.3
Gradle 7.0.2
Java Development Kit (JDK) 11 di Android Studio

Sebelum memulai

Kembangkan operasi API terkait di server Anda atau deploy kode sumber server yang disediakan. Untuk informasi selengkapnya, lihat Deploy proyek.

Jalankan demo

Setelah mengunduh kode sumber, buka folder Android di Android Studio.
Buka file proyek build.gradle dan ubah ID paket.

Buka file AUIAICallAgentIdConfig.java untuk mengonfigurasi ID agen dan wilayahnya.

// AUIAICallAgentIdConfig.java
// ID voice agent Anda.
private static String VOICE_AGENT_ID = "<Your voice call agent ID from the console>";
// ID avatar agent Anda.
private static String Avatar_AGENT_ID = "<Your digital human call agent ID from the console>";
// ID vision agent Anda.
private static String VISION_AGENT_ID = "<Your visual understanding call agent ID from the console>";

// Konfigurasikan wilayah.
private static String Region = "cn-shanghai";

Catatan

ID agen dan wilayah harus sesuai dengan yang ada di Konsol. Untuk menggunakan jenis agen tertentu, atur ID agen yang sesuai.

Nama wilayah	ID wilayah
China (Hangzhou)	cn-hangzhou
China (Shanghai)	cn-shanghai
China (Beijing)	cn-beijing
China (Shenzhen)	cn-shenzhen
Singapura	ap-southeast-1

Gunakan salah satu metode berikut untuk memulai agen AI:
- App Server telah di-deploy: Buka file AppServiceConst.java dan ubah nama domain App Server.
```
// AppServiceConst.java
String HOST = "Domain name of your App Server";
```
- App Server belum di-deploy: Buka file AUIAICallAuthTokenHelper.java dan konfigurasikan parameter EnableDevelopToken. Salin ARTC AppID dan AppKey dari Konsol untuk menghasilkan token otentikasi yang diperlukan saat memulai agen AI pada aplikasi.
  Penting
  Metode ini memerlukan penyematan AppKey dan informasi sensitif lainnya ke dalam aplikasi Anda. Metode ini hanya untuk pengujian dan pengembangan. Jangan pernah menggunakan metode ini di lingkungan produksi. Menampilkan AppKey di sisi klien menciptakan risiko keamanan serius.
```
// AUIAICallAuthTokenHelper.java
public class AUIAICallAuthTokenHelper {
    // Atur ke true untuk mengaktifkan mode developer
    private static final boolean EnableDevelopToken = true;

    // Salin AppID aplikasi ARTC dari Konsol
    private static final String AICallRTCDevelopAppId = "The App ID for the ARTC service used by the agent";
    // Salin AppKey aplikasi ARTC dari Konsol
    private static final String AICallRTCDevelopAppKey = "The App Key for the ARTC service used by the agent";
}
```
  Untuk mendapatkan AppID dan AppKey aplikasi ARTC:
  1. Buka halaman AI Agents di Konsol IMS. Klik agen untuk membuka halaman detail agen tersebut.
  2. Klik ARTC application ID. Anda akan diarahkan ke Konsol ApsaraVideo Live, tempat AppID dan AppKey disediakan.

Kembangkan fitur AI percakapan

Anda dapat dengan cepat mengintegrasikan AUIAICall ke dalam aplikasi Anda dengan melakukan langkah-langkah berikut.

Integrasikan kode sumber

Unduh kode sumber dari repositori. Di menu Android Studio, navigasikan ke File > New > Import Module dan impor folder AUIAICall dan AUIBaseKits.

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.

Konfigurasikan kode sumber

Pastikan semua prasyarat telah terpenuhi.
Buka file AppServiceConst.java dan ubah nama domain server.
```
// AppServiceConst.java
String HOST = "Domain name of your App Server";
```
Catatan
Jika App Server Anda belum di-deploy, hasilkan token otentikasi di aplikasi untuk pengujian dan demonstrasi cepat.

Panggil operasi API

Setelah menyelesaikan langkah-langkah di atas, Anda dapat memanggil operasi API di modul lain aplikasi Anda atau di halaman utama untuk memulai percakapan dengan agen AI. Anda juga dapat memodifikasi kode sumber tersebut.

/** Pastikan izin mikrofon dan kamera telah diberikan sebelum memulai. */
Context currentActivity = AUIAICallEntranceActivity.this;
Intent intent = new Intent(currentActivity, AUIAICallInCallActivity.class);

// Atur tipe panggilan (audio, avatar, atau vision). Ini harus sesuai dengan tipe ID agen.
ARTCAICallEngine.ARTCAICallAgentType aiCallAgentType = 
    ARTCAICallEngine.ARTCAICallAgentType.VoiceAgent;
// ID agen. Tidak boleh kosong.
String aiAgentId = "";
// Wilayah tempat agen berada. Tidak boleh kosong.
String aiAgentRegion = "";
// ID pengguna yang bergabung dalam panggilan RTC. Disarankan menggunakan ID login pengguna.
String userId = "123";
// Token otentikasi. Untuk informasi selengkapnya, lihat https://www.alibabacloud.com/help/en/ims/user-guide/generate-artc-authentication-token
String token = "";

intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_LOGIN_USER_ID, userId);
// Tipe agen
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_TYPE, aiCallAgentType);
// ID agen
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_ID, aiAgentId);
// Wilayah tempat agen berada
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_AI_AGENT_REGION, aiAgentRegion);
// Atur token otentikasi
intent.putExtra(AUIAIConstStrKey.BUNDLE_KEY_RTC_AUTH_TOKEN, token);

currentActivity.startActivity(intent);

Catatan

Untuk informasi selengkapnya tentang token otentikasi, lihat Generate an ARTC authentication token.