Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Creating meetings using the Amazon Chime SDK

Focus mode
Creating meetings using the Amazon Chime SDK - Amazon Chime SDK

The following procedure demonstrates how to create a meeting with audio and video for your server and client applications. Before you begin, you must integrate your client application with an Amazon Chime SDK client library. For more information, refer to Learn about the Amazon Chime SDK client libraries.

To create a meeting with audio and video
  1. Complete the following steps from your server application:

    1. Use the CreateMeeting API action in the Amazon Chime SDK API Reference to create a meeting. Specify an AWS Region using the MediaRegion parameter. For more information about choosing a meeting Region, refer to Meeting Regions.

    2. Add attendees to the meeting using the CreateAttendee API action or the BatchCreateAttendee API action. Securely transfer the meeting and attendee from your server application to the client authorized as the respective attendee. For more information about meetings and attendees, refer to Meeting and Attendee in the Amazon Chime SDK API Reference.

  2. Complete the following steps from your client application:

    1. Use an Amazon Chime SDK client library to construct a MeetingSessionConfiguration object. Use the meeting and attendee information from the previous steps.

    2. Implement the AudioVideoObserver interface.

    3. Create a MeetingSession using the MeetingSessionConfiguration.

    4. Use the AudioVideoFacade from the MeetingSession to control real-time media.

      1. Register an instance of the AudioVideoObserver interface. This lets you receive events when the meeting state changes.

      2. Select initial devices for the audio input, audio output, and video input.

      3. Start the audiovisual session.

      4. Start local video capture when the user wants to share video.

      5. To show video tiles, manage video tile events, and bind the tiles to video surfaces in the client application.

      6. Manage other user interactions such as muting and unmuting, or starting and stopping local video capture.

      7. To leave the meeting, stop the audiovisual session.

    5. (Optional) Use the AudioVideoFacade from the MeetingSession to share media content, such as screen captures, with other clients.

      1. Start the screen share session. The content joins the meeting as an additional attendee.

      2. To view the shared content, manage video tile events and bind the tiles to surfaces in the client application.

      3. Manage other interactions, such as pausing, restarting, or stopping the content share.

Meetings end when you run the DeleteMeeting API action. Also, meetings end automatically when:

  • The meeting time exceeds 24 hours.

  • The meeting is a replica meeting and the primary meeting ends.

  • In a non-replica meeting, no attendees connected for five continuous minutes.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.