amazon-chime-sdk / com.amazonaws.services.chime.sdk.meetings.audiovideo / PrimaryMeetingPromotionObserver / onPrimaryMeetingPromotion
onPrimaryMeetingPromotion
open fun onPrimaryMeetingPromotion(status: MeetingSessionStatus): Unit
Upon success/failure of AudioVideoFacade.promoteToPrimaryMeeting the following observer
will return a MeetingSessionStatus that will contain a MeetingSessionStatusCode of the following:
- MeetingSessionStatusCode.OK: The promotion was successful (i.e. session token was valid,
there was room in the Primary meeting, etc.), audio will begin flowing
and the attendee can begin to send data messages, and content/video if the call is not already at limit.
- MeetingSessionStatusCode.AudioAuthenticationRejected: Credentials provided
were invalid when connection attempted to Primary meeting. There may be an issue
with your mechanism which allocates the Primary meeting attendee for the Replica
meeting proxied promotion. This also may indicate that this API was called in a
non-Replica meeting.
- MeetingSessionStatusCode.AudioCallAtCapacity: Credentials provided were correct
but there was no room in the Primary meeting. Promotions to Primary meeting attendee take up a slot, just like
regular Primary meeting attendee connections and are limited by the same mechanisms.
- MeetingSessionStatusCode.AudioServiceUnavailable: Media has not been connected yet so promotion is not yet possible.
- MeetingSessionStatusCode.AudioInternalServerError: Other failure, possibly due to disconnect
or timeout. These failures are likely retryable.
Parameters
status
- : MeetingSessionStatus - Reason for demotion, see notes above