Creating meetings - Amazon Chime SDK

Creating meetings

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 Integrating with a client library.

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.