Kirim Pesan Grup Real-Time melalui SendLiveMessageGroup - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Mengirim Paket ke kelompok.

Deskripsi operasi

Before you call this operation, you must call to create an interactive messaging group. You can send messages to a group only if the group is active, which means that one or more users have joined the group. Offline messages are not supported. If you fail to send a message, check whether there are users in the group. If you want to send an offline message, we recommend that you store the message locally and send it after users come online.

QPS limits

You can call this operation up to 50 times per second per account. Requests that exceed this limit are dropped and you may experience service interruptions. We recommend that you consider this limit when calling this operation.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

live:SendLiveMessageGroup

none

*Rtc

acs:live::{#accountId}:rtc/{#AppId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
AppId	string	Yes	ID aplikasi pesan interaktif yang menerima Paket.	demo
GroupId	string	Yes	ID kelompok yang menerima Paket Catatan Pastikan GroupId yang ditentukan tersedia. Jika tidak, error ResourceNotExist akan dikembalikan.	grouptest
SenderId	string	Yes	ID pengguna yang mengirim Paket. ID dapat memiliki panjang hingga 64 byte dan dapat berisi huruf serta angka.	uid1
SenderMetaInfo	string	No	Informasi tambahan tentang pengguna yang mengirim Paket. Nilai dapat memiliki panjang hingga 512 byte.	uid1meta1
Body	string	No	Isi Paket. Panjang maksimum 15 KB.	hello,group
MsgType	integer	No	Tipe Paket. Jumlah total tipe Paket yang dikirim dalam satu kelompok tidak boleh melebihi 30.	1
MsgTid	string	No	Identifikasi unik Paket. Parameter ini digunakan untuk menghapus Paket. ID hanya boleh berisi huruf dan angka serta dapat memiliki panjang hingga 64 byte.	169830****
StaticsIncrease	integer	No	Kontribusi Paket terhadap peningkatan jumlah Paket dari tipe ini. Nilai default: 1.	1
Weight	integer	No	Bobot Paket. Nilai default: 1. Untuk Paket berprioritas rendah seperti suka, atur Bobot ke 1. Untuk Paket teks reguler seperti komentar bullet, atur Bobot ke 5. Untuk Paket berprioritas tinggi seperti amplop merah dan hadiah, atur Bobot ke 1000000.	1
NoStorage	boolean	No	Apakah akan menonaktifkan penyimpanan Paket. Nilai valid: true dan false. Nilai default: false, yang menunjukkan bahwa Paket disimpan selama periode validitas 30 hari. Anda dapat mencari Paket di tanggapan operasi ListLiveMessageGroupMessages. Untuk melewati penyimpanan Paket, atur parameter ini ke true.	false
NoCache	boolean	No	Apakah akan menonaktifkan caching Paket dalam daftar Paket terbaru di kelompok. Nilai valid: true dan false. Nilai default: false, yang menunjukkan bahwa Paket di-cache.	false
DataCenter	string	No	Pusat data lokal, yang harus sama dengan Pusat data lokal yang ditentukan di CreateLiveMessageApp. Nilai valid: cn-shanghai: Shanghai ap-southeast-1: Singapura.	cn-shanghai

Elemen respons

Element	Type	Description	Example
	object	The returned results.
RequestId	string	The ID of the request.	E4C1245F-597B-1BD1-B9BB-9D220E99****
MsgTid	string	The unique identifier of the message, which can be used to delete the message. The ID can contain only letters and digits and can be up to 64 bytes in length.	169830****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "E4C1245F-597B-1BD1-B9BB-9D220E99****",
  "MsgTid": "169830****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InputInvalid	%s.
400	ErrorTooManyMsgTypes	%s.
500	ServerError	%s.
403	NoAuth	%s.
404	ResourceNotExist	%s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.