JoinChimeMeeting

Bergabunglah dengan rapat Amazon Chime SDK dengan memberikan token bergabung kepada peserta. Untuk melakukan ini, Anda membuat panggilan AWS SDK ke CreateMeetingdan CreateAttendeeAPI untuk mendapatkan token dan meneruskannya dalam tindakan. Lihat contoh berikut ini.

catatan

Anda tidak dapat menjalankan tindakan ini pada panggilan yang dijembatani.

{
    "Type": "JoinChimeMeeting",
    "Parameters": {
        "JoinToken": "meeting-attendee-join-token",
        "CallId": "call-id-1",
        "ParticipantTag": "LEG-A",
        "MeetingId": "meeting-id"
    }
}

JoinToken

Deskripsi — Token gabungan yang valid dari peserta rapat Amazon Chime SDK

Nilai yang diizinkan - Token bergabung yang valid

Diperlukan - Ya

Nilai default - Tidak ada

CallId

Deskripsi — CallId peserta dalam CallDetails pemanggilan AWS Lambda fungsi

Nilai yang diizinkan - ID panggilan yang valid

Diperlukan - Tidak

Nilai default - Tidak ada

ParticipantTag

Deskripsi — ParticipantTag salah satu peserta yang terhubung di CallDetails

Nilai yang diizinkan - LEG-A

Diperlukan - Tidak

Nilai default - ParticipantTag dari yang dipanggil callLeg Diabaikan jika Anda menentukan CallId

MeetingId

Deskripsi — ID rapat Amazon Chime SDK valid yang terkait dengan file. JoinToken Jika rapat dibuat menggunakan API di namespace Amazon Chime, ID rapat tidak diperlukan. Jika rapat dibuat menggunakan API di namespace Amazon Chime SDK Meetings, ID rapat diperlukan. Rapat digabungkan menggunakan titik akhir API yang digunakan untuk membuat rapat.

Nilai yang diizinkan - ID rapat yang valid.

Diperlukan - Tidak.

Nilai default - Tidak ada.

Aplikasi media SIP selalu memanggil AWS Lambda fungsi setelah menjalankan tindakan ini. Ia mengembalikan baik jenis acara ACTION_SUCCESSFUL atau ACTION_FAILED pemanggilan. Contoh berikut menunjukkan struktur acara pemanggilan yang sukses.

{
    "SchemaVersion": "1.0",
    "Sequence": 4,
    "InvocationEvent": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1"
            "ParticipantTag": "LEG-A"
        }
    }
    "CallDetails": {
        ...
    }
}

Penanganan kesalahan

Ketika kesalahan validasi terjadi saat menjembatani rapat, aplikasi SIP memanggil AWS Lambda fungsinya dengan salah satu pesan kesalahan yang ditampilkan dalam tabel berikut.

Kesalahan	Pesan	Alasan
InvalidActionParameter	JoinTokennilai parameter tidak valid.	Salah satu parameter tindakan lainnya tidak valid atau hilang.
SystemException	Kesalahan sistem saat menjalankan tindakan.	Jenis lain dari kesalahan sistem terjadi saat menjalankan tindakan.

Contoh berikut menunjukkan peristiwa kegagalan yang khas.

{
    "SchemaVersion": "1.0",
    "Sequence": 3,
    "InvocationEvent": "ACTION_FAILED",
    "ActionData": {
        "Type": "JoinChimeMeeting",
        "Parameters": {
            "JoinToken": "meeting-attendee-join-token",
            "CallId": "call-id-1",
            "ParticipantTag": "LEG-A"
        },
        "Error": "ErrorJoiningMeeting: Error while joining meeting."
    }
    "CallDetails": {
        ...
    }
}

Lihat contoh kerja di GitHub: https://github.com/aws-samples/ amazon-chime-sma-update -call