ModifyChimeMeetingAttendee （静音和取消静音音频）

聚焦模式

ModifyChimeMeetingAttendee （静音和取消静音音频） - Amazon Chime SDK

允许 SIP 媒体应用程序通过提供 Amazon Chime SDK 会议 ID 和与会者列表修改电话与会者的状态。

注意

此操作目前支持对电话与会者进行静音和取消静音操作。此外，用户必须使用 JoinChimeMeeting 操作加入会议。可以在 participantTag=“LEG-B” 上或对应的 CallId 上执行此操作。

此操作仅适用于从 SIP 媒体应用程序加入会议的 CallLeg "+ 13605550122 "、LEG-B 或从 SIP 媒体应用程序加入会议的分支。


{
"SchemaVersion": "1.0",
  "Actions": [
    {
      "Type" : "ModifyChimeMeetingAttendees",
      "Parameters" : {
        "Operation": "Mute",
        "MeetingId": "meeting-id",
        "CallId": "call-id",
        "ParticipantTag": LEG-B",
        "AttendeeList": ["attendee-id-1", "attendee-id-2"]
      }
    }
  ]
}

Operation

描述 — 要对与会者列表执行的操作

允许的值 — 静音、取消静音

必填 — 是

默认值 – 无

MeetingId

描述 — 与会者所属会议的 ID

允许的值 — 有效的会议 ID 设置静音或取消静音的人员也必须属于会议。

必填 — 是

默认值 – 无

CallId

描述 — 与会者所属会议的 ID

允许的值 — 有效的调用 ID。

必填 — 否

默认值 – 无

ParticipantTag

描述 — 分配给与会者的标签。

允许的值 — 有效的标签。

必填 — 否

默认值 – 无

AttendeeList

描述- IDs 要静音或取消静音的与会者列表

允许的值-有效与会者列表 IDs

必填 — 是

默认值 — 无，最大值 100

执行此操作后，音频服务始终调用 ACTION_SUCCESSFUL 或 ACTION_FAILED 调用事件类型的 AWS Lambda 函数。以下示例代码显示了典型的 ACTION_SUCCESSFUL 调用事件。


{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_SUCCESSFUL",
    "ActionData": {
        "Type" : "ModifyChimeMeetingAttendees",
        "Parameters" : {
            "Operation": "Mute",
            "MeetingId": "meeting-id",
            "CallId": "call-id",
            "ParticipantTag": "LEG-B",
            "AttendeeList": ["attendee-id-1", "attendee-id-2"]
        }
    }
    "CallDetails": {
        ...
    }
}

错误处理

如果指令参数无效或 API 出现故障，SIP 媒体应用程序会调用带有特定于失败指令或 API 的错误消息的 AWS Lambda 函数。

错误	消息	Reason
`InvalidActionParameter`	`ModifyChimeMeetingAttendees Operation` 参数值无效	`Operation` 值必须为“静音”或“取消静音”。
	会议 ID 参数值无效。	会议 ID 为空。
	与会者列表参数值无效。	与会者 ID 列表为空，或者超过最大值 100。
	对调用的操作无效。	调用没有桥接。
	调用未连接到 Chime Meeting。	与会者未连接到 Chime Meeting。
	一位或多位与会者并不是此会议的一部分。所有与会者必须是会议的一部分。	与会者无权修改会议中的与会者。
`SystemException`	运行操作时出现系统错误。	运行操作时出现系统错误。

以下示例代码显示了典型失败事件。


{
    "SchemaVersion": "1.0",
    "Sequence": INTEGER,
    "InvocationEventType": "ACTION_FAILED",
    "ActionData": {
        "Type" : "ModifyChimeMeetingAttendees",
        "Parameters" : {
            "Operation": "Mute",
            "MeetingId": "meeting-id",
            "CallId": "call-id",
            "ParticipantTag": "LEG-B",
            "AttendeeList": ["attendee-id-1", "attendee-id-2"]
        },
        "ErrorType": "",
        "ErrorMessage": "",
        "ErrorList": []
    }
    "CallDetails": {
        ...
    }
}

参见以下方面的工作示例 GitHub：