회의 기능 선택

CreateMeetingAPI를 호출하면 세션에 참여하는 클라이언트가 사용할 수 있는 기능을 지정할 수 있습니다. 일부 기능 옵션에는 추가 요금이 부과된다는 점에 유의하세요.

세션에 사용할 수 있는 기능은 다음과 같습니다.

• Audio.EchoReduction - 기계 학습 에코 감소

• Video.MaxResolution - 최대 웹캠 비디오 해상도

• Content.MaxResolution - 최대 콘텐츠 공유 해상도

• Attendees.MaxCount - 최대 참석자 수

오디오 사용. EchoReduction

Audio.EchoReduction을 사용하여 사용자의 스피커에서 나오는 소리가 다시 회의로 들어가지 않도록 합니다.

에코 감소는 사용자의 스피커가 회의 오디오의 기본 출력 디바이스가 되는 상황에 적합합니다. 예를 들어, 여러 사용자가 회의실에서 동일한 디바이스로 회의에 참석하거나 개별 원격 참석자가 헤드폰을 착용하지 않은 경우입니다.

에코 감소는 JavaScript 및 React 클라이언트 라이브러리에서 사용할 수 있습니다. 자세한 내용은 의 설명서를 참조하십시오. GitHub 추가 비용이 적용됩니다. 자세한 내용은 Amazon Chime SDK 요금 페이지를 참조하세요.

비디오 사용. MaxResolution

Video.MaxResolution을 사용하여 회의의 최대 웹캠 비디오 해상도를 지정합니다. 이 기능은 다음과 같은 옵션을 제공합니다.

• None: 카메라 비디오가 허용되지 않음

• HD: 고화질 카메라 비디오(1280x720p)

• FHD: full-high-definition 카메라 비디오 (1920x1080)

FHD(1080p) 비디오를 요청하는 경우 고화질 WebRTC 세션이 생성됩니다. 자세한 내용은 Amazon Chime SDK 요금 페이지를 참조하세요.

클라이언트가 지정된 최대값을 초과하여 웹캠 비디오를 전송하려고 하면 서비스에서 비디오를 거부하고 다음 오류를 보냅니다.

Disabled video/content send capability, reason: Video resolution is above limit of current meeting feature selection.

콘텐츠 사용. MaxResolution

Content.MaxResolution을 사용하여 회의의 최대 콘텐츠 공유 해상도를 지정합니다. 이 기능은 다음과 같은 옵션을 제공합니다.

• None: 콘텐츠 공유가 허용되지 않음

• FHD: full-high-definition 콘텐츠 공유 (1920x1080)

• UHD: ultra-high-definition 콘텐츠 공유 (3840x2160)

UHD(4K) 콘텐츠를 요청하는 경우 고화질 WebRTC 세션이 생성됩니다.

클라이언트가 최대 해상도를 초과하여 콘텐츠 공유를 전송하려고 하면 해당 해상도가 지정된 최대값으로 스케일 다운됩니다. 콘텐츠 공유 트랙에 MediaTrackConstraints를 적용하여 규모를 조정할 수 있습니다. 다음 예는 공유 트랙의 규모를 조정하는 방법을 보여줍니다.

const constraint: MediaTrackConstraints = {
    width: { ideal: videoQualitySettings.videoWidth },
    height: { ideal: videoQualitySettings.videoHeight },
    frameRate: { ideal: videoQualitySettings.videoFrameRate },
  };
  this.context.logger.info(
    `Video track (content = ${isContentAttendee}) with constraint: ${JSON.stringify(
      constraint
    )}, trackSettings: ${JSON.stringify(trackSettings)}`
  );
  try {
    await mediaStreamTrack.applyConstraints(constraint);
  } catch (error) {
    this.context.logger.info(
      `Could not apply constraint for video track (content = ${isContentAttendee})`
    );
  }

다음 표에는 예상 콘텐츠 공유 동작이 나와 있습니다.

콘텐츠 기능	콘텐츠 공유 기본 해상도	스케일링	콘텐츠 코딩 해상도
FHD	1280x720	아니요	1280x720
FHD	1920 x 1080	아니요	1920 x 1080
FHD	3840x2160	예	1920 x 1080
UHD	1920 x 1080	아니요	1920 x 1080
UHD	3840x2160	아니요	3840x2160
UHD	4200x2400	예	3780x2160

참석자 사용. MaxCount

Attendee.MaxCount를 사용하여 회의에 허용되는 최대 참석자 수를 지정합니다. 참석자 상한선. MaxCount 세션 유형에 따라 다릅니다. 표준 세션의 경우 최대 250명의 참석자를 선택할 수 있습니다. 고화질 세션의 경우 최대 25명의 참석자 값을 선택해야 합니다.

FHD(1080p) 비디오 또는 UHD(4K) 콘텐츠를 요청하면 세션이 고화질 세션이 됩니다.

고화질 세션에는 참석자 수용 인원 비용이 적용됩니다. 자세한 내용은 Amazon Chime SDK 요금 페이지를 참조하세요.

클라이언트 앱에서 회의 기능 사용

지정된 기능을 갖춘 회의 생성

회의를 만들려면 CreateMeetingAPI를 호출하고 원하는 회의 기능을 지정하십시오. 다음 코드 예제는 모든 기능을 지정하는 방법을 보여줍니다.

// You must migrate to the Amazon Chime SDK Meetings namespace.
const chime = AWS.ChimeSDKMeetings({ region: "eu-central-1" });

// Create meeting 
const meetingInfo = await chime.createMeeting({
    ...
    MeetingFeatures: {
      Audio: {
        EchoReduction: 'AVAILABLE' 
      },
      Video: {
        MaxResolution: 'FHD' 
      },
      Content: {
        MaxResolution: 'UHD' 
      },
      Attendee: {
        MaxCount: 25 
      },
    } 
  }).promise();

클라이언트에서 회의 기능 사용

원하는 기능을 갖춘 회의를 생성한 후에는 MeetingSessionConfiguration 객체를 생성할 때 joinInfo를 전달할 수 있습니다. 회의 기능은 meetingSession 생성 시 웹캠 비디오 해상도 및 비트 전송률과 콘텐츠 공유 해상도 및 비트 전송률을 설정하는 데 사용됩니다.

const configuration = new MeetingSessionConfiguration(this.joinInfo.Meeting, this.joinInfo.Attendee);

this.meetingSession = new DefaultMeetingSession(
    configuration,
    this.meetingLogger,
    this.deviceController,
    new DefaultEventController(configuration, this.meetingLogger, this.eventReporter)
);