기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

비디오 스트림에 메타데이터를 포함하기

Amazon Interactive Video Service(IVS)의 시한 메타데이터는 Amazon IVS 스트림에 메타데이터를 포함하는 방법을 제공합니다. 이를 통해 스트림 지연 시간이나 지리적 위치에 관계없이 모든 시청자가 비디오 스트림에서 메타데이터를 동시에 수신할 수 있습니다.

시한 메타데이터는 무엇입니까?

시한 메타데이터는 타임 스탬프가 있는 메타데이터입니다. IVS API 또는 IVS 브로드캐스트 SDK를 사용하여 프로그래밍 방식으로 스트림에 삽입할 수 있습니다. Amazon IVS가 스트림을 처리하면 시한 메타데이터가 오디오 및 비디오 프레임과 동기화됩니다. 재생 중에 스트림의 모든 시청자는 스트림을 기준으로 메타데이터를 동시에 가져옵니다. 타임 코드는 큐 포인트 역할을 하며, 다음과 같이 데이터를 기반으로 작업을 트리거하는 데 사용할 수 있습니다.

Amazon IVS의 시한 메타데이터는 비디오 세그먼트에 포함된 ID3 태그를 사용합니다. 따라서, 이를 레코딩된 비디오에 사용할 수 있습니다.

IAM 권한 설정

사전 조건: 진행하기 전에 IVS 지연 시간이 짧은 스트리밍 시작하기(IAM 사용자 생성 및 권한 설정 포함)를 통해 단계별 작업을 수행해야 합니다.

그런 다음, IAM 사용자에게 시한 메타데이터를 사용할 권한을 부여해야 합니다. 다음 단계를 따릅니다.

시한 메타데이터 삽입

지정된 채널의 활성 스트림에만 시한 메타데이터를 삽입할 수 있습니다.

AWS CLI 사용

테스트를 위해 시한 메타데이터를 추가하는 가장 쉬운 방법은 AWS CLI를 사용하는 것입니다. AWS CLI를 사용하려면 먼저 시스템에 CLI를 다운로드하여 구성해야 합니다. IVS 지연 시간이 짧은 스트리밍 시작하기를 통해 단계별 작업을 수행할 때 해당 작업을 완료했을 수 있습니다. 그렇지 않은 경우 지금 완료하세요. 자세한 내용은 AWS 명령줄 인터페이스 사용 설명서를 참조하세요.

CLI가 구성되면 다음을 수행합니다.

Amazon IVS API 사용

프로그래밍 방식으로 시한 메타데이터를 삽입하려면 PutMetadata API 엔드포인트를 사용합니다.

다음은 HTTP 요청의 예입니다.

POST /PutMetadata HTTP/1.1
{
    "channelArn": "my_channel",
    "metadata": "{\"question\": \"What does IVS stand for?\", \"correctIndex\": 0, \"answers\": [\"interactive video service\", \"interesting video service\", \"ingenious video service\"]}"
}

IVS 브로드캐스트 SDK 사용

IVS 브로드캐스트 SDK를 사용하여 대역 내에서 시한 메타데이터를 삽입할 수 있습니다. 이는 메타데이터를 오디오 및 비디오 콘텐츠와 동기화하는 데 유용할 수 있습니다.

시한 메타데이터 사용

Amazon IVS 플레이어를 사용하여 비디오 스트림에 포함된 시한 메타데이터를 사용합니다. Amazon IVS 플레이어 SDK 및 플레이어 설명서의 나머지 부분을 참조하세요.

다음은 Amazon IVS 플레이어 SDK를 사용하여 콘솔에 수신된 모든 메타데이터를 인쇄하는 예제 조각입니다. 재생 시 메타데이터가 포함된 세그먼트에 도달할 때마다 이벤트가 트리거됩니다. (이벤트는 웹의 경우 TEXT_METADATA_CUE, Android의 경우 onCue(), iOS의 경우 player(_:didOutputCue:)입니다.) 이 이벤트를 사용하여 클라이언트 애플리케이션에서 대화형 위젯 업데이트와 같은 기능을 시작할 수 있습니다. 이 이벤트는 라이브 콘텐츠와 레코딩된 콘텐츠 모두에 트리거됩니다.

Amazon IVS Player SDK for Web:

const player = IVSPlayer.create();
player.addEventListener(IVSPlayer.PlayerEventType.TEXT_METADATA_CUE,
    function (cue) {
  console.log('Timed metadata: ', cue.text);
});

Amazon IVS Player SDK for Android:

@Override
public void onCue(@NonNull Cue cue) {
  if(cue instanceof TextMetadataCue) {
    Log.i("Timed Metadata: ", ((TextMetadataCue)cue).text);
  }
}

Amazon IVS Player SDK for iOS:

func player(_ player: IVSPlayer, didOutputCue cue: IVSCue) {
  if let textMetadataCue = cue as? IVSTextMetadataCue {
    print("Timed Metadata: \(textMetadataCue.text)")
  }
}

참고: 시한 메타데이터는 iOS Safari 및 iOS Chrome의 플레이어 1.3.0 이상에서 지원됩니다.

데모 샘플: 퀴즈 앱

GitHub에서 대화형 퀴즈 앱의 코드 샘플을 사용할 수 있습니다. 시한 메타데이터를 통해 JSON을 사용하여 퀴즈 UI를 채워 질문과 답변을 표시합니다. 답변을 선택할 수 있으며 선택이 올바른지 여부를 알 수 있습니다.

시한 메타데이터 보기

원하는 경우 콘솔에서 라이브 스트림에 포함된 시한 메타데이터를 볼 수 있습니다.

자세한 정보

Amazon IVS 시한 메타데이터 사용에 대해 두 부분으로 구성된 블로그 시리즈 중 첫 번째인 Amazon Interactive Video Service 시한 메타데이터 사용을 참조하세요.