구글 클라우드 라이브 스트림 API 연동 가이드

개요

본 문서는 구글 클라우드의 라이브 스트림 API를 이용한 라이브 스트림 영상에 PallyCon 멀티DRM 패키징을 연동하는 방법을 설명합니다. 라이브 스트림 API는 메자닌 라이브 신호를 여러 디바이스 플랫폼에서 사용할 수 있도록 DASH(Dynamic Adaptive Streaming over HTTP), HLS(HTTP Live Streaming) 등의 스트리밍 포맷으로 트랜스코딩합니다.

연동 샘플

PallyCon GCP 라이브 스트림 연동 샘플 Github 저장소

PallyCon GCP 라이브 스트림 연동 샘플은 API 클라이언트 라이브러리를 이용하여 구글 클라우드 라이브 스트림 API v1과 PallyCon 멀티 DRM을 연동하는 방법을 보여줍니다. 본 가이드는 DRM 연동에 중점을 두었기 때문에 fmp4 포맷의 라이브 스트림에 Widevine, PlayReady, FairPlay DRM을 적용하는 간단한 시나리오만 사용하였으며, 라이브 스트림 API v1 기능에 대한 자세한 내용은 레퍼런스 링크를 참고하시기 바랍니다.

사전 요구 사항

윈도우즈 10/11 PC
Visual Studio 2022 (Windows 10/11)
.NET 6.0 SDK : https://dotnet.microsoft.com/download
구글 클라우드 계정 : https://cloud.google.com/
- 프로젝트 생성 : https://cloud.google.com/resource-manager/docs/creating-managing-projects
- 버킷 생성 : https://cloud.google.com/storage/docs/creating-buckets
Google Application Default Credentials (ADC) : https://cloud.google.com/docs/authentication/provide-credentials-adc
Identity and Access Management (IAM)
- roles/livestream.editor
- roles/storage.admin
- roles/secretmanager.admin
- roles/secretmanager.secretAccessor
  - 이 역할은 서비스 API에서 Google 시크릿에 액세스할 수 있는 권한이므로 사용자가 아닌 서비스 계정에 부여해야 합니다.
  - https://cloud.google.com/livestream/docs/access-control#access_to_gcs
PallyCon KMS와 CPIX API 통신에 사용되는 KMS 토큰. PallyCon 서비스 가입 시 생성되는 API 인증 토큰으로, PallyCon 콘솔 사이트에서 확인할 수 있습니다.
라이브 스트림 API로 처리할 스트림을 생성하는 라이브 인코더
- 본 예제에서는 ffmpeg을 사용합니다.

샘플 프로젝트 실행 방법

샘플 리포지토리를 복제하거나 다운로드합니다.
Visual Studio에서 PallyConGoogleLiveStreamSample.sln 파일을 열고 실행할 활성 프로젝트를 선택합니다.
구글 클라우드 프로젝트, 버킷 정보, PallyCon KMS 관련 정보가 있는지 확인합니다.
메인 메소드 상단에 있는 변수 값을 설정합니다.
프로젝트를 실행합니다.
콘솔에 출력되는 <RTMP input endpoint uri>를 복사합니다.
스트리밍 상태가 AwaitingInput이고 채널이 준비되었습니다라는 출력이 표시되면 아래와 같이 입력 엔드포인트로 라이브 스트림을 전송합니다.
```
$ ffmpeg -re -f lavfi -i "testsrc=size=1280x720 [out0]; sine=frequency=500 [out1]" \
  -acodec aac -vcodec h264 -f flv <RTMP input endpoint uri>
```
Google Cloud 콘솔의 Buckets 페이지에서 패키징 결과를 확인합니다.

PallyConKMSClientWrapper

C++ 라이브러리(PallyConKmsClient_MD.lib)를 래핑하여 PallyCon KMS 서버와 통신하기 위한 C++/CLI 프로젝트입니다. getPackagingInfoFromKmsServer 함수를 사용하면 KMS 서버로부터 패키징 정보를 가져올 수 있습니다.

bool PallyConKmsClientWrapper::getPackagingInfoFromKmsServer(String^ content_id, String^% key_id, String^% key, String^% iv, String^% hls_key_uri, String^% widevine_pssh, String^% playready_pssh)
{
	try
	{
		ContentPackagingInfo packInfos = _kmsClient->getContentPackagingInfoFromKmsServer(
			msclr::interop::marshal_as<std::string>(content_id), "", PackType::DASH | PackType::HLS);
		key_id = gcnew String(packInfos.keyId.c_str());
		key = gcnew String(packInfos.key.c_str());
		iv = gcnew String(packInfos.iv.c_str());
		hls_key_uri = gcnew String(packInfos.hlsKeyUri.c_str());
		widevine_pssh = gcnew String(packInfos.pssh_widevine.c_str());
		playready_pssh = gcnew String(packInfos.pssh_playready.c_str());
	}
	catch (std::exception& e)
	{
		std::cout << e.what();
	}

	return true;
}

참고 링크

마지막 업데이트 May 18, 2023