Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Creates a new attendee for an active Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
Synopsis
- data CreateAttendee = CreateAttendee' {}
- newCreateAttendee :: Text -> Text -> CreateAttendee
- createAttendee_capabilities :: Lens' CreateAttendee (Maybe AttendeeCapabilities)
- createAttendee_meetingId :: Lens' CreateAttendee Text
- createAttendee_externalUserId :: Lens' CreateAttendee Text
- data CreateAttendeeResponse = CreateAttendeeResponse' {
- attendee :: Maybe Attendee
- httpStatus :: Int
- newCreateAttendeeResponse :: Int -> CreateAttendeeResponse
- createAttendeeResponse_attendee :: Lens' CreateAttendeeResponse (Maybe Attendee)
- createAttendeeResponse_httpStatus :: Lens' CreateAttendeeResponse Int
Creating a Request
data CreateAttendee Source #
See: newCreateAttendee
smart constructor.
CreateAttendee' | |
|
Instances
Create a value of CreateAttendee
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
CreateAttendee
, createAttendee_capabilities
- The capabilities (audio
, video
, or content
) that you want to grant
an attendee. If you don't specify capabilities, all users have send and
receive capabilities on all media channels by default.
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.
CreateAttendee
, createAttendee_meetingId
- The unique ID of the meeting.
CreateAttendee
, createAttendee_externalUserId
- The Amazon Chime SDK external user ID. An idempotency token. Links the
attendee to an identity managed by a builder application.
Request Lenses
createAttendee_capabilities :: Lens' CreateAttendee (Maybe AttendeeCapabilities) Source #
The capabilities (audio
, video
, or content
) that you want to grant
an attendee. If you don't specify capabilities, all users have send and
receive capabilities on all media channels by default.
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.
createAttendee_meetingId :: Lens' CreateAttendee Text Source #
The unique ID of the meeting.
createAttendee_externalUserId :: Lens' CreateAttendee Text Source #
The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
Destructuring the Response
data CreateAttendeeResponse Source #
See: newCreateAttendeeResponse
smart constructor.
CreateAttendeeResponse' | |
|
Instances
newCreateAttendeeResponse Source #
Create a value of CreateAttendeeResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:attendee:CreateAttendeeResponse'
, createAttendeeResponse_attendee
- The attendee information, including attendee ID and join token.
$sel:httpStatus:CreateAttendeeResponse'
, createAttendeeResponse_httpStatus
- The response's http status code.
Response Lenses
createAttendeeResponse_attendee :: Lens' CreateAttendeeResponse (Maybe Attendee) Source #
The attendee information, including attendee ID and join token.
createAttendeeResponse_httpStatus :: Lens' CreateAttendeeResponse Int Source #
The response's http status code.