Creating Meetings with the Amazon Chime SDK - Amazon Chime

Creating Meetings with the 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, see 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 API Reference to create a meeting. Optionally, specify an AWS Region using the MediaRegion parameter.

    2. Add attendees to the meeting using either the CreateAttendee API action or the BatchCreateAttendee API action.

  2. 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, see Meeting and Attendee in the Amazon Chime API Reference.

  3. 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) Share the screen and view the screen share from other clients using ScreenShareFacade and ScreenShareViewingFacade.

      1. Start the screen share session.

      2. Start the screen share viewing session.

      3. When a client wants to share a screen, start the screen share.

      4. When a client wants to view the screen share, start the screen share viewer using an applicable render surface.

The meetings end when you run the DeleteMeeting API action. A meeting automatically ends after a period of inactivity, such as the following:

  • No audio connections are present in the meeting for more than five minutes.

  • Fewer than two audio connections are present in the meeting for more than 30 minutes.

  • Screen share viewer connections are inactive for more than 30 minutes.

  • The meeting time exceeds 24 hours.