翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Chime SDK で使用する会議機能の選択
<a name="js-meeting-features"></a>

[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) API を呼び出すときに、セッションに参加するクライアントが使用できる機能を指定できます。一部の機能オプションには追加料金が発生することに注意してください。

セッションでは次の機能を使用できます。
+ `Audio.EchoReduction` - 機械学習エコーリダクション。
+ `Video.MaxResolution` - ウェブカメラ動画の最大解像度。
+ `Content.MaxResolution` - コンテンツ共有の最大解像度。
+ `Attendees.MaxCount` - 参加者の最大数。

**Topics**
+ [Audio.EchoReduction の使用](#audio-echo-reduction)
+ [Video.MaxResolution を使用する](#video-max-resolution)
+ [Content.MaxResolution を使用する](#js-content-resolution)
+ [Attendees.MaxCount を使用する](#js-max-attendees)
+ [クライアントアプリでの会議機能の使用](#meeting-features-client-app)

## Audio.EchoReduction の使用
<a name="audio-echo-reduction"></a>

ユーザーのスピーカーからの音が会議に逆流するのを防ぐために `Audio.EchoReduction` を使用します。

エコーリダクションは、会議音声の主出力デバイスをユーザーのスピーカーにするような状況に最適です。例えば、複数のユーザーが会議室の同じデバイスから会議に参加する場合や、リモートの参加者がヘッドフォンをつけていない場合などです。

エコーリダクションは JavaScript と React のクライアントライブラリで利用できます。詳細については、[GitHub のドキュメント](https://aws.github.io/amazon-chime-sdk-js/modules/amazonvoice_focus.html#what-is-echo-reduction)を参照してください。追加料金がかかります。詳細については、「[Amazon Chime SDK の料金](https://aws.amazon.com/chime/chime-sdk/pricing/)」を参照してください。

## Video.MaxResolution を使用する
<a name="video-max-resolution"></a>

`Video.MaxResolution` は会議のウェブカメラ動画の最大解像度を指定する場合に使用します。この機能には次のようなオプションがあります。
+ `None`: カメラ動画は使用できません。
+ `HD`: 高解像度カメラ動画 (1280 x 720p)
+ `FHD`: フルハイビジョンカメラ動画 (1920 x 1080)

FHD (1080p) 動画がリクエストされると、高解像度 WebRTC セッションが作成されます。詳細については、「[Amazon Chime SDK の料金](https://aws.amazon.com/chime/chime-sdk/pricing/)」を参照してください。

クライアントがウェブカメラ動画を指定された上限を超えて送信しようとすると、サービスは動画を拒否し、次のエラーを送信します。

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

## Content.MaxResolution を使用する
<a name="js-content-resolution"></a>

`Content.MaxResolution` は会議のコンテンツ共有の最大解像度を指定するために使用します。この機能には次のようなオプションがあります。
+ `None`: コンテンツ共有は許可されません。
+ `FHD`: フルハイビジョンコンテンツ共有 (1920 x 1080)
+ `UHD`: 超高精細コンテンツ共有 (3840 x 2160)

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 | 1920x1080 | いいえ | 1920x1080 | 
| FHD | 3840x2160 | はい | 1920x1080 | 
| UHD | 1920x1080 | いいえ | 1920x1080 | 
| UHD | 3840x2160 | いいえ | 3840x2160 | 
| UHD | 4200 x 2400 | はい | 3780 x 2160 | 

## Attendees.MaxCount を使用する
<a name="js-max-attendees"></a>

`Attendee.MaxCount` は会議に参加できる最大参加者数を指定する場合に使用します。Attendee.MaxCount の上限はセッションタイプによって異なります。標準セッションの場合、最大 250 人の出席者を選択できます。高解像度セッションでは、最大 25 人の参加者を選択する必要があります。**

FHD (1080p) 動画または UHD (4K) コンテンツをリクエストした場合、セッションは高解像度セッションになります。

高解像度セッションには出席者定員料金が適用されます。詳細については、「[Amazon Chime SDK の料金](https://aws.amazon.com/chime/chime-sdk/pricing/)」を参照してください。

## クライアントアプリでの会議機能の使用
<a name="meeting-features-client-app"></a>



### 指定した機能を使用した会議の作成
<a name="js-create-meetings-sdk-namespace"></a>

会議を作成するには、[https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) を呼び出し、必要な会議機能を指定します。次の例は、すべての機能を指定する方法を示しています。

```
// 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();
```

### クライアントでの会議機能の使用
<a name="js-client-level"></a>

必要な機能を備えた会議を作成したら、`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)
);
```