Alibaba Cloud Model Studio:Manajemen status koneksi

Menjelaskan mesin keadaan koneksi AOQ Client SDK dan panggilan API terkait.

Diagram status koneksi

Diagram berikut menunjukkan transisi status koneksi AOQ Client SDK:

Diagram status koneksi AOQ Client SDK

Deskripsi status

Status	Nilai enum	Deskripsi
Connecting	1	Dicapai setelah memanggil connect. SDK sedang membangun koneksi ke AI Service.
Connected	2	Koneksi berhasil dibangun. Pesan audio, video, dan data dapat dikirim serta diterima secara normal.
Failed	3	Terjadi error koneksi (kegagalan autentikasi, timeout, penolakan server, dan sebagainya). SDK secara otomatis berpindah ke Disconnected.
Disconnected	0	Status awal, atau status akhir setelah pemutusan koneksi yang disengaja maupun tidak terduga.

Aturan transisi status

1. Aplikasi memanggil connect → masuk ke status Connecting.
2. Koneksi berhasil → berpindah dari Connecting ke Connected.
3. Koneksi gagal → berpindah dari Connecting ke Failed, lalu SDK secara otomatis berpindah ke Disconnected.
4. Koneksi gagal → berpindah dari Connected ke Failed, lalu SDK secara otomatis berpindah ke Disconnected.
5. Aplikasi memanggil disconnect → berpindah dari Connected ke Disconnected.

Catatan: Failed adalah status sementara. Setelah SDK memicu callback onConnectionStatusChange(Failed), SDK secara otomatis berpindah ke Disconnected. Lapisan aplikasi tidak perlu memanggil disconnect secara manual.

API connect

Panggil connect untuk memulai koneksi ke AI Service. Berikan kredensial autentikasi yang dikembalikan oleh endpoint allocate AppServer.

Tanda tangan metode

Android:

public abstract int connect(@NonNull AoqConnectConfig config);

iOS:

- (int)connect:(AoqConnectConfig * _Nonnull)config;

HarmonyOS:

connect(config: AoqConnectConfig): number;

Nilai kembalian: 0 menunjukkan panggilan berhasil (koneksi dibangun secara asinkron). < 0 menunjukkan kegagalan.

Perilaku

• Memanggil callback onConnectionStatusChange(connecting) segera setelah pemanggilan.
• Memanggil callback onConnectionStatusChange(connected) jika koneksi berhasil.
• Memanggil callback onConnectionStatusChange(failed) jika koneksi gagal.

API disconnect

Panggil disconnect untuk menutup koneksi ke AI Service secara disengaja.

Tanda tangan metode

Android:

public abstract int disconnect();

iOS:

- (int)disconnect;

HarmonyOS:

disconnect(): number;

Nilai kembalian: 0 menunjukkan keberhasilan. < 0 menunjukkan kegagalan.

Perilaku

• Memanggil callback onConnectionStatusChange(Disconnected) setelah pemanggilan.
• Engine tidak dilepas secara otomatis. Anda dapat memanggil connect lagi untuk menyambung ulang.
• Memanggil disconnect saat tidak terhubung aman dilakukan dan mengembalikan nilai 0.

Callback onConnectionStatusChange

SDK memicu callback ini setiap kali status koneksi berubah.

Android:

public void onConnectionStatusChange(
    @NonNull AoqClientEngine.AoqConnectionStatus status) {}

iOS:

- (void)onConnectionStatusChange:(AoqConnectionStatus)status;

HarmonyOS:

onConnectionStatusChange?: (status: AoqConnectionStatus) => void;

Contoh

func onConnectionStatusChange(_ status: AoqConnectionStatus) {
    switch status {
    case .connecting:
        print("Connecting...")
    case .connected:
        print("Connected")
        // Anda dapat mengirim session.update setelah koneksi berhasil dibangun
    case .failed:
        print("Connection failed")
        // SDK akan secara otomatis berpindah ke disconnected; tidak perlu memanggil disconnect secara manual
    case .disconnected:
        print("Disconnected")
        // Tentukan apakah akan menyambung ulang berdasarkan logika aplikasi Anda
    }
}