ApsaraVideo Live：Referensi API AliRtcEngine

Membuat instance AliRtcEngine menggunakan pola singleton.

+ (instancetype _Nonnull )sharedInstance:(id<AliRtcEngineDelegate>_Nullable)delegate extras:(NSString *_Nullable)extras;

Kapan dipanggil

Anda harus memanggil metode ini untuk membuat instance AliRtcEngine sebelum memanggil API lain dari SDK ApsaraVideo Real-time Communication (ARTC).

Batasan

• Ini adalah metode sinkron dan harus dipanggil dari thread utama.

• SDK mendukung pembuatan hanya satu instance AliRtcEngine untuk setiap aplikasi.

Callback terkait

Saat Anda membuat instance mesin, Anda harus mengimplementasikan callback di AliRtcEngineDelegate berdasarkan skenario bisnis Anda. Jika terjadi pengecualian selama runtime, SDK pertama-tama akan mencoba memulihkan secara otomatis menggunakan mekanisme pengulangan internalnya. Untuk kesalahan yang tidak dapat diselesaikan secara internal, SDK memberi tahu aplikasi Anda melalui antarmuka callback yang telah ditentukan. Lapisan aplikasi harus mendengarkan dan menanggapi callback kunci berikut yang tidak dapat ditangani oleh SDK:

Parameter

Menghancurkan instance AliRtcEngine.

+ (void)destroy;

Memanggil metode ini menghancurkan objek singleton AliRtcEngine dan melepaskan semua sumber daya internal. Anda tidak dapat lagi menggunakan metode lain dari AliRtcEngine atau callback apa pun. Untuk menggunakan mesin lagi, Anda harus memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#2db21d4f16s77" id="96631a9306wq8">sharedInstance</a> untuk membuat instance baru.

Kedua metode ini dan destroy[2/2] dapat menghancurkan instance mesin. Perbedaannya adalah yang terakhir memungkinkan Anda meneruskan objek pendengar untuk diberi tahu ketika penghancuran selesai.

Kapan harus memanggil

Ketika komunikasi audio dan video berakhir, panggil metode ini untuk melepaskan instance dan mengurangi konsumsi sumber daya.

Batasan

Memanggil metode ini dari dalam callback SDK dapat menyebabkan deadlock.

Menghancurkan instance AliRtcEngine.

+ (void)destroy:(id<AliRtcEngineDestroyDelegate>_Nullable)delegate;

Menghancurkan objek singleton AliRtcEngine dan melepaskan semua sumber daya yang digunakan secara internal. Setelah metode ini dipanggil, Anda tidak dapat lagi menggunakan metode AliRtcEngine lainnya atau callback. Untuk menggunakan mesin lagi, Anda perlu memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#2db21d4f16s77" id="115fd691743nx">sharedInstance</a> untuk membuat instance baru.

Kapan Memanggil

Anda dapat memanggil metode ini untuk melepaskan instance setelah komunikasi audio dan video selesai.

Batasan

Untuk menghindari deadlock, Anda tidak boleh memanggil metode ini dalam callback SDK apa pun.

Parameter

Menetapkan mode kompatibilitas H5.

+ (void)setH5CompatibleMode:(BOOL)comp;

Parameter

Menunjukkan apakah mode kompatibilitas H5 diatur.

+ (BOOL)getH5CompatibleMode;

Nilai kembali

Mengembalikan YES jika mode kompatibilitas H5 diatur, atau NO jika tidak.

Mengambil nomor versi SDK.

+ (NSString *_Nonnull)getSdkVersion;

Nilai kembali

Nomor versi SDK saat ini sebagai string, misalnya, "2.5.0.x".

Deskripsi

Ini adalah metode statis. Anda dapat mengambil nomor versi kapan saja.

Menetapkan profil saluran.

- (int)setChannelProfile:(AliRtcChannelProfile)profile;

Metode ini menetapkan profil saluran. Saat ini menyediakan skenario untuk panggilan video dan streaming interaktif:

• Panggilan video: Semua pengguna adalah streamer dan dapat menerbitkan dan berlangganan aliran.

• Streaming interaktif: Anda harus memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#892915dd4edcy" id="d88dccff391by">setClientRole</a> untuk menetapkan peran pengguna. Untuk pengguna yang menerbitkan aliran di saluran, atur perannya menjadi streamer (AliRTCSdkInteractive). Jika pengguna hanya perlu menarik aliran dan tidak perlu menerbitkan aliran, atur perannya menjadi penonton (AliRTCSdkLive). Profil ini direkomendasikan untuk skenario RTC.

Kapan harus memanggil

Anda hanya dapat memanggil metode ini sebelum bergabung ke saluran. Setelah Anda bergabung ke saluran, Anda tidak dapat mengubah profil saluran sampai Anda meninggalkan saluran tersebut.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Menetapkan profil audio.

- (int)setAudioProfile:(AliRtcAudioProfile)audio_profile audio_scene:(AliRtcAudioScenario)audio_scene;

Metode ini menetapkan mode pengkodean dan skenario audio. Untuk informasi lebih lanjut, lihat Operasi dan konfigurasi audio umum. Secara default, SDK ARTC menggunakan mode audio berkualitas tinggi (AliRtcEngineHighQualityMode) dan mode skenario musik (AliRtcSceneMusicMode). Jika pengaturan default tidak memenuhi kebutuhan Anda, Anda dapat memanggil metode ini untuk mengubahnya.

Kapan memanggil

Anda hanya dapat memanggil metode ini sebelum bergabung ke saluran. Anda tidak dapat mengubah profil setelah Anda bergabung ke saluran. Anda dapat mengubah profil lagi setelah Anda meninggalkan saluran.

Parameter

Deskripsi nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan berhasil. Nilai selain 0 menunjukkan bahwa pemanggilan gagal.

Memeriksa apakah mode saat ini hanya audio.

- (BOOL)isAudioOnly;

Nilai kembali

Mengembalikan YES jika mode hanya audio, dan NO jika mode audio dan video.

Mengaktifkan atau menonaktifkan mode hanya audio.

- (int)setAudioOnlyMode:(BOOL)audioOnly;

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan keberhasilan. Nilai bukan nol menunjukkan kegagalan.

Bergabung ke saluran menggunakan satu parameter.

- (int)joinChannel:(NSString *_Nonnull)token channelId:(NSString *_Nullable)channelId userId:(NSString *_Nullable)userId name:(NSString *_Nullable)userName onResultWithUserId:(void(^_Nullable)(NSInteger errCode, NSString * _Nonnull channel, NSString * _Nonnull userId, NSInteger elapsed))onResult;

Metode ini digunakan untuk bergabung ke saluran. Di ARTC, saluran digunakan untuk mengelola pengguna. Anda harus bergabung ke saluran untuk menerbitkan atau berlangganan aliran audio dan video. Anda dapat menggunakan metode ini, joinChannel[2/3], atau joinChannel[3/3] untuk bergabung ke saluran. Metode ini berbeda dalam metode autentikasi dan informasi pengguna yang dilewatkan, seperti dijelaskan di bawah ini:

• Ini adalah metode bergabung ke saluran dengan satu parameter. Untuk bergabung ke saluran, Anda harus melewatkan token satu parameter yang dihasilkan menggunakan autentikasi berbasis token. Gunakan metode ini untuk bergabung ke saluran dalam skenario komunikasi real-time (RTC).

• joinChannel[2/3] adalah metode bergabung ke saluran dengan beberapa parameter. Untuk bergabung ke saluran, Anda harus melewatkan token multi-parameter yang dihasilkan menggunakan autentikasi berbasis token dan informasi pengguna yang digunakan untuk menghasilkan token.

• joinChannel[3/3] digunakan untuk skenario interaksi real-time AI. Anda harus melewatkan token satu parameter dan mengatur properti pengguna capabilityProfile berdasarkan skenario tertentu.

Kapan Dipanggil

Anda harus memanggil ini setelah membuat mesin.

Batasan Pemanggilan

• Untuk beralih ke saluran lain, Anda harus terlebih dahulu memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#449873b819cz2" id="37299758eavvg">leaveChannel</a> untuk meninggalkan saluran saat ini. Setelah Anda menerima callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#3721f1f2a3kpd" id="50039f328fdk7">onLeaveChannelResult</a>, Anda dapat bergabung ke saluran baru.

• Anda hanya dapat bergabung ke satu saluran pada satu waktu.

• Aplikasi yang menggunakan App ID berbeda tidak dapat berkomunikasi satu sama lain.

• Jangan memanggil metode ini untuk mencoba ulang upaya bergabung ke saluran yang gagal.

Callback Terkait

Pemanggilan API ini yang berhasil memicu callback berikut:

• Callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#e6d2a213d7sl2" id="903005c54be4d">onJoinChannelResult</a> mengembalikan hasil klien lokal bergabung ke saluran.

• Setelah Anda berhasil bergabung ke saluran, callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#634626babfq9x" id="4b11b846b1f4t">onRemoteUserOnLineNotify</a> dipicu ketika pengguna jarak jauh online.

Deskripsi Metrik

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lain menunjukkan bahwa pemanggilan metode gagal.

Bergabung ke saluran untuk rapat multi-peserta.

- (int)joinChannel:(AliRtcAuthInfo *_Nonnull)authInfo name:(NSString *_Nullable)userName onResultWithUserId:(void(^_Nullable)(NSInteger errCode, NSString * _Nonnull channel, NSString * _Nonnull userId, NSInteger elapsed))onResult;

Metode ini memungkinkan Anda bergabung ke saluran. Di Alibaba Real-Time Communication (ARTC), saluran digunakan untuk mengelola pengguna. Anda harus bergabung ke saluran untuk menerbitkan atau berlangganan aliran audio dan video. Anda dapat menggunakan metode ini, joinChannel[1/3], atau joinChannel[3/3] untuk bergabung ke saluran. Metode ini berbeda dalam proses autentikasi dan informasi pengguna yang mereka butuhkan, seperti berikut:

• Metode joinChannel[1/3] bergabung ke saluran menggunakan satu parameter. Untuk menggunakan metode ini, hasilkan token untuk bergabung dengan satu parameter seperti yang dijelaskan dalam Autentikasi Token, lalu lewatkan token ke metode. Metode ini direkomendasikan untuk skenario RTC.

• Metode ini menggunakan beberapa parameter untuk bergabung ke saluran. Untuk menggunakan metode ini, hasilkan token untuk bergabung dengan beberapa parameter seperti yang dijelaskan dalam Autentikasi Token. Anda kemudian harus melewatkan token dan informasi pengguna yang digunakan untuk menghasilkannya ke metode.

• Metode joinChannel[3/3] digunakan untuk skenario interaksi real-time AI. Untuk menggunakan metode ini, lewatkan token untuk bergabung dengan satu parameter dan atur properti pengguna capabilityProfile sesuai dengan skenario.

Batasan Pemanggilan

• Untuk bergabung ke saluran lain saat berada di saluran yang ada, Anda harus terlebih dahulu memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#449873b819cz2" id="4283c6cc013bz">leaveChannel</a> dan menunggu callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#3721f1f2a3kpd" id="9e6478b2f0hen">onLeaveChannelResult</a> sebelum memanggil metode bergabung lagi.

• Anda hanya dapat bergabung ke satu saluran pada satu waktu.

• Aplikasi tidak dapat berkomunikasi lintas App ID yang berbeda.

Callback Terkait

Pemanggilan API yang berhasil memicu callback berikut:

• Klien lokal menerima hasil bergabung ke saluran melalui callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#e6d2a213d7sl2" id="df00346ea8928">onJoinChannelResult</a>.

• Setelah Anda berhasil bergabung ke saluran, Anda menerima callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#634626babfq9x" id="c3832e71e8vck">onRemoteUserOnLineNotify</a>.

Parameter

Bergabung ke saluran.

- (int)joinChannel:(NSString *_Nonnull)token channelParam:(AliRtcChannelParam *_Nonnull)channelParam onResultWithUserId:(void(^_Nullable)(NSInteger errCode, NSString * _Nonnull channel, NSString * _Nonnull userId, NSInteger elapsed))onResult;

Anda dapat menggunakan metode ini untuk bergabung ke saluran. Di Alibaba Real-Time Communication (ARTC), pengguna diatur ke dalam saluran. Pengguna harus bergabung ke saluran untuk menerbitkan atau berlangganan aliran audio dan video. Metode ini, joinChannel[1/3], dan joinChannel[2/3] semuanya digunakan untuk bergabung ke saluran. Mereka berbeda dalam metode autentikasi dan informasi pengguna yang mereka lewatkan. Perbedaannya adalah sebagai berikut:

• joinChannel[1/3] adalah metode bergabung ke saluran dengan satu parameter dalam skenario Komunikasi Real-Time (RTC). Untuk bergabung ke saluran, Anda harus melewatkan token satu parameter yang dihasilkan menggunakan autentikasi berbasis token. Metode ini direkomendasikan untuk bergabung ke saluran dalam skenario RTC.

• joinChannel[2/3] adalah metode bergabung ke saluran dengan beberapa parameter. Untuk bergabung ke saluran, Anda harus melewatkan token multi-parameter yang dihasilkan menggunakan autentikasi berbasis token dan informasi pengguna yang digunakan untuk menghasilkan token.

• Metode ini digunakan untuk skenario interaksi real-time berbasis AI. Untuk bergabung ke saluran, Anda harus melewatkan token satu parameter dan mengatur properti pengguna capabilityProfile berdasarkan skenario. Untuk berkomunikasi dengan agen AI, atur properti ini ke AliRtcCapabilityProfileAiHuman.

Batasan penggunaan

• Untuk beralih ke saluran yang berbeda, Anda harus terlebih dahulu memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#449873b819cz2" id="923190466431o">leaveChannel</a> untuk meninggalkan saluran Anda saat ini. Anda hanya dapat bergabung ke saluran baru setelah Anda menerima callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#3721f1f2a3kpd" id="dfd794c32covq">onLeaveChannelResult</a>.

• Pengguna hanya dapat bergabung ke satu saluran pada satu waktu.

• Aplikasi dengan App ID yang berbeda tidak dapat berkomunikasi satu sama lain.

• Jika upaya bergabung ke saluran gagal, jangan memanggil metode ini lagi untuk mencoba ulang.

Callback terkait

Pemanggilan metode ini yang berhasil memicu callback berikut:

• Hasil klien lokal bergabung ke saluran dikembalikan dalam callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#e6d2a213d7sl2" id="f83d0aff9btwh">onJoinChannelResult</a>.

• Callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#634626babfq9x" id="aeef817be3a0b">onRemoteUserOnLineNotify</a> dipicu oleh klien jarak jauh setelah Anda berhasil bergabung ke saluran.

Parameter

Meninggalkan saluran.

- (int)leaveChannel;

Setelah Anda memanggil metode ini, SDK menghentikan transmisi audio dan video dan meninggalkan saluran saat ini.

Skenario Pemanggilan

• Panggil metode ini untuk meninggalkan saluran.

• Jika Anda berada di saluran dan ingin bergabung ke saluran lain, Anda harus terlebih dahulu memanggil metode ini untuk meninggalkan saluran saat ini.

Callback Terkait

• Klien lokal: Memanggil metode ini memicu callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#3721f1f2a3kpd" id="ea2e36a41csu0">onLeaveChannelResult</a>, yang melaporkan hasil meninggalkan saluran.

• Ujung jarak jauh: Pemanggilan metode ini yang berhasil memicu callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#34876c27d7zv7" id="a50f534f21mew">onRemoteUserOffLineNotify</a> untuk pengguna lain di saluran.

Nilai kembali

Nilai 0 menunjukkan bahwa pemanggilan berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan gagal.

Memeriksa apakah pengguna berada di saluran.

- (BOOL)isInCall;

Nilai kembali

YES jika pengguna berada di saluran. NO jika tidak.

Menetapkan peran pengguna.

- (int)setClientRole:(AliRtcClientRole)role;

Metode ini menetapkan peran pengguna menjadi streamer atau penonton.

Dalam mode interaktif, sebelum Anda bergabung ke saluran:

• Streamer: SDK secara otomatis mendorong aliran audio dan video lokal dan menerima aliran dari streamer lain secara default.

• Penonton: SDK tidak mendorong aliran audio dan video lokal tetapi menerima aliran dari streamer lain.

Kapan dipanggil

Anda dapat memanggil metode ini untuk menetapkan peran pengguna sebelum bergabung ke saluran atau untuk mengganti peran pengguna setelah Anda bergabung.

Batasan

Metode ini hanya berlaku dalam mode interaktif. Mode ini diaktifkan dengan memanggil metode <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#fc9626a99f5kj" id="cd8138c77fv4r">setChannelProfile</a> untuk menetapkan profil saluran ke AliRtcInteractivelive.

Dalam mode interaktif, Anda harus secara eksplisit memanggil metode ini untuk menetapkan peran pengguna sebelum Anda bergabung ke saluran.

Parameter

Pengembalian

Nilai kembali 0 menunjukkan bahwa metode dipanggil berhasil. Nilai lain menunjukkan bahwa pemanggilan gagal.

Mengambil peran pengguna (iOS saja).

- (AliRtcClientRole)getCurrentClientRole;

Nilai kembali

Peran pengguna saat ini.

Memperbarui informasi autentikasi.

- (int)refreshAuthInfo:(AliRtcAuthInfo *_Nonnull)authInfo;

Metode ini memperbarui informasi autentikasi. Token kedaluwarsa setelah periode tertentu. Setelah token kedaluwarsa, SDK tidak dapat terhubung ke server.

Kapan harus memanggil

Pertimbangkan skenario berikut:

• Ketika Anda menerima callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#6766cdfb40z1a" id="c1cc6cbddb22o">onAuthInfoWillExpire</a>, yang melaporkan bahwa informasi autentikasi akan segera kedaluwarsa, kami merekomendasikan agar Anda menghasilkan ulang token di server Anda dan kemudian memanggil metode ini untuk melewatkan token baru.

• Jika Anda tidak memperbarui token tepat waktu, callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#b04cd67880ptu" id="13c9ccb2b6ghh">onAuthInfoExpired</a> dipicu, yang menunjukkan bahwa autentikasi telah kedaluwarsa. Pada titik ini, Anda perlu menghasilkan ulang token dan kemudian memanggil joinChannel untuk bergabung kembali ke saluran.

Parameter

Pengembalian

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lain menunjukkan bahwa pemanggilan gagal.

Memperbarui informasi autentikasi.

- (int)refreshAuthInfoWithToken:(NSString *_Nonnull)token;

Metode ini memperbarui token. Token berlaku untuk periode tertentu. Setelah token kedaluwarsa, SDK tidak dapat terhubung ke server.

Kapan dipanggil

Dalam situasi berikut, hasilkan ulang Token di server Anda dan kemudian panggil metode ini dengan Token baru:

Ketika callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#6766cdfb40z1a" id="b1dbfcb71d5ys">onAuthInfoWillExpire</a> dipicu, menunjukkan bahwa informasi autentikasi akan segera kedaluwarsa.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil, sedangkan nilai lain menunjukkan kegagalan.

Menentukan apakah akan menerbitkan aliran audio lokal.

- (int)publishLocalAudioStream:(BOOL)enable;

Secara default, SDK menerbitkan aliran audio. Untuk menonaktifkan perilaku default ini, panggil publishLocalAudioStream(false) sebelum Anda bergabung ke saluran.

Kapan dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran. Jika dipanggil sebelum bergabung, pengaturan akan berlaku ketika Anda bergabung ke saluran.

Callback terkait

Ketika status penerbitan aliran audio lokal berubah, klien lokal menerima callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#86b2d8735bm71" id="e5ef180ba6e2i">onAudioPublishStateChanged</a>, yang melaporkan status penerbitan saat ini. Klien jarak jauh menerima callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#6da9cf330aoer" id="299ef35806ttb">onRemoteTrackAvailableNotify</a>, yang menunjukkan bahwa aliran audio dan video pengguna jarak jauh telah berubah.

Parameter

Mengembalikan

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lain menunjukkan bahwa pemanggilan gagal.

Memeriksa apakah aliran audio lokal dapat diterbitkan.

- (BOOL)isLocalAudioStreamPublished;

Pengembalian

YES mengaktifkan dorongan, dan NO menonaktifkannya.

Menetapkan apakah akan berlangganan semua aliran audio jarak jauh secara default.

- (int)setDefaultSubscribeAllRemoteAudioStreams:(BOOL)sub;

Gunakan metode ini untuk mengonfigurasi perilaku langganan default untuk aliran audio jarak jauh. Pengaturan ini berlaku untuk pengguna yang kemudian bergabung ke saluran. Atur parameter ini ke true kecuali Anda memiliki persyaratan khusus.

Kapan memanggil metode ini

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

• Sebelum bergabung ke saluran:

  • Secara default, kit pengembangan perangkat lunak (SDK) berlangganan semua aliran audio jarak jauh ketika pengguna bergabung ke saluran. Untuk mengubah perilaku ini, Anda dapat memanggil metode ini sebelum bergabung ke saluran.

• Setelah bergabung ke saluran:

  • Untuk menghentikan langganan default, Anda dapat memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#8b515d9855osk" id="a467e60e4eyhk">setDefaultSubscribeAllRemoteAudioStreams</a>(false). Anda tidak akan berlangganan ke aliran audio pengguna yang kemudian bergabung ke saluran.

  • Setelah Anda menghentikan langganan default, panggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#c8249fb568gms" id="9806dd9a750pf">subscribeRemoteAudioStream</a> untuk berlangganan aliran audio pengguna tertentu. Untuk berlangganan aliran audio beberapa pengguna, Anda harus memanggil metode ini beberapa kali.

  • Setelah Anda menghentikan langganan default, memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#8b515d9855osk" id="9507d6d3121uh">setDefaultSubscribeAllRemoteAudioStreams</a>(true) melanjutkan langganan default untuk pengguna yang bergabung ke saluran setelahnya. Pemanggilan ini tidak berlangganan Anda ke aliran audio pengguna yang bergabung ke saluran saat langganan default dihentikan.

Parameter

Mengembalikan

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai selain 0 menunjukkan bahwa pemanggilan metode gagal.

Menghentikan atau melanjutkan berlangganan aliran audio pengguna jarak jauh tertentu.

- (int)subscribeRemoteAudioStream:(NSString *_Nonnull)uid sub:(BOOL)sub;

Anda dapat memanggil metode ini untuk menghentikan atau melanjutkan berlangganan aliran audio pengguna jarak jauh tertentu. Dalam sebagian besar skenario, Anda harus berlangganan aliran audio.

Parameter

Mengembalikan

Nilai 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lain menunjukkan bahwa pemanggilan gagal.

Menghentikan atau melanjutkan menerima semua aliran audio jarak jauh.

- (int)subscribeAllRemoteAudioStreams:(BOOL)sub;

Metode ini bertindak sebagai sakelar utama untuk berlangganan aliran audio jarak jauh. Jika Anda mengatur parameter ke NO, hal berikut terjadi:

• Langganan ke semua aliran audio jarak jauh di rapat saat ini dihentikan.

• Pengguna baru juga tidak akan dapat berlangganan.

• Anda tidak dapat menggunakan <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#c8249fb568gms" id="846b0dd501epf">subscribeRemoteAudioStream</a> untuk mengontrol aliran audio pengguna tertentu secara individual.

Untuk melanjutkan langganan, panggil metode ini lagi dan atur parameter ke YES.

Parameter

Nilai kembali

Nilai 0 menunjukkan bahwa metode dipanggil berhasil. Nilai lain menunjukkan bahwa pemanggilan metode gagal.

Mengaktifkan atau menonaktifkan penerbitan aliran kamera.

- (int)publishLocalVideoStream:(BOOL)enable;

Metode ini mengontrol penerbitan aliran video lokal.

Kapan dipanggil

Anda dapat memanggil metode ini sebelum atau setelah Anda bergabung ke saluran.

Jika Anda memanggil metode ini sebelum bergabung ke saluran, metode ini akan memodifikasi pengaturan default. Pengaturan baru akan berlaku ketika Anda bergabung ke saluran.

Callback terkait

Ketika status ingest aliran audio lokal berubah, klien lokal memicu callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#bd67711e63tnk" id="f966292202q3d">onVideoPublishStateChanged</a> untuk melaporkan status ingest saat ini, sedangkan klien jarak jauh memicu callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#6da9cf330aoer" id="2fdc208ccczr1">onRemoteTrackAvailableNotify</a> untuk melaporkan perubahan pada aliran audio dan video pengguna jarak jauh.

Parameter

Memeriksa apakah aliran video lokal diterbitkan.

- (BOOL)isLocalVideoStreamPublished;

Nilai kembali

YES: Aliran video lokal diterbitkan. NO: Aliran video lokal tidak diterbitkan.

Menetapkan apakah akan berlangganan semua aliran video jarak jauh secara default.

- (int)setDefaultSubscribeAllRemoteVideoStreams:(BOOL)sub;

Metode ini menetapkan perilaku langganan default untuk semua aliran video jarak jauh. Secara default, kit pengembangan perangkat lunak (SDK) berlangganan semua aliran video jarak jauh.

Kapan harus memanggil

Anda dapat memanggil metode ini baik sebelum maupun sesudah bergabung dengan saluran.

• Sebelum bergabung ke saluran:

  • Panggil metode ini untuk mencegah SDK berlangganan ke semua aliran video secara default.

• Setelah bergabung ke saluran:

  • Panggil `setDefaultSubscribeAllRemoteVideoStreams(false)` untuk menghentikan perilaku langganan default. Hal ini mencegah SDK berlangganan ke aliran video pengguna yang bergabung ke saluran setelahnya.

  • Setelah menghentikan perilaku langganan default, panggil metode subscribeRemoteVideoStream untuk berlangganan aliran video pengguna tertentu. Untuk berlangganan aliran video beberapa pengguna, Anda harus memanggil metode ini untuk setiap pengguna.

  • Setelah Anda menghentikan langganan default, pemanggilan setDefaultSubscribeAllRemoteVideoStreams(false) hanya akan melanjutkan aliran audio dari pengguna yang kemudian bergabung ke saluran.

Parameter

Nilai kembali

Nilai 0 menandakan bahwa panggilan metode berhasil. Nilai lainnya menandakan bahwa panggilan tersebut gagal.

Menghentikan atau melanjutkan penerimaan aliran video pengguna jarak jauh.

- (int)subscribeRemoteVideoStream:(NSString *_Nonnull)uid track:(AliRtcVideoTrack)track sub:(BOOL)sub;

Anda dapat berlangganan atau membatalkan langganan aliran video pengguna tertentu.

Kapan Dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Deskripsi Metrik

Menghentikan atau melanjutkan penerimaan semua aliran video jarak jauh.

- (int)subscribeAllRemoteVideoStreams:(BOOL)sub;

Jika Anda mengatur parameter ke false, hal-hal berikut terjadi:

• SDK berhenti berlangganan semua aliran video jarak jauh dalam rapat saat ini.

• SDK tidak berlangganan pengguna baru yang bergabung ke dalam rapat, meskipun Anda telah memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#a975297480yoj" id="0464849a17dks">setDefaultSubscribeAllRemoteVideoStreams</a> untuk mengaktifkan langganan default.

• Anda tidak dapat menggunakan <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#1cc7ef76fdawz" id="498e782f414zz">subscribeRemoteVideoStream</a> untuk mengontrol secara terpisah aliran audio pengguna tertentu.

Untuk melanjutkan langganan, panggil kembali metode ini dan atur parameter ke true.

Deskripsi parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan kegagalan.

Melakukan Berlangganan atau membatalkan langganan aliran media dari pengguna jarak jauh tertentu.

- (int)subscribeRemoteMediaStream:(NSString *_Nonnull)uid videoTrack:(AliRtcVideoTrack)videoTrack subVideo:(BOOL)subVideo subAudio:(BOOL)subAudio;

Metode ini berlangganan aliran audio dan video jarak jauh.

Antarmuka terkait

Dibandingkan dengan subscribeRemoteMediaStream[2/2], antarmuka ini menggunakan dua parameter Boolean, subVideo dan subAudio, untuk menentukan apakah akan berlangganan aliran audio dan video jarak jauh, serta parameter videoTrack untuk menentukan aliran video mana yang akan ditarik.

Catatan: Untuk metode ini, properti AliRtcVideoTrackNo dari AliRtcVideoTrack tidak valid. Mengaturnya tidak memiliki efek apa pun.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Berlangganan atau berhenti berlangganan aliran media dari pengguna jarak jauh tertentu.

- (int)subscribeRemoteMediaStream:(NSString *_Nonnull)uid videoTrack:(AliRtcVideoTrack)videoTrack audioTrack:(AliRtcAudioTrack)audioTrack;

Anda dapat menggunakan metode ini untuk berlangganan aliran audio dan video jarak jauh.

Metode terkait

Berbeda dengan subscribeRemoteMediaStream[1/2], metode ini menggunakan parameter videoTrack dan audioTrack untuk mengatur status langganan yang diinginkan dalam satu panggilan. Contohnya:

• Untuk berlangganan aliran Kamera dan aliran mikrofon, atur videoTrack ke AliRtcVideoTrackCamera dan audioTrack ke AliRtcAudioTrackMic.

• Untuk berhenti berlangganan aliran Kamera tetapi tetap berlangganan aliran mikrofon, atur videoTrack ke AliRtcVideoTrackNo dan audioTrack ke AliRtcAudioTrackMic.

• Untuk berhenti berlangganan kedua aliran tersebut, atur videoTrack ke AliRtcVideoTrackNo dan audioTrack ke AliRtcAudioTrackNo.

• Untuk berlangganan baik aliran Kamera maupun aliran berbagi layar, atur videoTrack ke AliRtcVideoTrackBoth. Logika yang sama berlaku untuk aliran audio.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa metode berhasil dipanggil. Nilai bukan nol menunjukkan bahwa panggilan gagal.

Berlangganan ke aliran pengguna tertentu di saluran lain.

- (int)subscribeRemoteDestChannelStream:(NSString *_Nonnull)channelId uid:(NSString *_Nonnull)uid track:(AliRtcVideoTrack)track subAudio:(BOOL)subAudio sub:(BOOL)sub;

Parameter

Nilai kembalian

Mengembalikan 0 jika panggilan berhasil, atau nilai bukan nol jika panggilan gagal.

Berlangganan ke aliran dari semua pengguna di saluran tujuan.

- (int)subscribeRemoteDestChannelAllStream:(NSString *_Nonnull)channelId track:(AliRtcVideoTrack)track subAudio:(BOOL)subAudio sub:(BOOL)sub;

Parameter

Nilai kembali

Mengembalikan 0 jika berhasil. Nilai selain nol mengindikasikan kegagalan.

Mengatur volume pemutaran pengguna jarak jauh.

- (int)setRemoteAudioVolume:(NSString *_Nonnull)uid volume:(NSInteger)volume;

Parameters

Return value

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan kegagalan.

Menghentikan atau melanjutkan pengiriman aliran audio lokal.

- (int)muteLocalMic:(BOOL)mute mode:(AliRtcMuteLocalAudioMode)mode;

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Callback terkait

Setelah pemanggilan berhasil, callback <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#3189c59d9fipb" id="1579c3523779c">onUserAudioMuted</a> dipicu untuk menunjukkan apakah pengguna jarak jauh dimatikan suaranya.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan pemanggilan metode berhasil. Nilai lainnya menunjukkan pemanggilan gagal.

Menghentikan atau melanjutkan pemutaran audio jarak jauh.

- (int)muteRemoteAudioPlaying:(NSString *_Nonnull)uid mute:(BOOL)mute;- (int)muteRemoteAudioPlaying:(NSString *_Nonnull)uid mute:(BOOL)mute;- (int)muteRemoteAudioPlaying:(NSString *_Nonnull)uid mute:(BOOL)mute;

Metode ini hanya menghentikan atau melanjutkan pemutaran audio dari pengguna jarak jauh tertentu, dan tidak memengaruhi penarikan aliran dan decoding audio jarak jauh. Untuk berhenti berlangganan aliran audio pengguna, panggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#c8249fb568gms" id="dd9dbbad0bkni">subscribeRemoteAudioStream</a>.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Parameter

Nilai Kembali

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Metode ini menghentikan atau melanjutkan pemutaran semua audio jarak jauh.

- (int)muteAllRemoteAudioPlaying:(BOOL)mute;

Metode ini menghentikan atau melanjutkan semua aliran audio jarak jauh.

Kapan memanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung dengan saluran.

Parameter

Nilai Kembali

Mengembalikan 0 jika panggilan metode berhasil. Nilai non-nol menunjukkan bahwa panggilan metode gagal.

Memulai pengambilan audio.

- (void)startAudioCapture;

Metode ini memulai pengambilan audio. Anda dapat memanggilnya sebelum bergabung ke rapat untuk memulai pengambilan audio lebih awal. Secara default, SDK secara otomatis mengelola perangkat pengambilan audio. Jika Anda menghentikan pengambilan audio dengan memanggil stopAudioCapture, Anda harus memanggil metode ini lagi untuk memulainya kembali.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke rapat.

Metode terkait

Antarmuka startAudioCapture[2/2] memungkinkan Anda menggunakan parameter untuk menentukan apakah perangkat pengambilan audio tetap diaktifkan setelah Anda meninggalkan rapat.

Callback terkait

Setelah Anda memanggil metode ini, setiap perubahan pada status pengambilan audio lokal dilaporkan melalui callback onLocalAudioStateChanged.

Pengembalian

Nilai kembali 0 menunjukkan pemanggilan berhasil. Nilai lainnya menunjukkan pemanggilan gagal.

Memulai penangkapan audio.

- (void)startAudioCapture:(BOOL)keepAlive;

Membisukan mikrofon akan menghentikan penangkapan audio.

Anda dapat memanggil metode ini untuk memulai penangkapan audio sebelum bergabung ke dalam rapat. Jika Anda tidak memanggil metode ini, SDK secara otomatis mengontrol perangkat penangkapan audio.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke dalam rapat.

Metode terkait

Dibandingkan dengan startAudioCapture[1/2], metode ini memungkinkan Anda menggunakan parameter keepAlive untuk mengontrol apakah perangkat penangkapan tetap diaktifkan setelah Anda meninggalkan rapat.

Callback terkait

Saat Anda memanggil metode ini, setiap perubahan status penangkapan audio lokal dilaporkan melalui callback onLocalAudioStateChanged.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa metode berhasil dipanggil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Menghentikan pengambilan audio.

- (void)stopAudioCapture;

Anda dapat memanggil metode ini untuk menghentikan pengambilan perangkat audio yang dimulai dengan memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#3103c368bexf8" id="ddef64f9b93zq">startAudioCapture</a>.

Callback terkait

Pemanggilan metode ini memicu callback onLocalAudioStateChanged untuk melaporkan perubahan status pengambilan audio lokal.

Nilai kembali

Nilai kembali 0 menunjukkan pemanggilan metode berhasil. Nilai bukan nol menunjukkan pemanggilan metode gagal.

Mengalihkan output audio ke earpiece atau speaker (hanya iOS).

- (int)enableSpeakerphone:(BOOL)enable;

Metode ini mengalihkan perangkat pemutaran audio ke earpiece atau speaker setelah Anda bergabung ke saluran. Jika Anda tidak memanggil metode ini, rute audio default digunakan untuk pemutaran.

SDK memiliki prioritas perutean audio yang telah ditentukan sebelumnya dan secara otomatis mengalihkan rute audio berdasarkan status koneksi perangkat eksternal. Prioritasnya adalah sebagai berikut: Headset berkabel > Headset Bluetooth > Pengaturan pengguna > Pengaturan default. Oleh karena itu, memanggil metode ini tidak berpengaruh ketika perangkat eksternal terhubung. Untuk informasi selengkapnya tentang pengaturan perutean audio, lihat Pengaturan perutean audio.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Metode terkait

<a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#83be8cc066qqq" id="f8de149ef8so0">setDefaultAudioRoutetoSpeakerphone</a> memodifikasi rute audio default dan menetapkan perangkat audio saat ini.

Parameter

Mengembalikan

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Memeriksa apakah speakerphone diaktifkan. Metode ini hanya berlaku untuk iOS.

- (BOOL)isEnableSpeakerphone;

Deskripsi Respons

Mengembalikan YES untuk mode speaker atau NO untuk mode earpiece.

Mengatur frekuensi callback volume dan koefisien penghalusan.

- (int)enableAudioVolumeIndication:(NSInteger)interval smooth:(NSInteger)smooth reportVad:(NSInteger)reportVad;

Metode ini memungkinkan SDK melaporkan secara berkala volume pengguna lokal yang sedang menerbitkan aliran dan volume pengguna jarak jauh dengan volume instan tertinggi.

Kapan harus dipanggil

Panggil metode ini sebelum atau setelah bergabung ke saluran.

Callback terkait

Setelah Anda berhasil memanggil metode ini, SDK memicu dua callback berikut pada interval yang ditentukan jika pengguna sedang menerbitkan aliran di saluran:

• Callback onAudioVolumeCallback melaporkan volume audio setiap pembicara. Frekuensi callback ini ditentukan oleh parameter `interval`.

• Saat aktivitas suara terdeteksi, callback onActiveSpeaker melaporkan UID pengguna aktif yang sedang berbicara.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Mengaktifkan pemantauan in-ear.

- (int)enableEarBack:(BOOL)enable;

Metode ini mengaktifkan atau menonaktifkan fitur pemantauan in-ear. Untuk hasil terbaik, gunakan fitur ini dengan headphone berkabel atau Bluetooth.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Parameter

Mengembalikan

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai selain 0 menunjukkan bahwa pemanggilan metode gagal.

Mengatur volume pemantauan in-ear.

- (int)setEarBackVolume:(NSInteger)volume;

Metode ini mengatur volume pemantauan in-ear. Pengaturan ini hanya berlaku setelah Anda mengaktifkan pemantauan in-ear dengan memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#bd665d0f894ux" id="b0fa866c9bcuq">enableEarBack</a>.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Parameter

Mengembalikan

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Memulai pemutaran audio.

- (void)startAudioPlayer;

Menghentikan pemutaran audio.

- (void)stopAudioPlayer;

Mengatur volume pemutaran.

- (int)setPlayoutVolume:(NSInteger)volume;

Parameters

Return value

Mengembalikan 0 jika berhasil, atau nilai bukan nol jika gagal.

Mengatur volume perekaman.

- (int)setRecordingVolume:(NSInteger)volume;

Parameters

Return value

Mengembalikan 0 jika berhasil, atau nilai bukan nol jika gagal.

Memutar file audio.

- (int)playAudioFileTest:(NSString *_Nonnull)filePath;

Parameters

Return value

Mengembalikan 0 jika berhasil, atau nilai bukan nol jika gagal.

Menghentikan pemutaran file audio.

- (int)stopAudioFileTest;

Nilai kembalian

Mengembalikan 0 jika berhasil, atau nilai bukan nol jika gagal.

Memulai pengujian perangkat tangkapan audio sebelum panggilan.

- (void)startAudioCaptureTest;

Menghentikan pengujian pra-panggilan untuk perangkat tangkapan audio.

- (void)stopAudioCaptureTest;

Menentukan apakah akan menggunakan speaker sebagai output audio default. Secara default, speaker digunakan.

- (int)setDefaultAudioRouteToSpeakerphone:(BOOL)defaultToSpeakerphone;

Anda dapat memanggil antarmuka ini sebelum bergabung ke saluran untuk mengatur perangkat routing audio default ke earpiece atau speaker. Secara default, SDK mengarahkan audio ke speaker. Untuk mengubah konfigurasi default ini, Anda harus memanggil antarmuka ini sebelum bergabung ke saluran.

Prioritas routing audio telah ditentukan sebelumnya dalam SDK dan secara otomatis beralih berdasarkan status koneksi periferal saat ini. Prioritasnya adalah sebagai berikut: Wired headset > Bluetooth headset > User settings > Default settings. Oleh karena itu, jika tidak ada perangkat periferal yang terhubung dan Anda tidak memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#f7d0d8b64fzkz" id="30798b686b5qk">enableSpeakerphone</a>, pengaturan default akan diterapkan.

Untuk informasi selengkapnya, lihat Pengaturan routing audio.

Perangkat seluler biasanya memiliki dua perangkat routing audio: earpiece dan speaker.

• Ketika audio diarahkan ke earpiece, volumenya rendah, dan suara hanya jelas jika perangkat didekatkan ke telinga. Hal ini memberikan privasi yang baik dan cocok untuk panggilan telepon.

• Ketika audio diarahkan ke speaker, suaranya keras, sehingga Anda dapat mendengar dengan jelas tanpa menempelkan ponsel ke wajah. Hal ini memungkinkan fitur hands-free.

API Terkait

Antarmuka ini mengubah pengaturan routing audio default, sedangkan antarmuka <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#f7d0d8b64fzkz" id="6001aa98ebapw">enableSpeakerphone</a> mengatur perangkat routing saat ini.

Kapan Memanggil

Anda dapat memanggil antarmuka ini sebelum atau setelah bergabung ke saluran.

Deskripsi Metrik

Nilai Kembalian

0 menunjukkan keberhasilan. Nilai lain menunjukkan kegagalan.

Mengatur mode efek pengubah suara.

- (int)setAudioEffectVoiceChangerMode:(AliRtcAudioEffectVoiceChangerMode)mode;

Parameter

Nilai kembalian

0 menunjukkan bahwa pemanggilan berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan gagal.

Mengatur pitch efek audio.

- (int)setAudioEffectPitchValue:(double)value;

Parameters

Return value

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan gagal.

Mengatur mode efek suara reverb.

- (int)setAudioEffectReverbMode:(AliRtcAudioEffectReverbMode)mode;

Parameters

Return value

Mengembalikan nilai 0 jika pemanggilan metode berhasil, dan nilai bukan nol jika gagal.

Mengatur jenis dan parameter efek suara reverb.

- (int)setAudioEffectReverbParamType:(AliRtcAudioEffectReverbParamType)type value:(float)value;

Parameters

Response Description

Nilai kembali 0 menunjukkan pemanggilan metode berhasil. Nilai lainnya menunjukkan pemanggilan metode gagal.

Menambahkan aliran audio eksternal.

- (int)addExternalAudioStream:(AliRtcExternalAudioStreamConfig *_Nonnull)config;

Metode ini menambahkan aliran audio eksternal. Ikuti langkah-langkah berikut:

1. Panggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#d71bbfd2f242b" id="c3103216e9eu35">addExternalAudioStream</a> untuk menambahkan aliran audio eksternal dan mendapatkan ID aliran audio eksternal.

2. Panggil pushExternalAudioStream untuk mendorong data audio ke aliran audio yang telah dibuat.

3. Saat panggilan berakhir, Anda harus memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#282d70095duaw" id="16f621608d94x">removeExternalAudioStream</a> untuk menghapus aliran audio eksternal.

Untuk informasi selengkapnya tentang memublikasikan audio hasil tangkapan kustom dalam saluran, lihat Custom audio capture.

Parameters

Returns

Nilai kembali lebih besar dari 0 menunjukkan panggilan berhasil. Nilai ini merupakan ID aliran audio eksternal. Nilai lainnya menunjukkan bahwa panggilan gagal.

Menyisipkan data aliran audio eksternal.

- (int)pushExternalAudioStream:(int)streamId rawData:(AliRtcAudioFrame * _Nonnull)audioFrame;

Untuk menyisipkan data ke aliran audio tertentu, ikuti langkah-langkah berikut:

1. Anda dapat memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#d71bbfd2f242b" id="0a353f7272shu">addExternalAudioStream</a> untuk menambahkan aliran audio eksternal dan mendapatkan ID-nya.

2. Anda dapat memanggil metode ini untuk menyisipkan data audio ke aliran audio yang telah dibuat.

3. Saat panggilan berakhir, panggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#282d70095duaw" id="a9ebc8d599dz4">removeExternalAudioStream</a> untuk menghapus aliran audio eksternal tersebut.

Untuk petunjuk tentang cara memublikasikan audio hasil tangkapan kustom dalam saluran, lihat Custom audio capture.

Parameters

Returns

Nilai kembali 0 menunjukkan pemanggilan metode berhasil. Nilai lainnya menunjukkan pemanggilan gagal.

Mengatur volume publikasi aliran audio eksternal.

- (int)setExternalAudioStream:(int)streamId
                publishVolume:(int)publishVolume;

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Mengambil volume publikasi dari aliran audio eksternal.

- (int)getExternalAudioStreamPublishVolume:(int)streamId;

Parameters

Return value

Volume publikasi, yang berkisar antara 0 hingga 100. Nilai kurang dari 0 menunjukkan bahwa panggilan gagal.

Mengatur volume pemutaran aliran audio eksternal.

- (int)setExternalAudioStream:(int)streamId
                playoutVolume:(int)playoutVolume;

Parameters

Returns

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Mengambil volume pemutaran aliran audio eksternal.

- (int)getExternalAudioStreamPlayoutVolume:(int)streamId;

Parameters

Returns

Volume pemutaran. Nilainya berkisar antara 0 hingga 100. Nilai kurang dari 0 menunjukkan bahwa panggilan gagal.

Menghapus aliran audio eksternal.

- (int)removeExternalAudioStream:(int)streamId;

Metode ini menghapus aliran audio eksternal untuk ID aliran tertentu. Metode ini merupakan pasangan dari metode addExternalAudioStream.

Kapan harus dipanggil

Untuk menggunakan fitur input audio kustom, panggil metode addExternalAudioStream untuk menambahkan aliran audio dan mendapatkan ID aliran audio eksternal. Kemudian, panggil metode pushExternalAudioStream untuk mendorong data audio Anda ke SDK. Untuk menghentikan input audio kustom, panggil metode ini untuk menghapus aliran audio eksternal dan melepaskan sumber dayanya.

Parameter

Nilai kembalian

Mengembalikan 0 jika berhasil. Nilai lain menunjukkan kegagalan.

Mengambil informasi mengenai berkas audio.

- (int)getAudioFileInfo:(NSString *_Nonnull)filePath;

Parameters

Memulai pencampuran iringan audio.

- (int)startAudioAccompanyWithFile:(NSString *_Nonnull)filePath config:(AliRtcAudioAccompanyConfig *_Nonnull)config;

Parameters

Return value

Nilai 0 menunjukkan bahwa panggilan berhasil. Nilai lain menunjukkan bahwa panggilan gagal.

Menghentikan pencampuran audio iringan.

- (int)stopAudioAccompany;

Nilai kembalian

Mengembalikan 0 jika panggilan berhasil, atau nilai lain jika panggilan gagal.

Mengatur volume audio iringan.

- (int)setAudioAccompanyVolume:(NSInteger)volume;

Parameters

Return value

Mengembalikan 0 jika berhasil. Kode kesalahan dikembalikan jika gagal.

Mengatur volume iringan audio untuk pengambilan aliran.

- (int)setAudioAccompanyPublishVolume:(NSInteger)volume;

Parameters

Return value

Nilai kembali 0 menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Mengambil volume iringan untuk pengambilan aliran.

- (int)getAudioAccompanyPublishVolume;

Return value

Nilai dari 0 hingga 100 menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Mengatur volume pemutaran lokal untuk iringan audio.

- (int)setAudioAccompanyPlayoutVolume:(NSInteger)volume;

Parameters

Return value

Mengembalikan 0 jika berhasil. Nilai lainnya menunjukkan kegagalan.

Mengambil volume pemutaran lokal dari iringan audio.

- (int)getAudioAccompanyPlayoutVolume;

Nilai kembali

Nilai kembali dari 0 hingga 100 menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Menghentikan sementara iringan audio.

- (int)pauseAudioAccompany;

Return value

Mengembalikan nilai 0 jika berhasil dan nilai bukan nol jika gagal.

Menjalankan kembali pencampuran iringan audio.

- (int)resumeAudioAccompany;

Nilai kembali

Nilai kembali 0 menunjukkan keberhasilan, dan nilai bukan nol menunjukkan kegagalan.

Mengambil durasi file iringan audio dalam milidetik.

- (int)getAudioAccompanyDuration;

Nilai kembalian

Pemanggilan yang berhasil mengembalikan durasi file iringan audio dalam milidetik, yaitu nilai 0 atau lebih besar. Pemanggilan yang gagal mengembalikan nilai <0.

Mengambil progres pemutaran file iringan dalam milidetik.

- (int)getAudioAccompanyCurrentPosition;

Nilai kembalian

Progres pemutaran file iringan. Nilai kurang dari 0 dikembalikan jika operasi gagal.

Mengatur posisi pemutaran file iringan.

- (int)setAudioAccompanyPosition:(int)pos;

Parameters

Return value

Mengembalikan 0 jika berhasil. Nilai lainnya menunjukkan kegagalan.

Memuat sebelumnya file efek suara.

- (int)preloadAudioEffectWithSoundId:(NSInteger)soundId filePath:(NSString *_Nonnull)filePath;

Parameter

Nilai kembalian

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai selain 0 menunjukkan bahwa pemanggilan metode gagal.

Menghapus pemuatan berkas efek suara yang telah dimuat sebelumnya.

- (int)unloadAudioEffectWithSoundId:(NSInteger)soundId;

Parameter

Deskripsi Respons

Nilai kembali 0 menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Memulai pemutaran efek suara.

- (int)playAudioEffectWithSoundId:(NSInteger)soundId filePath:(NSString *_Nonnull)filePath cycles:(NSInteger)cycles publish:(BOOL)publish;

Parameter

Nilai kembalian

Nilai 0 menunjukkan pemanggilan metode berhasil. Nilai lainnya menunjukkan kegagalan.

Menghentikan pemutaran efek suara.

- (int)stopAudioEffectWithSoundId:(NSInteger)soundId;

Parameters

Return value

Mengembalikan 0 jika pemanggilan metode berhasil, atau nilai bukan nol jika gagal.

Menghentikan pemutaran semua efek suara.

- (int)stopAllAudioEffects;

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Menghentikan sementara efek suara.

- (int)pauseAudioEffectWithSoundId:(NSInteger)soundId;

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Menghentikan sementara semua efek suara.

- (int)pauseAllAudioEffects;

Returns

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Menjalankan kembali pemutaran efek suara.

- (int)resumeAudioEffectWithSoundId:(NSInteger)soundId;

Parameters

Return value

Mengembalikan 0 jika pemanggilan metode berhasil, atau nilai bukan nol jika pemanggilan gagal.

Menjalankan kembali pemutaran semua efek suara.

- (int)resumeAllAudioEffects;

Returns

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Mengatur volume efek suara tertentu untuk pengambilan aliran.

- (int)setAudioEffectPublishVolumeWithSoundId:(NSInteger)soundId volume:(NSInteger)volume;

Parameters

Return value

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Mengambil volume efek suara untuk pengambilan aliran.

- (int)getAudioEffectPublishVolumeWithSoundId:(NSInteger)soundId;

Parameters

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Mengatur volume pencampuran semua efek suara untuk aliran yang dipublikasikan.

- (int)setAllAudioEffectsPublishVolume:(NSInteger)volume;

Parameters

Returns

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai selain 0 menunjukkan bahwa pemanggilan metode gagal.

Mengatur volume pemutaran lokal dari efek suara.

- (int)setAudioEffectPlayoutVolumeWithSoundId:(NSInteger)soundId volume:(NSInteger)volume;

Parameter

Nilai kembalian

Mengembalikan 0 jika berhasil. Nilai bukan nol menunjukkan kegagalan.

Mengambil volume pemutaran lokal dari efek suara.

- (int)getAudioEffectPlayoutVolumeWithSoundId:(NSInteger)soundId;

Parameters

Returns

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Mengatur volume pemutaran lokal untuk semua efek suara.

- (int)setAllAudioEffectsPlayoutVolume:(NSInteger)volume;

Parameters

Return value

Nilai 0 menunjukkan pemanggilan metode berhasil. Nilai bukan nol menunjukkan pemanggilan gagal.

Memulai perekaman file media.

- (BOOL)startRecord:(AliRtcRecordType)recordType recordFormat:(AliRtcRecordFormat)recordFormat filePath:(NSString*)filePath audioConfig:(AliRtcRecordAudioConfig*)audioConfig videoConfig:(AliRtcRecordVideoConfig*)videoConfig;

Parameter

Nilai kembali

Nilai kembali TRUE menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Menghentikan perekaman file media.

- (void)stopRecord 

Parameters

Tidak ada.

Mengatur jendela rendering dan parameter untuk pratinjau lokal.

- (int)setLocalViewConfig:(AliVideoCanvas *_Nullable)viewConfig forTrack:(AliRtcVideoTrack)track;

Metode ini mengatur tampilan untuk pratinjau video lokal. Metode ini mengikat jendela tampilan (view) ke aliran video lokal dan mengonfigurasi parameter, seperti mode rendering, mode cermin, dan sudut rotasi. Pengaturan ini hanya memengaruhi pratinjau lokal dan tidak memengaruhi aliran video yang dipublikasikan. Untuk mengatur tampilan pengguna jarak jauh, panggil setRemoteViewConfig.

Kapan metode ini dipanggil

Metode ini dapat dipanggil sebelum atau setelah bergabung ke saluran.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa metode berhasil dipanggil. Nilai bukan nol menunjukkan bahwa panggilan gagal.

Mengatur preferensi pengambilan kamera.

- (int)setCameraCapturerConfiguration:(AliRtcCameraCapturerConfiguration* _Nonnull)config;

Gunakan metode ini untuk mengonfigurasi preferensi pengambilan kamera, seperti arah kamera dan laju frame pengambilan.

Kapan harus dipanggil

Panggil metode ini sebelum Anda membuka kamera. Misalnya, panggil metode ini sebelum operasi berikut:

• startPreview

• joinChannel

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa metode berhasil dipanggil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Anda dapat menonaktifkan atau mengaktifkan kembali pengambilan video lokal.

- (int)enableLocalVideo:(BOOL)enable;

Metode ini mengaktifkan atau menonaktifkan pengambilan video lokal. Saat Anda menonaktifkan pengambilan video lokal, SDK berhenti mengirim data video untuk pratinjau lokal dan pengambilan aliran. Hal ini tidak memengaruhi penerimaan video jarak jauh. Jika Anda memanggil metode ini untuk menonaktifkan pengambilan video lokal, baik pratinjau lokal maupun pengambilan aliran jarak jauh akan membekukan pada bingkai terakhir.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran.

Callback terkait

• Setelah metode ini berhasil dipanggil, pengguna jarak jauh diberi tahu melalui callback onUserVideoEnabled.

Parameter

Nilai kembalian

Mengembalikan 0 jika pemanggilan metode berhasil. Nilai bukan nol menunjukkan bahwa pemanggilan metode gagal.

Menghentikan atau melanjutkan pengiriman aliran video lokal.

- (int)muteLocalCamera:(BOOL)mute forTrack:(AliRtcVideoTrack)track;

Anda dapat memanggil metode ini selama pengambilan aliran untuk mengirim frame video hitam. Pratinjau lokal tidak terpengaruh. Modul penangkapan, pengodean, dan pengiriman terus berjalan, tetapi video yang dikirim hanya terdiri dari frame hitam.

Parameter

Antarmuka terkait

Nilai kembali 0 mengindikasikan bahwa panggilan metode berhasil. Nilai lainnya mengindikasikan bahwa panggilan tersebut gagal.

Menetapkan jendela rendering dan parameter rendering untuk aliran video jarak jauh.

- (int)setRemoteViewConfig:(AliVideoCanvas *_Nullable)canvas uid:(NSString *_Nonnull)uid forTrack:(AliRtcVideoTrack)track;

Metode ini menyambungkan tampilan aliran video pengguna jarak jauh dan menetapkan mode rendering, mode cermin, serta sudut rotasinya. Pengaturan ini hanya memengaruhi tampilan video untuk pengguna lokal. Untuk mengatur tampilan pratinjau lokal, panggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#fea843803078q" id="b6f22fe87a2es">setLocalViewConfig</a>.

• Jika parameter view dari AliVideoCanvas bernilai null, rendering berhenti.

• Untuk mengatur ulang parameter renderMode dari AliVideoCanvas selama pemutaran, ubah hanya parameter tersebut. Semua parameter lain harus tetap tidak berubah.

• Untuk mengatur ulang parameter mirrorMode dari AliVideoCanvas selama pemutaran, ubah hanya parameter tersebut. Semua parameter lain harus tetap tidak berubah.

Kapan dipanggil

Anda dapat memanggil metode ini saat menerima callback onRemoteTrackAvailableNotify, yang dipicu ketika aliran video dari pengguna jarak jauh tersedia.

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Memeriksa apakah kamera menyala.

- (BOOL)isCameraOn;

Returns

Mengembalikan YES jika kamera menyala, atau NO jika kamera mati.

Mengatur properti pengkodean video.

- (void)setVideoEncoderConfiguration:(AliRtcVideoEncoderConfiguration* _Nonnull)config;

Anda dapat menggunakan metode ini untuk mengatur parameter video untuk aliran video, seperti resolusi, laju frame, bitrate, dan orientasi. Metode ini berlaku untuk semua skenario video.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran. Untuk mengatur properti pengkodean aliran kamera hanya sekali setiap sesi, panggil metode ini sebelum Anda bergabung ke saluran.

Batasan

Baik parameter mirrorMode maupun metode setVideoMirrorMode dapat mengatur mode cermin untuk aliran yang dimasukkan. Anda hanya boleh menggunakan salah satu dari metode tersebut. Jika Anda menggunakan keduanya, efek cermin mungkin bertentangan, yang dapat menyebabkan pengaturan cermin gagal atau berperilaku tidak sesuai harapan.

Parameter

Menetapkan konfigurasi decoding video.

- (void)setVideoDecoderConfiguration:(AliRtcVideoDecoderConfiguration* _Nonnull)config;

Metode ini menetapkan parameter decoding video untuk aliran kamera.

Kapan harus dipanggil

Panggil metode ini sebelum bergabung ke saluran.

Parameter

Beralih antara kamera depan dan kamera belakang. Kamera depan digunakan secara default.

- (int)switchCamera;

Metode ini memungkinkan Anda beralih secara dinamis antara kamera aktif saat aplikasi sedang berjalan. Anda tidak perlu memulai ulang aliran video atau mengonfigurasi ulang sumber video.

Kapan harus dipanggil

Anda dapat memanggil metode ini setelah kamera berhasil dijalankan.

Batasan

Metode ini hanya tersedia di Android dan iOS.

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Mengambil arah kamera saat ini. Kamera depan digunakan secara default. Metode ini hanya tersedia di iOS.

- (AliRtcCameraDirection)getCurrentCameraDirection;

Return value

Mengembalikan nilai enumerasi untuk arah kamera.

Memulai pratinjau lokal dan secara otomatis mengaktifkan kamera.

- (int)startPreview;

Anda dapat memanggil metode ini untuk memulai pratinjau video lokal. Untuk menghentikan pratinjau, panggil metode stopPreview.

Kapan harus dipanggil

• Sebelum memanggil metode ini, Anda harus memanggil setLocalViewConfig untuk menetapkan tampilan bagi pratinjau lokal. Jika tidak, pratinjau tidak tersedia, tetapi pengambilan aliran tidak terpengaruh.

• Anda dapat memanggil metode ini untuk memulai pratinjau sebelum memanggil joinChannel. Hal ini secara otomatis akan mengaktifkan kamera.

Nilai kembalian

0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan gagal.

Menghentikan pratinjau lokal.

- (int)stopPreview;

Metode ini menghentikan pratinjau video lokal dan mematikan kamera. Setelah pratinjau dihentikan, video lokal membekukan pada bingkai terakhir. Hal ini tidak memengaruhi pengambilan aliran.

Kapan harus dipanggil

Anda dapat memanggil metode ini untuk menghentikan pratinjau lokal setelah Anda memulainya.

Nilai kembali

Nilai kembali 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Mengatur zoom kamera.

 - (int)setCameraZoom:(float)zoom;

Parameters

Return value

Mengembalikan 0 jika berhasil. Nilai lain menunjukkan kegagalan.

Mengembalikan faktor zoom maksimum dari Kamera.

 - (float)GetCameraMaxZoomFactor;

Nilai kembalian

Faktor zoom maksimum dari Kamera.

Mengambil rasio zoom saat ini dari kamera.

- (float)GetCurrentZoom;

Nilai yang dikembalikan

Rasio zoom saat ini dari kamera.

Mengatur eksposur kamera.

- (int)SetExposure:(float)exposure;

Parameters

Return value

Mengembalikan 0 jika berhasil. Nilai bukan nol menunjukkan kegagalan.

Mengambil eksposur kamera.

- (float)GetCurrentExposure;

Nilai yang dikembalikan

Eksposur kamera.

Mengambil eksposur kamera minimum.

- (float)GetMinExposure;

Nilai kembalian

Eksposur kamera minimum.

Mengambil eksposur maksimum kamera.

- (float)GetMaxExposure;

Nilai kembalian

Eksposur maksimum kamera.

Mengaktifkan atau menonaktifkan lampu kilat kamera.

- (int)setCameraFlash:(BOOL)flash;

Parameters

Return value

Nilai kembali 0 menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Memeriksa apakah kamera mendukung fokus manual.

- (BOOL)isCameraFocusPointSupported;

Nilai kembalian

Mengembalikan TRUE jika fokus manual didukung, atau FALSE jika tidak.

Memeriksa apakah kamera mendukung pengaturan titik eksposur.

- (BOOL)isCameraExposurePointSupported;

Nilai yang dikembalikan

TRUE: Pengaturan titik eksposur didukung. FALSE: Pengaturan titik eksposur tidak didukung.

Mengatur titik fokus manual untuk Kamera.

- (int)setCameraFocusPoint:(CGPoint)point;

Parameters

Return value

Nilai kembali 0 menunjukkan bahwa operasi berhasil. Nilai lainnya menunjukkan bahwa operasi gagal.

Mengatur titik eksposur kamera.

- (int)setCameraExposurePoint:(CGPoint)point;

Parameters

Return value

Mengembalikan 0 jika operasi berhasil. Nilai bukan nol dikembalikan jika operasi gagal.

Memeriksa apakah kamera mendukung autofokus berbasis wajah.

- (BOOL)isCameraAutoFocusFaceModeSupported;

Nilai kembalian

TRUE menunjukkan bahwa autofokus berbasis wajah didukung. FALSE menunjukkan bahwa fitur tersebut tidak didukung.

Mengaktifkan atau menonaktifkan autofokus wajah untuk kamera.

- (BOOL)setCameraAutoFocusFaceModeEnabled:(BOOL)enable;

Parameters

Return value

Mengembalikan TRUE jika berhasil atau FALSE jika gagal.

Mengatur mode cermin video.

- (int)setVideoMirrorMode:(AliRtcVideoPipelineMirrorMode)mirrorMode;

Metode ini mengatur mode cermin untuk pratinjau video lokal dan aliran video yang dipublikasikan.

Kapan harus dipanggil

Anda dapat memanggil metode ini sebelum atau setelah bergabung ke saluran. SDK mencatat pengaturan tersebut dan menerapkan mode cermin saat pratinjau video dan pengkodean (pengambilan aliran) aktif.

Batasan

Fungsionalitas metode ini tumpang tindih dengan parameter mirrorMode dalam setLocalViewConfig dan setVideoEncoderConfiguration. Untuk menghindari perilaku yang tidak diinginkan, kami menyarankan Anda hanya menggunakan metode ini untuk mengatur mode cermin.

Parameter

Mengatur mode penskalaan untuk pipeline video.

-(void)setCapturePipelineScaleMode:(AliRtcCapturePipelineScaleMode)mode;

Metode ini menentukan apakah data video akan diskalakan segera setelah diambil atau saat encoding. Misalnya, jika resolusi pengambilan berbeda dari resolusi encoding, Anda dapat menggunakan metode ini untuk memastikan bahwa data pratinjau sesuai dengan data aliran yang dipublikasikan.

Kapan memanggil metode ini

Panggil metode ini sebelum Anda mengaktifkan kamera, misalnya, sebelum Anda memanggil startPreview atau joinChannel.

Parameter

Nilai kembali

Nilai kembali 0 mengindikasikan keberhasilan. Nilai lainnya mengindikasikan kegagalan.

Mendaftarkan sebuah objek untuk mengeluarkan data video.

- (void)registerVideoFrameWithObserver:(id<AliRtcVideoFrameDelegate> _Nullable)observer;

Panggil metode ini untuk mendaftarkan sebuah objek guna mengeluarkan data video. Untuk membatalkan pendaftaran objek tersebut, panggil metode unregisterVideoSampleWithObserver.

Kapan harus dipanggil

Untuk mendapatkan data video mentah, seperti data dalam format YUV atau RGBA, panggil metode ini untuk mendaftarkan observer data video. Hal ini memungkinkan Anda memperoleh data video pada berbagai tahap.

Callback terkait

Setelah Anda mendaftarkan observer data video, kit pengembangan perangkat lunak (SDK) memicu callback yang telah Anda implementasikan setiap kali sebuah frame video ditangkap. Implementasikan callback berikut sesuai kebutuhan:

• onCaptureVideoSample: Callback untuk data video yang ditangkap secara lokal.

• onRemoteVideoSample: Callback untuk data video jarak jauh.

• onPreEncodeVideoSample: Callback untuk data video lokal sebelum pengkodean.

Parameter

Membatalkan pendaftaran pengamat bingkai video.

- (void)unregisterVideoSampleWithObserver:(id<AliRtcVideoFrameDelegate> _Nullable)observer;

Antarmuka ini membatalkan pendaftaran objek untuk mengekspor data video dan merupakan pasangan dari antarmuka <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#9a3437ab16j1w" id="f524bad30a6ys">registerVideoSampleObserver</a>.

Parameters

Anda dapat mendaftarkan pengamat data tekstur OpenGL untuk aliran video kamera lokal.

- (void)registerLocalVideoTextureObserver:(id<AliRtcTextureDelegate> _Nullable)observer;

Untuk memperoleh data video mentah, panggil antarmuka registerVideoSampleObserver untuk mendaftarkan callback yang sesuai. Untuk memperoleh data tekstur internal, panggil antarmuka yang sesuai untuk mendaftarkan pengamat tekstur. Untuk membatalkan pendaftaran pengamat, panggil antarmuka unRegisterLocalVideoTextureObserver.

Callback Terkait

Setelah Anda mendaftarkan pengamat untuk data tekstur OpenGL dari aliran video kamera lokal, SDK memicu callback dalam implementasi `AliRtcTextureObserver` Anda untuk setiap bingkai video yang ditangkap. Anda dapat mengimplementasikan callback yang sesuai berdasarkan kebutuhan bisnis Anda:

• onTextureCreate: Callback ini dipicu saat konteks OpenGL internal SDK dibuat.

• onTextureUpdate: Callback ini dipicu setelah setiap bingkai video diunggah ke tekstur OpenGL. Saat pengamat data tekstur OpenGL eksternal didaftarkan, Anda dapat memproses tekstur dalam callback ini dan mengembalikan ID tekstur yang telah diproses. Nilai kembali harus berupa ID tekstur yang valid. Jika tidak ada pemrosesan yang dilakukan, kembalikan parameter textureId.

• onTextureDestroy: Callback ini dipicu saat konteks OpenGL internal SDK dihapus.

Deskripsi metrik

Membatalkan pendaftaran observer untuk data tekstur OpenGL dari aliran video Kamera lokal.

- (void)unregisterLocalVideoTextureObserver:(id<AliRtcTextureDelegate> _Nullable)observer;

Metode ini merupakan pasangan dari registerLocalVideoTextureObserver.

Parameters

Mengambil Snapshot dari sebuah video.

- (int)snapshotVideo:(NSString*_Nullable)userId type:(AliRtcVideoTrack)type;

Parameters

Return value

Mengembalikan 0 jika operasi berhasil. Jika tidak, kode kesalahan akan dikembalikan.

Mengaktifkan sumber input video eksternal.

- (int)setExternalVideoSource:(BOOL)enable sourceType:(AliRtcVideoSource)type renderMode:(AliRtcRenderMode)renderMode;

Parameters

Menyisipkan data video eksternal.

- (int)pushExternalVideoFrame:(AliRtcVideoDataSample *_Nonnull)frame sourceType:(AliRtcVideoSource)type;

Parameter

Nilai Kembali

Mengembalikan 0 jika berhasil. Nilai bukan nol menunjukkan kegagalan.

Memulai aliran langsung bypass.

- (int)startPublishLiveStreamWithURL:(NSString *_Nonnull)streamURL liveTranscoding:(AliRtcLiveTranscodingParam *_Nonnull)trancoding;

Parameter

Nilai kembali

Nilai kembali 0 menunjukkan panggilan berhasil. Nilai bukan nol menunjukkan panggilan gagal.

Memperbarui parameter untuk streaming langsung bypass.

- (int)updatePublishLiveStreamWithURL:(NSString *_Nonnull)streamURL liveTranscoding:(AliRtcLiveTranscodingParam *_Nonnull)trancoding;

Parameters

Return value

Nilai 0 menunjukkan bahwa pemanggilan metode berhasil. Nilai lainnya menunjukkan bahwa pemanggilan metode gagal.

Menghentikan streaming langsung bypass.

- (int)stopPublishLiveStreamWithURL:(NSString *_Nonnull)streamURL;

Parameters

Returns

Nilai kembali 0 menunjukkan bahwa panggilan berhasil. Nilai bukan nol menunjukkan bahwa panggilan gagal.

Mengambil status aliran langsung bypass.

- (AliRtcLiveTranscodingState)GetPublishLiveStreamStateWithURL:(NSString *_Nonnull)streamURL;

Parameter

Nilai kembalian

Mengembalikan status streaming langsung bypass.

Memulai probe kualitas jaringan.

- (int)startLastmileDetect:(AliRtcNetworkQualityProbeConfig *_Nonnull)config;

Parameters

Returns

Mengembalikan nilai 0 jika berhasil, atau nilai bukan nol jika gagal.

Menghentikan probe kualitas jaringan.

- (int)stopLastmileDetect;

Return value

Mengembalikan nilai 0 jika berhasil. Nilai bukan nol menunjukkan kegagalan.

Mengirim pesan Supplemental Enhancement Information (SEI).

- (int)sendMediaExtensionMsg:(NSData *_Nonnull)data repeatCount:(int)repeatCount delay:(int)delay isKeyFrame:(bool)isKeyFrame;

SDK memungkinkan Anda mengirim dan menerima pesan ekstensi media. Metode ini mengirim pesan menggunakan protokol ekstensi SEI. Untuk menerima pesan, Anda dapat mendengarkan callback onMediaExtensionMsgReceived.

Skenario umum meliputi hal-hal berikut:

• Meneruskan timestamp untuk menghitung latensi jaringan end-to-end atau menyinkronkan data dengan layanan lain.

• Meneruskan informasi deskriptif. Anda dapat mengirim hingga 4 KB data. Anda dapat menggunakan JSON atau string biasa untuk kontennya.

Kapan harus dipanggil

Anda dapat memanggil metode ini setelah pengambilan aliran dimulai.

Batasan

Pesan ekstensi media menggunakan kembali saluran data audio dan video. Oleh karena itu, Anda harus mengontrol frekuensi dan panjang pesan kustom. Perhatikan batasan berikut:

• Jumlah maksimum pesan yang dapat dikirim per detik sama dengan nilai frames per second (fps) yang ditetapkan dalam profil. Hal ini karena pesan SEI dilampirkan ke frame video terenkripsi dalam aliran H.264/H.265.

• Untuk menghindari dampak pada kualitas data media, isi pesan dibatasi hingga 4 KB. Ini cocok untuk mentransfer jumlah informasi yang kecil.

• Parameter `repeatCount` dalam fungsi sendMediaExtensionMsg menetapkan redundansi pesan. Jika `repeatCount` lebih besar dari 1, pesan dikirim beberapa kali untuk mencegah kehilangan pesan akibat kehilangan paket jaringan.

• Pengguna lain di saluran menerima beberapa pesan identik. Sisi penerima harus menghapus duplikat tersebut.

• Subscriber di saluran juga menerima pesan kustom selama live streaming bypass.

• Hanya satu pesan ekstensi media yang dapat sedang dalam proses pengiriman pada satu waktu. Jika sendMediaExtensionMsg dipanggil beberapa kali, data dari pemanggilan terbaru akan menimpa data sebelumnya.

Callback terkait

Saat publisher mengirim pesan ekstensi media, subscriber dapat menerimanya dengan mendengarkan callback onMediaExtensionMsgReceived.

Parameter

Nilai kembalian

0 menunjukkan keberhasilan. Nilai lainnya menunjukkan kegagalan.

Mengirimkan pesan ekstensi media menggunakan Supplemental Enhancement Information (SEI).

- (int)sendMediaExtensionMsgEx:(NSData *_Nonnull)data repeatCount:(int)repeatCount delay:(int)delay isKeyFrame:(bool)isKeyFrame payloadType:(int)payloadType;

Kit pengembangan perangkat lunak (SDK) memungkinkan Anda mengirim dan menerima pesan ekstensi media. Metode ini mengirimkan pesan menggunakan protokol ekstensi SEI. Penerima dapat mengambil pesan tersebut dengan mendengarkan callback onMediaExtensionMsgReceived. Jika Anda mengatur `payloadType` ke 5, metode ini berperilaku sama seperti metode `sendMediaExtensionMsg`.

Skenario umum meliputi hal-hal berikut:

• Mengirimkan timestamp untuk menghitung latensi jaringan end-to-end atau untuk menyinkronkan data dengan layanan lain.

• Mengirimkan informasi deskriptif. Anda dapat mengirimkan hingga 4 KB data, yang berguna untuk transfer data kecil. Gunakan JSON atau string biasa sebagai format data.

Kapan harus dipanggil

Panggil metode ini setelah pengambilan aliran dimulai.

Batasan

Pesan ekstensi media menggunakan kembali saluran data audio dan video. Oleh karena itu, Anda harus mengontrol frekuensi pengiriman dan panjang data pesan kustom. Batasan-batasannya adalah sebagai berikut:

• Laju pesan maksimum adalah `fps` pesan per detik, sebagaimana ditentukan dalam profil. Hal ini karena pesan dikirimkan sebagai Supplemental Enhancement Information (SEI) dalam aliran H.264/H.265, dan informasi ekstensi ini hanya dapat disambungkan saat frame video dikodekan.

• Untuk menghindari dampak pada kualitas transmisi media, ukuran isi pesan kustom dibatasi hingga 4 KB. Hal ini menjadikan pesan kustom cocok untuk mengirimkan jumlah informasi yang kecil.

• Parameter `repeatCount` dalam fungsi `sendMediaExtensionMsg` mengontrol redundansi pesan. Nilai lebih besar dari 1 menyebabkan pesan dikirimkan beberapa kali.

• Untuk memastikan pengiriman pesan meskipun terjadi loss paket jaringan, pengguna lain dalam saluran mungkin menerima pesan yang sama beberapa kali. Anda harus menghapus duplikat tersebut.

• Pelanggan dalam saluran juga menerima pesan kustom selama live streaming bypass.

• Hanya satu pesan ekstensi media yang dapat sedang dalam perjalanan pada satu waktu. Jika Anda memanggil metode ini beberapa kali, data dari pemanggilan terbaru akan menimpa data dari pemanggilan sebelumnya.

Parameter

Nilai yang Dikembalikan

• 0: Pemanggilan berhasil.

• <0: Pemanggilan gagal. Kode kesalahan dikembalikan.

  • ERR_INNER(-1): Terjadi kesalahan internal SDK. Hal ini dapat terjadi jika SDK belum diinisialisasi atau jika metode dipanggil setelah SDK dihapus.

Callback ini dipanggil ketika status koneksi jaringan berubah.

- (void)onConnectionStatusChange:(AliRtcConnectionStatus)status reason:(AliRtcConnectionStatusChangeReason)reason;

Parameters

Panggilan balik ini dipicu ketika terjadi pengecualian pada perangkat lokal. Anda harus menangani panggilan balik ini.

- (void)onLocalDeviceException:(AliRtcLocalDeviceType)deviceType exceptionType:(AliRtcLocalDeviceExceptionType)exceptionType message:(NSString *_Nullable)msg;

Parameter

Callback ini memberi tahu Anda bahwa informasi autentikasi pengguna akan segera kedaluwarsa. Anda harus mengimplementasikan callback ini.

- (void)onAuthInfoWillExpire;

Callback ini menunjukkan bahwa informasi autentikasi pengguna akan kedaluwarsa dalam 30 detik. Dapatkan token baru, lalu perbarui informasi autentikasi dengan salah satu cara berikut:

• Panggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#e6a4495191bmd" id="918ba91977wi6">refreshAuthInfo</a> untuk memperbarui informasi autentikasi.

• Anda dapat memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#449873b819cz2" id="ad8235d30dprb">leaveChannel</a> untuk meninggalkan saluran saat ini, lalu memanggil joinChannel untuk bergabung kembali ke saluran tersebut.

Saat dipicu

SDK memicu callback ini 30 detik sebelum informasi autentikasi pengguna kedaluwarsa. Saat menerima callback ini, Anda harus segera memperbarui informasi autentikasi.

Dipicu ketika pengguna memanggil API yang memerlukan autentikasi dan server melaporkan bahwa informasi autentikasi telah kedaluwarsa.

- (void)onAuthInfoExpired;

Callback ini menunjukkan bahwa informasi autentikasi pengguna telah kedaluwarsa. Untuk tetap berada dalam sesi, hasilkan token baru di server Anda dan perbarui informasi autentikasi sebagai berikut:

• Anda dapat memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#449873b819cz2" id="21390e77a1307">leaveChannel</a> untuk meninggalkan saluran saat ini, lalu panggil joinChannel untuk bergabung kembali ke saluran tersebut.

Pemicu

Callback ini dipicu ketika informasi autentikasi pengguna kedaluwarsa.

Panggilan balik ini melaporkan hasil dari proses bergabung ke saluran dan merupakan alternatif dari blok penyelesaian metode joinChannel. Anda hanya perlu mengimplementasikan salah satu dari keduanya untuk menangani hasil tersebut.

- (void)onJoinChannelResult:(int)result channel:(NSString *_Nonnull)channel elapsed:(int) elapsed;

Pemicu

Panggilan balik ini dipicu setelah Anda memanggil metode joinChannel. Panggilan balik ini menunjukkan apakah Anda berhasil bergabung ke saluran dan mengembalikan informasi mengenai operasi bergabung, termasuk waktu yang berlalu.

Parameter

Panggilan balik ini melaporkan hasil dari keluar dari saluran. Panggilan balik ini dipicu setelah Anda memanggil metode leaveChannel. Anda tidak akan menerima panggilan balik ini jika Anda memanggil `destroy` segera setelah memanggil `leaveChannel`.

- (void)onLeaveChannelResult:(int)result stats:(AliRtcStats)stats;

Parameter

Terjadi ketika pengguna jarak jauh offline.

- (void)onRemoteUserOffLineNotify:(NSString *_Nonnull)uid offlineReason:(AliRtcUserOfflineReason)reason;

SDK memicu callback ini untuk memberi tahu pengguna lokal bahwa pengguna jarak jauh telah offline.

Pemicu

• Pengguna jarak jauh meninggalkan saluran.

• Callback ini dipicu ketika streamer jarak jauh memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#892915dd4edcy" id="78b1952ad5lwp">setClientRole</a> untuk beralih ke peran penonton (AliRtcClientRolelive).

• Streamer jarak jauh dianggap offline jika tidak ada data yang diterima darinya dalam periode waktu yang lama.

Parameter

Pemicu balik yang dipicu ketika pengguna jarak jauh online.

- (void)onRemoteUserOnLineNotify:(NSString *_Nonnull)uid elapsed:(int)elapsed;

Pemicu balik ini memberi tahu klien lokal ketika pengguna jarak jauh bergabung ke saluran.

Pemicu

• Pengguna jarak jauh berhasil bergabung ke saluran.

• Ketika Anda bergabung ke saluran, pemicu balik ini juga dipicu untuk setiap pengguna yang sudah berada di saluran. Hal ini memungkinkan Anda mengidentifikasi pengguna yang sudah ada.

Parameter

Pemicu balik ini dipicu ketika ketersediaan aliran pengguna jarak jauh berubah.

- (void)onRemoteTrackAvailableNotify:(NSString *_Nonnull)uid audioTrack:(AliRtcAudioTrack)audioTrack videoTrack:(AliRtcVideoTrack)videoTrack;

Pemicu balik ini dipicu ketika status penerbitan aliran pengguna jarak jauh berubah. Anda dapat menggunakan pemicu balik ini untuk menerima notifikasi secara real time jika pengguna jarak jauh sedang menerbitkan aliran audio atau video. Anda kemudian dapat menampilkan atau menyembunyikan audio dan video pengguna jarak jauh tersebut di antarmuka.

Pemicu

Pemicu balik ini dipicu dalam skenario berikut:

• Pengguna jarak jauh mulai menerbitkan aliran (audio atau video).

• Pengguna jarak jauh menghentikan penerbitan semua aliran (audio dan video).

• Dalam mode interaktif, pengguna jarak jauh memanggil setClientRole untuk mengganti perannya dari penonton menjadi Streamer dan mulai menerbitkan aliran.

Sebagai contoh, ketika pengguna jarak jauh menonaktifkan pengambilan aliran video, pemicu balik ini tidak dipicu.

• Jika pengguna jarak jauh mulai menerbitkan aliran Kamera (perubahan status: tidak ada video → hanya Kamera), pemicu balik mengembalikan AliRtcVideoTrackCamera.

• Jika pengguna tersebut kemudian juga menerbitkan aliran berbagi layar (perubahan status: hanya Kamera → keduanya), pemicu balik mengembalikan AliRtcVideoTrackBoth.

• Jika pengguna menghentikan penerbitan aliran Kamera (perubahan status: keduanya → hanya layar), pemicu balik mengembalikan AliRtcVideoTrackScreen.

• Jika pengguna kemudian menghentikan penerbitan aliran berbagi layar (perubahan status: hanya layar → tidak ada video), pemicu balik mengembalikan AliRtcVideoTrackNo.

Deskripsi parameter

Panggilan balik ini dipanggil ketika pengguna dipaksa meninggalkan saluran.

- (void)onBye:(int)code;

Panggilan balik ini dipicu ketika pengguna terputus karena alasan apa pun atau ketika rapat berakhir. Anda dapat menggunakan parameter panggilan balik code untuk menentukan alasan pemutusan koneksi dan menanganinya sesuai kebutuhan.

Trigger Conditions

• Server memutuskan koneksi pengguna.

• Rapat berakhir dan server menghapus saluran.

• Terjadi pemutusan pasif. Klien harus mencoba melanjutkan sesi atau menyambung ulang.

Parameters

Callback untuk perubahan pengambilan aliran audio.

- (void)onAudioPublishStateChanged:(AliRtcPublishState)oldState newState:(AliRtcPublishState)newState elapseSinceLastState:(NSInteger)elapseSinceLastState channel:(NSString *_Nonnull)channel;

Callback ini memantau perubahan status pengambilan aliran audio pengguna lokal.

Kondisi Pemicu

Misalnya, ketika status pengambilan aliran audio pengguna berubah:

• Hentikan pengambilan aliran.

• Anda dapat memanggil <a baseurl="t2309850_v9_0_0.xdita" data-node="4087266" data-root="16090" data-tag="xref" href="#892915dd4edcy" id="81771ef0798we">setClientRole</a> untuk beralih ke peran penonton.

Deskripsi parameter

Panggilan balik ini dipicu ketika status langganan aliran audio pengguna jarak jauh berubah.

- (void)onAudioSubscribeStateChanged:(NSString *_Nonnull)uid oldState:(AliRtcSubscribeState)oldState newState:(AliRtcSubscribeState)newState elapseSinceLastState:(NSInteger)elapseSinceLastState channel:(NSString *_Nonnull)channel;

Panggilan balik ini menyediakan status langganan baru dan waktu yang berlalu sejak status sebelumnya hingga status saat ini.

Parameters

Terjadi ketika pengguna membisukan atau mengaktifkan kembali audio mereka.

- (void)onUserAudioMuted:(NSString *_Nonnull)uid audioMuted:(BOOL)isMute;

Parameters

Panggilan balik ini dipicu ketika audio pengguna terganggu. Hal ini biasanya terjadi ketika sesi audio didahului oleh proses lain, seperti panggilan telepon.

- (void)onUserAudioInterruptedBegin:(NSString *_Nonnull)uid;

Parameters

Pemicu balik ini dipicu ketika gangguan audio pengguna berakhir. Pemicu balik ini berkorespondensi dengan onUserAudioInterruptedBegin.

- (void)onUserAudioInterruptedEnded:(NSString *_Nonnull)uid;

Parameters

Terjadi ketika status pengambilan aliran video berubah.

- (void)onVideoPublishStateChanged:(AliRtcPublishState)oldState newState:(AliRtcPublishState)newState elapseSinceLastState:(NSInteger)elapseSinceLastState channel:(NSString *_Nonnull)channel;

Panggilan balik ini dipicu ketika status pengambilan aliran video pengguna lokal berubah.

Parameter

Memberikan laporan perubahan pada status langganan aliran video Kamera.

- (void)onVideoSubscribeStateChanged:(NSString *_Nonnull)uid oldState:(AliRtcSubscribeState)oldState newState:(AliRtcSubscribeState)newState elapseSinceLastState:(NSInteger)elapseSinceLastState channel:(NSString *_Nonnull)channel;

Callback ini memberi tahu pengguna lokal ketika status langganan aliran video Kamera pengguna jarak jauh berubah. Callback ini menyediakan status langganan baru dan waktu yang telah berlalu sejak perubahan status terakhir.

Callback terkait

Aliran video dapat berupa aliran Kamera atau aliran berbagi layar. Callback ini hanya melaporkan perubahan status langganan untuk aliran Kamera. Untuk perubahan yang terkait dengan aliran berbagi layar, gunakan callback onScreenShareSubscribeStateChanged.

Parameter

Terjadi ketika pengguna membisukan atau membatalkan pembisuan aliran video mereka.

- (void)onUserVideoMuted:(NSString *_Nonnull)uid videoMuted:(BOOL)isMute;

Parameters

Notifikasi dikirimkan ketika pengambilan video lokal dinonaktifkan atau diaktifkan kembali.

- (void)onUserVideoEnabled:(NSString *_Nullable)uid videoEnabled:(BOOL)isEnable;

Parameters

Event ini terjadi ketika aplikasi pengguna jarak jauh masuk ke latar belakang.

- (void)onUserWillResignActive:(NSString *_Nonnull)uid;

Parameters

Pemicu balik ini diaktifkan ketika aplikasi pengguna jarak jauh kembali ke latar depan.

- (void)onUserWillBecomeActive:(NSString *_Nonnull)uid;

Parameters

Panggilan balik ini melaporkan data waktu nyata. Pemicu dijalankan setiap 2 detik.

- (void)onRtcStats:(AliRtcStats)stats;

Parameters

Memberikan statistik video lokal setiap 2 detik.

- (void)onRtcLocalVideoStats:(AliRtcLocalVideoStats *_Nonnull)localVideoStats;

Parameters

Pemicu balik ini dipanggil setiap 2 detik untuk melaporkan statistik kinerja video jarak jauh.

- (void)onRtcRemoteVideoStats:(AliRtcRemoteVideoStats *_Nonnull)remoteVideoStats;

Parameters