Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
SendAlexaOfferToMaster
catatan
Sebelum menggunakan API ini, Anda harus memanggil GetSignalingChannelEndpoint API untuk mendapatkan titik akhir. Anda kemudian menentukan titik akhir dan wilayah dalam permintaan SendAlexaOfferToMaster API Anda.
API ini memungkinkan Anda untuk menghubungkan perangkat berkemampuan WebRTC dengan perangkat tampilan Alexa. Ketika dipanggil, ia mengirimkan penawaran Alexa Session Description Protocol (SDP) ke master peer. Penawaran dikirimkan segera setelah master terhubung ke saluran pensinyalan yang ditentukan. API ini mengembalikan jawaban SDP dari master yang terhubung. Jika master tidak terhubung ke saluran pensinyalan, permintaan pengiriman ulang dilakukan hingga pesan kedaluwarsa.
Minta Sintaks
POST /v1/send-alexa-offer-to-master HTTP/1.1
Content-type: application/json
{
"ChannelARN": "string",
"MessagePayload": "string",
"SenderClientId": "string"
}Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- ChannelARN
-
Nama Sumber Daya Amazon (ARN) dari saluran pensinyalan tempat Alexa dan rekan master berkomunikasi.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.
Pola:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+Wajib: Ya
- MessagePayload
-
SDP yang dikodekan base64 menawarkan konten.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 10000.
Pola:
[a-zA-Z0-9+/=]+Wajib: Ya
- SenderClientId
-
Pengidentifikasi unik untuk klien pengirim.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.
Pola:
[a-zA-Z0-9_.-]+Diperlukan: Ya
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"Answer": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- Answer
-
Konten jawaban SDP yang dikodekan base64.
Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 10000.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- ClientLimitExceededException
-
Permintaan Anda dibatasi karena Anda telah melampaui batas panggilan klien yang diizinkan. Coba buat panggilan nanti.
Kode Status HTTP: 400
- InvalidArgumentException
-
Nilai untuk parameter input ini tidak valid.
Kode Status HTTP: 400
- NotAuthorizedException
-
Penelepon tidak berwenang untuk melakukan operasi ini.
Kode Status HTTP: 401
- ResourceNotFoundException
-
Sumber daya yang ditentukan tidak ditemukan.
Kode Status HTTP: 404
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:
