ChimeSDKMeetings / Client / get_attendee
get_attendee#
- ChimeSDKMeetings.Client.get_attendee(**kwargs)#
Gets the Amazon Chime SDK attendee details for a specified meeting ID and attendee ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
See also: AWS API Documentation
Request Syntax
response = client.get_attendee( MeetingId='string', AttendeeId='string' )
- Parameters:
MeetingId (string) –
[REQUIRED]
The Amazon Chime SDK meeting ID.
AttendeeId (string) –
[REQUIRED]
The Amazon Chime SDK attendee ID.
- Return type:
dict
- Returns:
Response Syntax
{ 'Attendee': { 'ExternalUserId': 'string', 'AttendeeId': 'string', 'JoinToken': 'string', 'Capabilities': { 'Audio': 'SendReceive'|'Send'|'Receive'|'None', 'Video': 'SendReceive'|'Send'|'Receive'|'None', 'Content': 'SendReceive'|'Send'|'Receive'|'None' } } }
Response Structure
(dict) –
Attendee (dict) –
The Amazon Chime SDK attendee information.
ExternalUserId (string) –
The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
Pattern:
[-_&@+=,(){}\[\]\/«».:|'"#a-zA-Z0-9À-ÿ\s]*
Values that begin with
aws:
are reserved. You can’t configure a value that uses this prefix. Case insensitive.AttendeeId (string) –
The Amazon Chime SDK attendee ID.
JoinToken (string) –
The join token used by the Amazon Chime SDK attendee.
Capabilities (dict) –
The capabilities assigned to an attendee: audio, video, or content.
Note
You use the capabilities with a set of values that control what the capabilities can do, such as
SendReceive
data. For more information about those values, see .When using capabilities, be aware of these corner cases:
You can’t set
content
capabilities toSendReceive
orReceive
unless you also setvideo
capabilities toSendReceive
orReceive
. If you don’t set thevideo
capability to receive, the response will contain an HTTP 400 Bad Request status code. However, you can set yourvideo
capability to receive and you set yourcontent
capability to not receive.When you change an
audio
capability fromNone
orReceive
toSend
orSendReceive
, and if the attendee left their microphone unmuted, audio will flow from the attendee to the other meeting participants.When you change a
video
orcontent
capability fromNone
orReceive
toSend
orSendReceive
, and if the attendee turned on their video or content streams, remote attendess can receive those streams, but only after media renegotiation between the client and the Amazon Chime back-end server.
Audio (string) –
The audio capability assigned to an attendee.
Video (string) –
The video capability assigned to an attendee.
Content (string) –
The content capability assigned to an attendee.
Exceptions
ChimeSDKMeetings.Client.exceptions.BadRequestException
ChimeSDKMeetings.Client.exceptions.ForbiddenException
ChimeSDKMeetings.Client.exceptions.NotFoundException
ChimeSDKMeetings.Client.exceptions.UnauthorizedException
ChimeSDKMeetings.Client.exceptions.ServiceUnavailableException
ChimeSDKMeetings.Client.exceptions.ServiceFailureException
ChimeSDKMeetings.Client.exceptions.ThrottlingException