컨트롤 리전 선택 미디어 리전 선택 가장 가까운 미디어 리전 찾기 가장 가까운 AWS GovCloud (미국) 미디어 지역 찾기 JavaScript 예시 리전 상태 확인

회의 리전 사용

Amazon Chime SDK 회의에는 컨트롤 리전 및 미디어 리전이 있습니다. 컨트롤 리전에는 회의를 생성, 업데이트 및 삭제하는 데 사용되는 API 엔드포인트가 있습니다. 미디어 리전은 실제 회의를 호스팅합니다.

일반적으로 애플리케이션 서비스는 AWS SDK를 사용하여 컨트롤 리전의 API를 서명 및 직접 호출합니다. 애플리케이션 클라이언트는 JavaScript iOS 또는 Android용 Amazon Chime SDK 클라이언트 라이브러리를 사용하여 미디어 지역의 회의에 연결합니다.

제어 영역은 동일한 AWS 파티션의 모든 미디어 지역에 회의를 생성할 수 있습니다. 하지만 회의를 만드는 데 사용된 컨트롤 리전에서만 회의를 업데이트할 수 있습니다. 고객과 가장 가까운 미디어 지역을 찾으려면 nearest-media-regionhttps://.l.chime.aws로 전화하십시오.

회의 제어 지역의 AttendeeJoined 통화 EventBridge, Amazon Simple Queue Service (SQS) 또는 Amazon Simple Notification Service (SNS) 와 같은 회의 이벤트

사용 가능한 Amazon Chime SDK 회의 컨트롤 및 미디어 리전 목록은 본 설명서의 사용 가능한 리전을 참조하세요.

이 다이어그램은 컨트롤 및 미디어 리전을 통한 일반적인 데이터 흐름을 보여줍니다.

Amazon Chime SDK 컨트롤 및 미디어 리전을 통한 데이터 흐름을 보여주는 다이어그램입니다.

컨트롤 리전 선택

Amazon Chime SDK 회의를 위한 컨트롤 리전을 선택할 때는 다음 요소를 명심합니다.

규제 요구 사항. 애플리케이션이 지정학적 경계 내에 있어야 하는지, 아니면 FIPS 140-2 검증 암호화 모듈이 있는 엔드포인트를 사용해야 하는지입니다.
API 지연 시간. 애플리케이션 서비스 지역과 가장 가까운 제어 AWS 지역을 사용하면 API의 네트워크 지연 시간을 줄이는 데 도움이 될 수 있습니다. 결과적으로 회의를 만드는 데 필요한 시간을 줄이고 사용자를 회의에 더 빨리 참여하도록 할 수 있습니다.
고가용성. 여러 컨트롤 리전을 사용하여 고가용성 아키텍처를 구현할 수 있습니다. 하지만 각 컨트롤 리전은 독립적으로 운영됩니다. 또한 회의를 만드는 데 사용된 컨트롤 리전에서만 회의를 업데이트할 수 있습니다. 또한 Amazon Simple Queue Service (SQS) 또는 Amazon Simple Notification Service (SNS) 를 통해 EventBridge 미팅 이벤트를 사용할 때도 동일한 지역을 사용해야 합니다.

미디어 리전 선택

참고

CreateMeetingAPI 작업의 MediaRegion 파라미터에 항상 값을 지정하는 것이 좋습니다. 리전에 대한 자세한 내용은 사용 가능한 리전을 참조하세요.

Amazon Chime SDK 회의에 사용할 미디어 리전을 선택할 때는 다음과 같은 공통 요소를 고려하세요.

규제 요구 사항

Amazon Chime SDK 회의를 지정학적 경계 내에서 호스팅해야 하는 규정이 적용되는 경우 고정된 애플리케이션 로직을 기반으로 회의 리전을 하드 코딩하는 것을 고려합니다.

예를 들어, 원격 진료 애플리케이션에서는 모든 회의를 의료 종사자의 관할 구역 내에서 호스팅하도록 요구할 수 있습니다. 애플리케이션이 유럽과 미국에 위치한 클리닉을 지원하는 경우 각 클리닉의 주소를 사용하여 해당 관할권 내의 리전을 선택할 수 있습니다.

회의 품질

Amazon Chime SDK 회의가 미디어 리전에서 호스팅되면 각 참석자의 오디오 및 비디오가 해당 리전에서 전송 및 수신됩니다. 참석자와 리전 간의 거리가 멀어질수록 네트워크 지연 시간으로 인해 회의 품질이 영향을 받을 수 있습니다. Amazon Chime SDK 회의를 위한 리전을 지정하면 참석자가 서로 가까이 있든 지리적으로 분산되어 있든 관계없이 참석자의 회의 품질을 향상시키는 데 도움이 될 수 있습니다.

다음 방법 중 하나를 사용하여 Amazon Chime SDK 회의를 위한 미디어 리전을 선택할 수 있습니다.

미디어 리전 하드 코딩: Amazon Chime SDK 미팅이 모두 특정 지역 내에서 호스팅되는 경우 권장됩니다. AWS
가장 가까운 미디어 리전 선택: Amazon Chime SDK 회의 참석자가 같은 AWS 지역에 있지만 회의를 호스팅하는 지역이 다른 경우 권장됩니다.

가장 가까운 미디어 리전 찾기

Amazon Chime SDK 회의를 호스팅할 수 있는 가장 가까운 미디어 지역을 찾으려면 https://.l.chime.aws로 전화하십시오. nearest-media-region 이 엔드포인트는 {"region": "us-west-2"}와 같은 단일 리전을 반환합니다. 클라이언트 애플리케이션에서 URL을 호출하여 사용자와 가장 가까운 지역을 식별한 다음, 그 결과를 API의 MediaRegion 파라미터로 사용하여 해당 지역에서 회의를 생성합니다. CreateMeeting

일반적으로 클라이언트 애플리케이션이 시작되거나 해당 네트워크 연결이 변경될 때 URL을 직접 호출합니다. 가장 가까운 리전을 미리 결정하면 회의를 만들 때 직접 호출 지연 시간이 추가되지 않습니다.

가장 가까운 AWS GovCloud (미국) 미디어 지역 찾기

Amazon Chime SDK 회의를 주최할 수 있는 가장 가까운 AWS GovCloud (미국) 지역을 찾으려면 https://-region.l.chime.aws로 전화하십시오. nearest-us-gov-media 이 엔드포인트는 {"region": "us-gov-west-1"}과 같은 가장 가까운 리전을 반환합니다. 클라이언트 애플리케이션에서 URL을 호출하여 사용자와 가장 가까운 AWS GovCloud (미국) 을 식별하고 그 결과를 API 파라미터에 사용하여 해당 지역에서 회의를 생성합니다. MediaRegion CreateMeeting

JavaScript 예시

다음 예제에서는 HTML 및 JavaScript D를 사용하여 가장 가까운 미디어 지역 및 AWS GovCloud (미국) 미디어 지역을 반환합니다.


<html>
<head>
  <title>Amazon Chime SDK - Nearest Media Region</title>
  <script>

async function getNearestMediaRegion(partition)  {

    console.log('Nearest media region partition: ' + partition);

    const url = ('aws-us-gov' == partition) ? 'https://nearest-us-gov-media-region.l.chime.aws' : 'https://nearest-media-region.l.chime.aws';
    let result = ('aws-us-gov' == partition) ? 'us-gov-west-1' : 'us-west-2';

    try { //Find the nearest media region
        console.log('Nearest media region URL: ' + url);
        const response = await fetch(url, {method: 'GET'} );
        const body = await response.json();
        result = body.region;
    } catch (error) {
        console.log(error.message);
    } finally {
        console.log('Nearest media region found: ' + result);
        return result;
    }
}

async function findRegions(partition) {
  aws.innerText = await getNearestMediaRegion();
  awsusgov.innerText = await getNearestMediaRegion('aws-us-gov');
}
  </script>
</head>
<body>
  <h3>Nearest media region, by AWS partition</h3>
  <table>
    <tr><th>Partition</th><th>Media Region</th></tr>
    <tr><td>aws</td><td id="aws">Finding...</td></tr>
    <tr><td>aws-us-gov</td><td id="awsusgov">Finding...</td></tr>
  </table>
  <script>
    findRegions();
  </script>
</body>
</html>

리전 상태 확인

https://region.status.chime.aws/를 직접 호출하여 각 리전의 Amazon Chime SDK 서비스 상태를 가져옵니다. 결과에는 권장 리전이 표시됩니다. 미디어 리전이 recommended 상태가 아닌 경우 가장 가까운 미디어 리전 엔드포인트는 해당 리전을 반환하지 않습니다.

다음 예제는 일반적인 결과를 보여줍니다.


{
  "MeetingsControlRegions": {
    "us-east-1": "recommended",
    "us-west-2": "recommended",
    "ap-southeast-1": "recommended",
    "eu-central-1": "recommended"
  },
  "MeetingsMediaRegions": {
    "af-south-1": "recommended",
    "ap-northeast-1": "recommended",
    "ap-northeast-2": "recommended",
    "ap-south-1": "recommended",
    "ap-southeast-1": "recommended",
    "ap-southeast-2": "recommended",
    "ca-central-1": "recommended",
    "eu-central-1": "recommended",
    "eu-north-1": "recommended",
    "eu-south-1": "recommended",
    "eu-west-1": "recommended",
    "eu-west-2": "recommended",
    "eu-west-3": "recommended",
    "sa-east-1": "recommended",
    "us-east-1": "recommended",
    "us-east-2": "recommended",
    "us-west-1": "recommended",
    "us-west-2": "recommended"
  },
  "MediaPipelineControlRegions": {
    "ap-southeast-1": "recommended",
    "eu-central-1": "recommended",
    "us-east-1": "recommended",
    "us-west-2": "recommended"
  },
  "MediaPipelineDataRegions": {
    "af-south-1": "recommended",
    "ap-northeast-1": "recommended",
    "ap-northeast-2": "recommended",
    "ap-south-1": "recommended",
    "ap-southeast-1": "recommended",
    "ap-southeast-2": "recommended",
    "ca-central-1": "recommended",
    "eu-central-1": "recommended",
    "eu-north-1": "recommended",
    "eu-south-1": "recommended",
    "eu-west-1": "recommended",
    "eu-west-2": "recommended",
    "eu-west-3": "recommended",
    "sa-east-1": "recommended",
    "us-east-1": "recommended",
    "us-east-2": "recommended",
    "us-west-1": "recommended",
    "us-west-2": "recommended"
  }
}

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Amazon Chime SDK 회의 네임스페이스로 마이그레이션

회의 생성