Class: AWS.ChimeSDKMeetings
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.ChimeSDKMeetings
- Identifier:
- chimesdkmeetings
- API Version:
- 2021-07-15
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
The Amazon Chime SDK meetings APIs in this section allow software developers to create Amazon Chime SDK meetings, set the Amazon Web Services Regions for meetings, create and manage users, and send and receive meeting notifications. For more information about the meeting APIs, see Amazon Chime SDK meetings.
Sending a Request Using ChimeSDKMeetings
var chimesdkmeetings = new AWS.ChimeSDKMeetings();
chimesdkmeetings.batchCreateAttendee(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the ChimeSDKMeetings object uses this specific API, you can
construct the object by passing the apiVersion
option to the constructor:
var chimesdkmeetings = new AWS.ChimeSDKMeetings({apiVersion: '2021-07-15'});
You can also set the API version globally in AWS.config.apiVersions
using
the chimesdkmeetings service identifier:
AWS.config.apiVersions = {
chimesdkmeetings: '2021-07-15',
// other service API versions
};
var chimesdkmeetings = new AWS.ChimeSDKMeetings();
Constructor Summary collapse
-
new AWS.ChimeSDKMeetings(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
batchCreateAttendee(params = {}, callback) ⇒ AWS.Request
Creates up to 100 attendees for an active Amazon Chime SDK meeting.
-
batchUpdateAttendeeCapabilitiesExcept(params = {}, callback) ⇒ AWS.Request
Updates
AttendeeCapabilities
except the capabilities listed in anExcludedAttendeeIds
table.Note: You use the capabilities with a set of values that control what the capabilities can do, such asSendReceive
data.- createAttendee(params = {}, callback) ⇒ AWS.Request
Creates a new attendee for an active Amazon Chime SDK meeting.
- createMeeting(params = {}, callback) ⇒ AWS.Request
Creates a new Amazon Chime SDK meeting in the specified media Region with no initial attendees.
- createMeetingWithAttendees(params = {}, callback) ⇒ AWS.Request
Creates a new Amazon Chime SDK meeting in the specified media Region, with attendees.
- deleteAttendee(params = {}, callback) ⇒ AWS.Request
Deletes an attendee from the specified Amazon Chime SDK meeting and deletes their
JoinToken
.- deleteMeeting(params = {}, callback) ⇒ AWS.Request
Deletes the specified Amazon Chime SDK meeting.
- getAttendee(params = {}, callback) ⇒ AWS.Request
Gets the Amazon Chime SDK attendee details for a specified meeting ID and attendee ID.
- getMeeting(params = {}, callback) ⇒ AWS.Request
Gets the Amazon Chime SDK meeting details for the specified meeting ID.
- listAttendees(params = {}, callback) ⇒ AWS.Request
Lists the attendees for the specified Amazon Chime SDK meeting.
- listTagsForResource(params = {}, callback) ⇒ AWS.Request
Returns a list of the tags available for the specified resource.
.
- startMeetingTranscription(params = {}, callback) ⇒ AWS.Request
Starts transcription for the specified
meetingId
.- stopMeetingTranscription(params = {}, callback) ⇒ AWS.Request
Stops transcription for the specified
meetingId
.- tagResource(params = {}, callback) ⇒ AWS.Request
The resource that supports tags.
.
- untagResource(params = {}, callback) ⇒ AWS.Request
Removes the specified tags from the specified resources.
- updateAttendeeCapabilities(params = {}, callback) ⇒ AWS.Request
The capabilities that you want to update.
Note: You use the capabilities with a set of values that control what the capabilities can do, such asSendReceive
data.Methods inherited from AWS.Service
makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService
Constructor Details
new AWS.ChimeSDKMeetings(options = {}) ⇒ Object
Constructs a service object. This object has one method for each API operation.
Property Details
Method Details
batchCreateAttendee(params = {}, callback) ⇒ AWS.Request
Creates up to 100 attendees 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.
batchUpdateAttendeeCapabilitiesExcept(params = {}, callback) ⇒ AWS.Request
Updates
AttendeeCapabilities
except the capabilities listed in anExcludedAttendeeIds
table.Note: You use the capabilities with a set of values that control what the capabilities can do, such asSendReceive
data. For more information about those values, see .When using capabilities, be aware of these corner cases:
-
If you specify
MeetingFeatures:Video:MaxResolution:None
when you create a meeting, all API requests that includeSendReceive
,Send
, orReceive
forAttendeeCapabilities:Video
will be rejected withValidationError 400
. -
If you specify
MeetingFeatures:Content:MaxResolution:None
when you create a meeting, all API requests that includeSendReceive
,Send
, orReceive
forAttendeeCapabilities:Content
will be rejected withValidationError 400
. -
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 attendees can receive those streams, but only after media renegotiation between the client and the Amazon Chime back-end server.
createAttendee(params = {}, callback) ⇒ AWS.Request
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.
createMeeting(params = {}, callback) ⇒ AWS.Request
Creates a new Amazon Chime SDK meeting in the specified media Region with no initial attendees. For more information about specifying media Regions, see Amazon Chime SDK Media Regions in the Amazon Chime Developer Guide. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
createMeetingWithAttendees(params = {}, callback) ⇒ AWS.Request
Creates a new Amazon Chime SDK meeting in the specified media Region, with attendees. For more information about specifying media Regions, see Amazon Chime SDK Media Regions in the Amazon Chime Developer Guide. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
deleteAttendee(params = {}, callback) ⇒ AWS.Request
Deletes an attendee from the specified Amazon Chime SDK meeting and deletes their
JoinToken
. Attendees are automatically deleted when a Amazon Chime SDK meeting is deleted. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.deleteMeeting(params = {}, callback) ⇒ AWS.Request
Deletes the specified Amazon Chime SDK meeting. The operation deletes all attendees, disconnects all clients, and prevents new clients from joining the meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
getAttendee(params = {}, callback) ⇒ AWS.Request
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.
getMeeting(params = {}, callback) ⇒ AWS.Request
Gets the Amazon Chime SDK meeting details for the specified meeting ID. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
listAttendees(params = {}, callback) ⇒ AWS.Request
Lists the attendees for the specified Amazon Chime SDK meeting. For more information about the Amazon Chime SDK, see Using the Amazon Chime SDK in the Amazon Chime Developer Guide.
listTagsForResource(params = {}, callback) ⇒ AWS.Request
Returns a list of the tags available for the specified resource.
startMeetingTranscription(params = {}, callback) ⇒ AWS.Request
Starts transcription for the specified
meetingId
. For more information, refer to Using Amazon Chime SDK live transcription in the Amazon Chime SDK Developer Guide.If you specify an invalid configuration, a
TranscriptFailed
event will be sent with the contents of theBadRequestException
generated by Amazon Transcribe. For more information on each parameter and which combinations are valid, refer to the StartStreamTranscription API in the Amazon Transcribe Developer Guide.Note: By default, Amazon Transcribe may use and store audio content processed by the service to develop and improve Amazon Web Services AI/ML services as further described in section 50 of the Amazon Web Services Service Terms. Using Amazon Transcribe may be subject to federal and state laws or regulations regarding the recording or interception of electronic communications. It is your and your end users’ responsibility to comply with all applicable laws regarding the recording, including properly notifying all participants in a recorded session or communication that the session or communication is being recorded, and obtaining all necessary consents. You can opt out from Amazon Web Services using audio content to develop and improve AWS AI/ML services by configuring an AI services opt out policy using Amazon Web Services Organizations.stopMeetingTranscription(params = {}, callback) ⇒ AWS.Request
Stops transcription for the specified
meetingId
. For more information, refer to Using Amazon Chime SDK live transcription in the Amazon Chime SDK Developer Guide.By default, Amazon Transcribe may use and store audio content processed by the service to develop and improve Amazon Web Services AI/ML services as further described in section 50 of the Amazon Web Services Service Terms. Using Amazon Transcribe may be subject to federal and state laws or regulations regarding the recording or interception of electronic communications. It is your and your end users’ responsibility to comply with all applicable laws regarding the recording, including properly notifying all participants in a recorded session or communication that the session or communication is being recorded, and obtaining all necessary consents. You can opt out from Amazon Web Services using audio content to develop and improve Amazon Web Services AI/ML services by configuring an AI services opt out policy using Amazon Web Services Organizations.
untagResource(params = {}, callback) ⇒ AWS.Request
Removes the specified tags from the specified resources. When you specify a tag key, the action removes both that key and its associated value. The operation succeeds even if you attempt to remove tags from a resource that were already removed. Note the following:
-
To remove tags from a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for removing tags. For more information, see the documentation for the service whose resource you want to untag.
-
You can only tag resources that are located in the specified Amazon Web Services Region for the calling Amazon Web Services account.
Minimum permissions
In addition to the
tag:UntagResources
permission required by this operation, you must also have the remove tags permission defined by the service that created the resource. For example, to remove the tags from an Amazon EC2 instance using theUntagResources
operation, you must have both of the following permissions:tag:UntagResource
ChimeSDKMeetings:DeleteTags
updateAttendeeCapabilities(params = {}, callback) ⇒ AWS.Request
The capabilities that you want to update.
Note: You use the capabilities with a set of values that control what the capabilities can do, such asSendReceive
data. For more information about those values, see .When using capabilities, be aware of these corner cases:
-
If you specify
MeetingFeatures:Video:MaxResolution:None
when you create a meeting, all API requests that includeSendReceive
,Send
, orReceive
forAttendeeCapabilities:Video
will be rejected withValidationError 400
. -
If you specify
MeetingFeatures:Content:MaxResolution:None
when you create a meeting, all API requests that includeSendReceive
,Send
, orReceive
forAttendeeCapabilities:Content
will be rejected withValidationError 400
. -
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 attendees can receive those streams, but only after media renegotiation between the client and the Amazon Chime back-end server.
- createAttendee(params = {}, callback) ⇒ AWS.Request