View a markdown version of this page

Penanganan Kesalahan di IVS Web Broadcast SDK | Streaming Real-Time - Amazon IVS
Kesalahan TahapNegara Kesalahan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Penanganan Kesalahan di IVS Web Broadcast SDK | Streaming Real-Time

Bagian ini adalah ikhtisar kondisi kesalahan, bagaimana SDK siaran Web melaporkannya ke aplikasi, dan apa yang harus dilakukan aplikasi ketika kesalahan tersebut ditemui. Kesalahan dilaporkan oleh SDK kepada pendengar StageEvents.ERROR acara:

stage.on(StageEvents.ERROR, (error: StageError) => {
    // log or handle errors here
    console.log(`${error.code}, ${error.category}, ${error.message}`);
});

Kesalahan Tahap

A StageError dilaporkan ketika SDK mengalami masalah yang tidak dapat dipulihkan dan umumnya memerlukan koneksi ulang and/or jaringan intervensi aplikasi untuk memulihkan.

Setiap laporan StageError memiliki kode (atauStageErrorCode), pesan (string), dan kategori (StageErrorCategory). Masing-masing terkait dengan kategori operasi yang mendasarinya.

Kategori operasi kesalahan ditentukan berdasarkan apakah itu terkait dengan koneksi ke stage (JOIN_ERROR), mengirim media ke stage (PUBLISH_ERROR), atau menerima aliran media masuk dari stage (SUBSCRIBE_ERROR).

Properti kode StageError melaporkan masalah spesifik:

Nama Kode Tindakan yang Direkomendasikan

TOKEN_CACAT

1

Buat token yang valid dan coba lagi membuat instance stage.

TOKEN_KEDALUWARSA

2

Buat token yang belum kedaluwarsa dan coba lagi membuat instance panggung.

BATAS WAKTU

3

Waktu operasi habis. Jika tahap ada dan token valid, kegagalan ini kemungkinan merupakan masalah jaringan. Dalam hal ini, tunggu konektivitas perangkat pulih.

FAILED

4

Kondisi fatal ditemui ketika mencoba operasi. Periksa detail kesalahan.

Jika tahap ada dan token valid, kegagalan ini kemungkinan merupakan masalah jaringan. Dalam hal ini, tunggu konektivitas perangkat pulih.

Untuk sebagian besar kegagalan yang terkait dengan stabilitas jaringan, SDK akan mencoba lagi secara internal untuk jangka waktu hingga 30 detik sebelum mengeluarkan kesalahan GAGAL.

DIBATALKAN

5

Periksa kode aplikasi dan pastikan tidak ada join pem refreshStrategy ang replaceStrategy gilan berulang, yang dapat menyebabkan operasi berulang dimulai dan dibatalkan sebelum selesai.

TAHAP_AT_KAPASITAS

6

Kesalahan ini menunjukkan bahwa panggung atau akun Anda sudah dalam kapasitas. Jika tahap telah mencapai batas pesertanya, coba operasi lagi ketika tahap tidak lagi dalam kapasitas, dengan menyegarkan strategi. Jika akun Anda telah mencapai langganan bersamaan atau kuota penerbit bersamaan, kurangi penggunaan atau minta peningkatan kuota melalui konsol Kuota Layanan AWS.

KETIDAKCOCOKAN KODE

7

Codec tidak didukung oleh panggung. Periksa browser dan platform untuk dukungan codec. Untuk streaming real-time IVS, browser harus mendukung H.264 codec untuk video dan codec Opus untuk audio.

TOKEN_TIDAK_DIIZINKAN

8

Token tidak memiliki izin untuk operasi. Buat ulang token dengan izin yang benar dan coba lagi.

STAGE_DIHAPUS

9

Tidak ada; mencoba bergabung dengan tahap yang dihapus memicu kesalahan ini.

PARTISIPAN_TERPUTUS

10

Tidak ada; mencoba bergabung dengan token peserta yang terputus memicu kesalahan ini.

StageError Contoh Penanganan

Gunakan StageError kode untuk menentukan apakah kesalahan disebabkan oleh token kedaluwarsa:

stage.on(StageEvents.ERROR, (error: StageError) => {
    if (error.code === StageError.TOKEN_EXPIRED) {
        // recreate the token and stage instance and re-join
    }
});

Kesalahan Jaringan saat Sudah Bergabung

Jika koneksi jaringan perangkat mati, SDK mungkin kehilangan koneksi ke server panggung. Anda mungkin melihat kesalahan di konsol karena SDK tidak dapat lagi menjangkau layanan backend. Posting ke https://broadcast.stats.live-video.net akan gagal.

Jika Anda menerbitkan and/or langganan, Anda akan melihat kesalahan di konsol terkait dengan upaya untuk publish/subscribe melakukannya.

Secara internal SDK akan mencoba terhubung kembali dengan strategi backoff eksponensial.

T indakan: Tunggu konektivitas perangkat pulih.

Negara Kesalahan

Sebaiknya gunakan status ini untuk pencatatan aplikasi dan untuk menampilkan pesan kepada pengguna yang memperingatkan mereka tentang masalah konektivitas ke panggung untuk peserta tertentu.

Publikasikan

SDK melaporkan ERRORED ketika publikasi gagal.

stage.on(StageEvents.STAGE_PARTICIPANT_PUBLISH_STATE_CHANGED, (participantInfo, state) => {
  if (state === StageParticipantPublishState.ERRORED) {
      // Log and/or display message to user
  }
});

Langganan

SDK melaporkan ERRORED ketika langganan gagal. Hal ini dapat terjadi karena kondisi jaringan atau jika suatu tahap berkapasitas untuk pelanggan.

stage.on(StageEvents.STAGE_PARTICIPANT_SUBSCRIBE_STATE_CHANGED, (participantInfo, state) => {
  if (state === StageParticipantSubscribeState.ERRORED) {
    // Log and/or display message to user
  }
});