DEV Community: Junpyeong Kim

Unity에서 라이브 스트리밍 - 실시간 게임 브로드캐스팅 (Part 2) (Live Streaming from Unity - Broadcasting a Game in Real-Time (Part 2))

Junpyeong Kim — Thu, 09 May 2024 01:33:32 +0000

이 블로그 포스트는 Todd Sharp(Amazon IVS Developer Evangelist)이 포스팅한 Live Streaming from Unity with Amazon IVS - Part 1의 한국어 번역입니다.
(This is the Korean translation of Amazon IVS Developer Evangelist, Todd Sharp's Live Streaming from Unity with Amazon IVS - Part 1.)

이 포스팅에서는 Unity에서 제작한 게임을 Amazon IVS(Amazon Interactive Video Service)에서 제공하는 실시간 라이브 스트림으로 직접 브로드캐스팅하는 방법을 살펴보겠습니다. 이 포스팅에서는 Amazon IVS Stage를 만들고, 해당 Stage로 브로드캐스팅하는 데 필요한 토큰을 생성하는 등 향후 포스팅에서 재사용될 몇 가지 주제를 다루기 때문에 이 시리즈의 다른 포스팅보다 내용이 조금 더 많을 것입니다.

시작하기

이 포스팅에서는 Unity Hub에서 학습용 템플릿으로 제공되는 'Karting Microgame'을 활용하겠습니다.

Unity Hub에서 'New Project'를 클릭하세요.

왼쪽 사이드바에서 'Learning'을 클릭하고 'Karting Microgame'을 선택한 다음, 프로젝트 이름을 ivs-rtx-broadcast-demo로 지정하고 'Create project'를 클릭하세요.

WebRTC 지원 추가하기

Amazon IVS Stage로 브로드캐스팅(하고 Stage로부터 재생)하려면 WebRTC가 사용됩니다. 다행히도 이를 위해 사용할 수 있는 훌륭한 Unity WebRTC package가 있으며 Amazon IVS가 이제 WHIP 프로토콜을 지원하므로, 이를 활용하여 게임에서 직접 브로드캐스팅할 수 있습니다.

Karting 데모를 위해 WebRTC 패키지를 설치하려면 Window -> Package Manager로 이동하세요.

Package Manager 대화 상자에서 'Add package from git URL'를 선택합니다.

com.unity.webrtc@3.0.0-pre.7 을 Git URL로 입력하고 'Add'를 클릭합니다.

⚠️ 이 데모는 테스트를 거쳤으며 위에 나열된 패키지 버전에서 작동하는 것으로 알려져 있습니다. 이 글을 읽는 시점에는 최신 버전이 아닐 수도 있습니다.

설치가 완료되면 Package Manager 대화 상자에 WebRTC 패키지 세부 정보가 표시됩니다.

게임플레이를 퍼블리시하는 데 필요한 카메라와 스크립트를 추가하기 전에, Amazon IVS Stage를 생성하고 Stage로 퍼블리시하는 데 필요한 참여자 토큰을 생성하는 방법을 설정해야 합니다.

Stage 생성

Amazon IVS Stage에서는 최대 12명의 브로드캐스터가 최대 10,000명의 시청자에게 실시간 라이브 스트리밍을 할 수 있습니다. 모든 데모에서 이 Stage를 재사용할 것이므로 AWS Management Console을 통해 수동으로 생성하겠습니다. 모든 플레이어에게 이 기능을 통합하기로 결정한다면, AWS SDK를 통해 프로그래밍 방식으로 Stage를 생성하고 백엔드 서비스에서 현재 플레이어의 ARN(Amazon Resource Name)을 검색해야할 것입니다. 우리는 단지 작동 방식을 배우는 중이므로 수동으로 생성하고 데모 게임에 ARN을 하드코딩해도 아무런 문제가 없습니다.

AWS Management Console에서, 'Amazon Interactive Video Service'를 검색하세요. Amazon IVS Console 랜딩 페이지에서 'Amazon IVS Stage'를 선택하고 'Get Started'를 클릭하세요.

Stage 이름을 입력하고 'Create statge'를 클릭하세요.

이제 Stage가 준비되었습니다! Stage 세부 정보 페이지에서 Stage ARN을 가져옵니다.

이제 토큰을 생성해야 합니다.

참가자 토큰

Amazon IVS Stage의 모든 참가자 - 브로드캐스터와 시청자 모두 - 는 Stage에 연결하기 위해 참가자 토큰이 필요합니다. 이것은 JWT 토큰으로, 사용자를 인증하는데 사용되고 userid와 같은 정보와 참가자에게 부여된 모든 기능(예: PUBLISH 및 SUBSCRIBE)을 포함합니다. 이러한 토큰을 수동으로 생성하고 Unity 코드에 반복적으로 붙여넣으려면 시간이 많이 걸리므로 AWS SDK를 사용하여 이러한 토큰을 생성하는 독립형 서비스를 만드는 것이 좋습니다. 저는 이와 같은 데모를 많이 제작하기 때문에 토큰 생성을 처리하기 위해 AWS Lambda를 배포했습니다. 여러분이 아직 이렇게 할 준비가 되지 않았다면, 로컬에서 [선호하는 언어]용 AWS SDK를 사용하는 서비스를 만들고 CreateParticipantToken(문서)을 활용하세요. 저는 JavaScript를 선호하므로 제 함수는 JavaScript(v3) 용 AWS SDK를 사용하고 CreateParticipantTokenCommand(docs)를 실행합니다.

이를 수행하는 가장 기본적인 방법은 디렉터리를 생성하고 다음 종속성을 설치하는 것입니다.

npm i @aws-sdk/client-ivs-realtime@latest @aws-sdk/credential-providers

그런 다음 index.js라는 파일을 생성합니다. 이 파일에서는 /token이라는 하나의 경로에 응답하는 Node.js를 이용한 매우 기본적인 웹 서버를 실행할 것입니다. 이 경로는 토큰을 생성하여 JSON으로 반환합니다. 참고로, [YOUR STAGE ARN] 대신에 여러분의 Stage ARN을 입력해야 합니다.

import * as http from 'http';
import * as url from 'url';
import { fromIni } from "@aws-sdk/credential-providers";
import { CreateParticipantTokenCommand, IVSRealTimeClient } from "@aws-sdk/client-ivs-realtime";

const ivsRealtimeClient = new IVSRealTimeClient({ credentials: fromIni({ profile: 'recursivecodes' }) });

export const createStageToken = async (stageArn, attributes, capabilities, userId, duration) => {
  const createStageTokenRequest = new CreateParticipantTokenCommand({
    attributes,
    capabilities,
    userId,
    stageArn,
    duration,
  });
  const createStageTokenResponse = await ivsRealtimeClient.send(createStageTokenRequest);
  return createStageTokenResponse;
};

async function handler(req, res) {
  const parsedUrl = url.parse(req.url, true);
  if (parsedUrl.pathname === '/token') {
    let body = '';
    req.on('data', chunk => {
      body += chunk.toString();
    });
    req.on('end', async () => {
      const params = JSON.parse(body);
      res.writeHead(200, { 'Content-type': 'application/json' });
      const tokenResponse = await createStageToken(
        params.stageArn,
        params.attributes,
        params.capabilities,
        params.userId,
        params.duration,
      );
      res.write(JSON.stringify(tokenResponse));
      res.end();
    });
  }
  else {
    res.writeHead(404, { 'Content-type': 'text/plain' });
    res.write('404 Not Found');
    res.end();
  };
}

const server = http.createServer(handler);
server.listen(3000);

node index.js로 실행하고 http://localhost:3000/token을 호출하여 토큰을 생성합니다. 토큰이 필요할 때마다 Unity에서 이 엔드포인트를 사용할 것입니다. 다음은 토큰이 어떻게 생성되는지 보여주는 예시입니다:

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"stageArn": "[YOUR STAGE ARN]", "userId": "123456", "capabilities": ["PUBLISH", "SUBSCRIBE"], "attributes": {"username": "todd"}}' \
  http://localhost:3000/token | jq

이 명령은 다음과 같은 결과를 보여줍니다:

{
  "$metadata": {
    "httpStatusCode": 200,
    "requestId": "...",
    "cfId": "...",
    "attempts": 1,
    "totalRetryDelay": 0
  },
  "participantToken": {
    "attributes": {
      "username": "todd"
    },
    "capabilities": [
      "PUBLISH",
      "SUBSCRIBE"
    ],
    "duration": 1200,
    "expirationTime": "2024-01-19T15:11:32.000Z",
    "participantId": "bWO1wUhGopye",
    "token": "eyJhbGciOiJLTVMiLCJ0eXAiOiJKV1QifQ....[truncated]",
    "userId": "1705605092467"
  }
}

카메라 추가하기

이제 Stage와 토큰을 생성하는 방법이 생겼으니, Stage에 게임플레이를 브로드캐스팅하는 데 사용할 새 카메라를 추가할 수 있습니다. Unity에서 'Main Scene'을 확장해서 CinemachineVirtualCamera를 찾습니다. 이 카메라는 Karting Microgame 프로젝트에서 플레이어의 카트가 코스를 주행할 때 트랙 주변을 따라가는 데 사용됩니다. CinemachineVirtualCamera를 마우스 오른쪽 버튼으로 클릭하고 Camera를 추가합니다. 저는 WebRTCPublishCamera라고 이름을 지었습니다.

다음으로, 새로 생성한 카메라를 선택하고 'Inspector' 탭의 하단으로 스크롤합니다. 'Audio Listener'를 선택 해제하지 않으면 하나의 Scene에 여러 오디오 리스너가 있다는 오류가 콘솔에 표시됩니다. 이를 선택 해제하고, 'Add Component'를 클릭합니다.

'Add Component' 메뉴에서 'New Script'를 선택하고 스크립트 이름을 WebRTCPublish로 지정합니다. 'Create and Add'를 클릭합니다.

스크립트가 추가되면 스크립트를 두 번 클릭하여 VS Code (또는 여러분이 설정한 편집기)에서 엽니다.

이제 카메라를 Stage로 브로드캐스트하는데 사용할 스크립트를 편집할 수 있습니다.

Amazon IVS Stage로 카메라 브로드캐스트하기

이제 Stage 토큰을 가져오고 카메라를 Stage에 게시하기 위한 WebRTC 연결을 설정하는 데 필요한 로직을 포함하도록 WebRTCPublish.cs 스크립트를 수정할 수 있습니다.

토큰 생성 서비스의 요청과 응답을 처리하는 데 도움이 되는 몇 가지 클래스를 만들겠습니다. 별도의 파일을 사용할 수도 있지만, 지금은 모든 것을 한 곳에 보관하기 위해 동일한 파일 내에 정의합니다.

[System.Serializable]
public class ParticipantToken
{
  public string token;
  public string participantId;
  public System.DateTime expirationTime;
  public static ParticipantToken CreateFromJSON(string jsonString)
  {
    return JsonUtility.FromJson<ParticipantToken>(jsonString);
  }
}

[System.Serializable]
public class StageToken
{
  public ParticipantToken participantToken;
  public static StageToken CreateFromJSON(string jsonString)
  {
    return JsonUtility.FromJson<StageToken>(jsonString);
  }
}

[System.Serializable]
public class StageTokenRequestAttributes
{
  public string username;
  public StageTokenRequestAttributes(string username)
  {
    this.username = username;
  }
}

[System.Serializable]
public class StageTokenRequest
{
  public string stageArn;
  public string userId;
  public int duration;
  public StageTokenRequestAttributes attributes;
  public string[] capabilities;
  public StageTokenRequest(string stageArn, string userId, int duration, string[] capabilities, StageTokenRequestAttributes attributes)
  {
    this.stageArn = stageArn;
    this.userId = userId;
    this.duration = duration;
    this.capabilities = capabilities;
    this.attributes = attributes;
  }
}

다음으로 게임 오디오를 브로드캐스트하기 위해 AudioListener가 필요하다고 클래스에 Annotation을 추가해야 합니다. 또한 스크립트에서 사용할 몇 가지 변수를 선언할 것입니다.

[RequireComponent(typeof(AudioListener))]
public class WebRTCPublish : MonoBehaviour
{
  RTCPeerConnection peerConnection;
  MediaStreamTrack videoTrack;
  AudioStreamTrack audioTrack;
  Camera cam;
  ParticipantToken participantToken;
}

이제 토큰 생성 서비스를 호출하고 토큰을 요청할 비동기 함수를 만들어 보겠습니다. 이 함수는 WebRTCPublish 클래스 안에서 정의하겠습니다.

async Task<StageToken> GetStageToken()
{
  using UnityWebRequest www = new UnityWebRequest("http://localhost:3000/token");
  StageTokenRequest tokenRequest = new StageTokenRequest(
    "[YOUR STAGE ARN]",
    System.Guid.NewGuid().ToString(),
    1440,
    new string[] { "PUBLISH", "SUBSCRIBE" },
    new StageTokenRequestAttributes("ivs-rtx-broadcast-demo")
  );
  www.uploadHandler = new UploadHandlerRaw(System.Text.Encoding.ASCII.GetBytes(JsonUtility.ToJson(tokenRequest)));
  www.downloadHandler = new DownloadHandlerBuffer();
  www.method = UnityWebRequest.kHttpVerbPOST;
  www.SetRequestHeader("Content-Type", "application/json");
  var request = www.SendWebRequest();
  while (!request.isDone)
  {
    await Task.Yield();
  };
  var response = www.downloadHandler.text;
  Debug.Log(response);
  if (www.result != UnityWebRequest.Result.Success)
  {
    Debug.Log(www.error);
    return default;
  }
  else
  {
    StageToken stageToken = StageToken.CreateFromJSON(www.downloadHandler.text);
    Debug.Log(stageToken);
    participantToken = stageToken.participantToken;
    return stageToken;
  }
}

Start() 메서드 내에서 WebRTC.Update() 코루틴을 시작하고, 새 RTCPeerConnection을 설정하고, 카메라를 가져와서 그 출력을 peerConnection에 추가하고, 게임 오디오도 추가하겠습니다. 그런 다음 잠시 후에 정의할 DoWhip()이라는 코루틴을 시작하겠습니다.

async void Start()
{
  StartCoroutine(WebRTC.Update());
  peerConnection = new RTCPeerConnection
  {
    OnIceConnectionChange = state => { Debug.Log("Peer Connection: " + state); }
  };
  cam = GetComponent<Camera>();
  videoTrack = cam.CaptureStreamTrack(1280, 720);
  peerConnection.AddTrack(videoTrack);
  AudioListener audioListener = cam.GetComponent<AudioListener>();
  audioTrack = new AudioStreamTrack(audioListener) { Loopback = true };
  peerConnection.AddTrack(audioTrack);
  StartCoroutine(DoWHIP());
}

토큰을 가져오고, 로컬 SDP를 생성한 다음, 이를 전달하여 원격 SDP를 검색하는 DoWhip()을 정의해 보겠습니다 (결국 peerConnection에서 이를 설정하여 WebRTC 연결 프로세스를 완료합니다). Authorization 헤더에 Bearer 값으로 토큰을 전달하여 SDP를 검색하기 위해, Amazon IVS 글로벌 WHIP 엔드포인트(https://global.whip.live-video.net/) 를 사용할 것입니다.

IEnumerator DoWHIP()
{
  Task getStageTokenTask = GetStageToken();
  yield return new WaitUntil(() => getStageTokenTask.IsCompleted);
  Debug.Log(participantToken.token);
  Debug.Log(participantToken.participantId);

  var offer = peerConnection.CreateOffer();
  yield return offer;

  var offerDesc = offer.Desc;
  var opLocal = peerConnection.SetLocalDescription(ref offerDesc);
  yield return opLocal;

  var filteredSdp = "";
  foreach (string sdpLine in offer.Desc.sdp.Split("\r\n"))
  {
    if (!sdpLine.StartsWith("a=extmap"))
    {
      filteredSdp += sdpLine + "\r\n";
    }
  }
  using (UnityWebRequest www = new UnityWebRequest("https://global.whip.live-video.net/"))
  {
    www.uploadHandler = new UploadHandlerRaw(System.Text.Encoding.ASCII.GetBytes(filteredSdp));
    www.downloadHandler = new DownloadHandlerBuffer();
    www.method = UnityWebRequest.kHttpVerbPOST;
    www.SetRequestHeader("Content-Type", "application/sdp");
    www.SetRequestHeader("Authorization", "Bearer " + participantToken.token);
    yield return www.SendWebRequest();
    if (www.result != UnityWebRequest.Result.Success)
    {
      Debug.Log(www.error);
    }
    else
    {
      var answer = new RTCSessionDescription { type = RTCSdpType.Answer, sdp = www.downloadHandler.text };
      var opRemote = peerConnection.SetRemoteDescription(ref answer);
      yield return opRemote;
      if (opRemote.IsError)
      {
        Debug.Log(opRemote.Error);
      }
    }
  }
}

이제 게임을 실행해서 Unity 콘솔에서 토큰 확인 및 연결 설정되었는지 확인할 준비가 되었습니다. Unity에서 play 버튼을 눌러 게임을 실행하고 콘솔을 확인합니다.

결과가 괜찮아 보입니다! 토큰이 생성되었고 피어 연결이 Connected상태가 되었습니다. 게임플레이가 Stage로 스트리밍되는지 확인해 봅시다.

재생 테스트

재생을 테스트하기 위해, Amazon IVS Web Broadcast SDK를 사용하여 무대에 연결하고 참가자가 연결될 때 렌더링할 수 있습니다. 이 부분은 오프라인 연습으로 남겨두고 이 CodePen에서 테스트해 보겠습니다. 다른 토큰을 생성하여 클립보드에 복사한 다음, CodePen에 붙여넣고 게임이 실행 중이고 스테이지로 방송을 하는 동안 'Join Stage'를 클릭합니다. 모든 것이 잘 진행되었다면 실시간 방송을 볼 수 있을 것입니다!

🔊 참고: 위 동영상에서 오디오가 중복되는 것을 볼 수 있는데, 이는 로컬 게임 오디오와 스트림 오디오가 모두 캡처되었기 때문입니다.

리소스 정리

Destroy()에서, 'peerConnection'을 닫아서 삭제하고 오디오 및 비디오 트랙리소스들을 정리할 수 있습니다.

async void OnDestroy()
{
  Debug.Log("OnDestroy");
  if (peerConnection != null)
  {
    peerConnection.Close();
    peerConnection.Dispose();
  }
  if (videoTrack != null) videoTrack.Dispose();
  if (audioTrack != null) audioTrack.Dispose();
}

어떻게 개선할 수 있을까요?

현재 상태로는 꽤 인상적이라고 말씀드리고 싶습니다! 이 시리즈의 이전 게시물에서 언급한 몇 가지 사항 외에도, 이 시리즈의 다음 게시물에서 다룰 개선 사항이 한 가지 있습니다. 위 동영상에서 이미 눈치채셨을 수도 있습니다. 놓치셨다면 위 동영상에서 실시간 재생을 확인해보시면 스트림에서 경기 타이머와 같은 HUD 요소와 지침과 같은 오버레이가 표시되지 않는 것을 확인할 수 있습니다. 이는 Unity의 캔버스 엘리먼트가 일반적으로 'Screen Space - Overlay'를 사용하도록 구성되어 있어서, 이는 카메라가 게임 화면에 렌더링하는 모든 것 위에 렌더링된다는 것을 의미합니다. 모든 HUD와 UI 요소를 라이브 스트림에 렌더링할 필요가 없을 수도 있으므로(특히 사용자별 데이터를 표시할 수 있는 화면의 경우) 반드시 나쁜 것은 아닙니다. 이는 게임마다 사례별로 처리될 수 있지만, 전체 UI를 렌더링해야 하는 경우에는 이 시리즈의 다음 포스팅에서 이 문제를 해결하는 한 가지 접근 방식을 살펴보겠습니다.

또 다른 개선 사항은 게임이 시작될 때 자동으로 스트림을 실행하는 대신 스트림을 시작/중단할 수 있는 UI 버튼을 추가하는 것입니다.

요약

(다소 긴) 이번 포스팅에서는, Unity로 만든 게임에서 Amazon IVS 실시간 Stage로 직접 방송하는 방법에 대해 알아보았습니다. 이 시리즈의 다음 포스팅에서는 반복하지 않을 Stage 생성 및 토큰 생성과 같은 몇 가지 소개 주제를 다루었으므로 복습이 필요한 경우 이 포스팅을 다시 참조하시기 바랍니다.

이 데모에 사용한 전체 스크립트를 보고 싶으시다면 GitHub에서 이 Gist를 확인하세요. 제 프로덕션 토큰 엔드포인트는 POST 메서드를 사용하며 Stage ARN, 사용자 ID 등을 전송할 수 있으므로 이 스크립트는 해당 POST 요청을 모델링하기 위한 몇 가지 추가 클래스가 포함되어 있다는 점에 유의하세요. 여러분의 자체 엔드포인트에서 작동하도록 수정해야 할 수도 있지만 이 스크립트로 시작할 수 있습니다.

Unity에서 Amazon IVS로 라이브 스트리밍하기 - Part 1 (Live Streaming from Unity with Amazon IVS - Part 1)

Junpyeong Kim — Thu, 09 May 2024 01:33:11 +0000

이 블로그 포스트는 Todd Sharp(Amazon IVS Developer Evangelist)이 포스팅한 Live Streaming from Unity with Amazon IVS - Part 1의 한국어 번역입니다.
(This is the Korean translation of Amazon IVS Developer Evangelist, Todd Sharp's Live Streaming from Unity with Amazon IVS - Part 1.)

'Unity에서 Amazon IVS로 라이브 스트리밍하기' 시리즈에 오신 것을 환영합니다 - 이 시리즈는 게임 개발자가 Amazon IVS (Amazon Interactive Video Service)를 이용하여 실시간 인터랙티브 스트리밍을 Unity로 제작한 게임에 직접 통합할 수 있는 다양한 방법을 안내하기 위해 마련되었습니다. 이 소개 포스팅에서는 Amazon IVS를 소개하고, 게임에서 통합 스트리밍 경험을 제공해야 하는 이유에 대해 설명하며, 이 시리즈의 향후 포스팅에 대한 개요를 제공합니다. 그럼 시작해 보겠습니다!

Amazon IVS가 무엇입니까?

Amazon IVS를 처음 사용하시는 분들을 위해 간략하게 설명해 드리겠습니다. Amazon IVS는 Twitch를 지원하는 것과 동일한 라이브 스트리밍 기술과 글로벌 인프라를 사용하여 개발자가 자체 애플리케이션을 구축할 수 있도록 지원하는 AWS 서비스입니다. Amazon IVS는 저지연(2~5초) RTMPS 기반 스트리밍, 실시간(300ms 미만) WebRTC 기반 스트리밍, 고성능 및 확장성이 뛰어난 WebSocket 기반 채팅이라는 세 가지 주요 기능을 제공합니다.

이 블로그 시리즈에서, Amazon IVS는 게임 개발자들이 플레이어들을 위한 매우 맞춤화되고 밀접하게 통합된 라이브 스트리밍 애플리케이션을 구축할 수 있도록 도와줍니다. 이를 통해 더 많은 참여와 전반적인 경험에 대한 더 많은 제어가 가능해집니다. 이는 이전에 본 적 없는 다이나믹하고 인터랙티브한 게임 플레이를 이끌어낼 것입니다. 수익화, 모더레이션(Moderation), 재생 품질, 시청자 상호 작용, 채팅 통합 등 많은 기능을 모두 개발자가 제어할 수 있습니다.

💡 https://ivs.rocks/에서 Amazon IVS에 대해 자세히 알아보세요.

게임에서 직접 라이브 스트리밍하는 이유는 무엇일까요?

게임 스트리밍은 매우 인기가 있습니다. 하지만, 여러분은 이미 이것을 알고 있습니다! 여러분의 플레이어들은 이미 OBS와 같은 소프트웨어를 통해 라이브 스트리밍을 하고 있을 수도 있고, Twitch에서 발표한 개선된 방송하기 기능처럼, 일부 플레이어에게는 항상 사용 가능한(때로는 선호되는) 스트리밍 방식이 될 것입니다. 하지만 솔직히 말해서 OBS 설정은 일부 플레이어에게 쉬운 일이 아닙니다. 비트레이트, B-프레임, 코덱, 키프레임 간격 등은 단순히 게임플레이 시청자들에게 스트리밍하려는 사람에게는 부담스러울 수 있습니다.

게임에서 플레이어들에게 직접 스트리밍할 수 있는 기회를 제공함으로써, 일부 플레이어들에게는 진입 장벽을 없애주면서 모든 플레이어들에게는 시청자들로부터 피드백을 통해 게임플레이를 향상시킬 수 있는 기회를 제공할 수 있습니다. 시청자를 위한 다양한 카메라 각도(boss cam)는 어떨까요? 시청자가 플레이어의 캠에 영향을 주지 않고 카메라를 팬/틸트/줌/회전하여 원하는 각도로 시청할 수 있는 사용자 제어 카메라는 어떨까요? (네, 정말 가능합니다!) 채팅이나 설문조사에 따라 환경이나 NPC의 행동을 수정하는 것은 어떨까요? 네, 스트리밍 경험을 게임에 직접 통합하면 이 모든 것(그리고 훨씬 더 많은 것)이 가능합니다.

시리즈 개요

여러분은 이미 유니티로 만든 게임에서 직접 라이브 스트리밍을 할 수 있는 가능성에 대해 꽤나 푹 빠져있을⚙️ 것으로 확신합니다. 이 시리즈에서는 다음과 같은 주제를 다룰 예정입니다:

소개 (이 글)
Unity에서 Amazon IVS Real-Time으로 브로드캐스팅하기
향상된 실시간 게임 브로드캐스팅하기 (HUD 포함)
Unity 게임에 Amazon IVS Chat 통합하기
동적 및 대화형 스트림 (사용자 제어 카메라, 동적 환경 및 목표물)
여러 대의 카메라를 실시간으로 방송하기 (시청자는 서로 볼수 있거나 그 둘 사이를 전환할 수 있음)
Unity에서 실시간 스트림 재생하기 (비디오로 그룹 채팅 가능)
Meta의 Quest VR 헤드셋에서 실시간 방송하기
게임을 Twitch로 직접 방송하기 (저지연)

면책 조항

저는 20년 동안 풀스택 개발자로 일한 경력이 있지만 게임 개발자는 아니라는 점을 말씀드리고 싶습니다. 앞으로 제작할 모든 것들은 Unity Hub에서 제공되는 기존 데모 게임을 기반으로 합니다. 나는 이 데모를 만드는 데 많은 시간을 보냈지만, Unity를 사용하여 게임을 만드는 것과 관련하여 나에게 익숙하지 않은 몇 가지 개념들이 있을 수 있습니다. 최선을 다해 설명하겠지만, 기억해주세요 - 저는 게임 개발🎮 전문가가 아닙니다!

사전 요구 사항

이 시리즈를 따라 저와 함께 빌드하려면 Unity Hub를 설치해야 합니다. 또한 실시간 Stage를 생성하고 해당 Stage로 브로드캐스팅하는 데 필요한 토큰과 이 시리즈에서 사용할 수 있는 기타 리소스를 생성할 AWS 계정이 필요합니다.

요약

이 시리즈에서는 다룰 내용이 많으며 모두 매우 흥미로운 내용입니다. 이 시리즈를 마치면, 매력적이고 인터랙티브하며 역동적인 라이브 스트리밍 플랫폼을 만들어서 이것을 Unity로 만든 게임에 통합할 준비가 될 것입니다. 다음 포스팅으로 이동해서 15분 정도 사용하여 게임을 브로드캐스팅하는 방법을 배워보세요!

OBS에서 WHIP을 사용하여 Amazon IVS 실시간 스트림으로 브로드캐스팅하기 (Broadcasting to an Amazon IVS Real-Time Stream with WHIP from OBS)

Junpyeong Kim — Wed, 24 Apr 2024 08:48:31 +0000

이 블로그 포스트는 Todd Sharp(Amazon IVS Developer Evangelist)이 포스팅한 Broadcasting to an Amazon IVS Real-Time Stream with WHIP from OBS의 한국어 번역입니다.
(This is the Korean translation of Amazon IVS Developer Evangelist, Todd Sharp's Broadcasting to an Amazon IVS Real-Time Stream with WHIP from OBS.)

최근까지 Amazon IVS(Amazon Interactive Video Service) 실시간 Stage로 브로드캐스팅하려면 개발자가 IVS Broadcast SDK(웹 및 모바일) 중 하나를 활용해야 했습니다. 내부적으로, SDK는 사용자의 연결을 초기화하고 사용자의 비디오를 Stage로 브로드캐스팅하는데 필요한 모든 로직을 추상화하고 있습니다. SDK를 이용하면 개발자는 애플리케이션에 실시간 스트리밍 통합을 더 쉽게 할 수 하지만, 궁극적으로는 해당 Stage에 브로드캐스팅하는 최종 사용자 측면에서는 웹 및 모바일 기반 클라이언트 소프트웨어 사용으로만 선택권이 제한되게 됩니다. 이제 드디어, WHIP 호환 인코더 지원이 추가됨으로써 미디어를 실시간 Stage로 게시할 수 있게 되었습니다.

WHIP??

프로토콜 이름으로는 좀 이상하긴한데, 받아들일께요 🤷🏻‍♂️. 맞아요, 저는 이름 짓는 일을 담당하지 않아서 좋습니다. WHIP(WebRTC-HTTP Ingest Protocol)은 HTTP POST 요청을 사용하여 SDP(Session Description Protocol) offer와 answer의 일회성 교환 프로세스를 표준화하는 IETF 프로토콜입니다.

💡 SDP에 대해 잘 모르시나요? WebRTC for the Curious에서 'What is the Session Description Protocol (SDP)?'를 확인해보세요.

이름에서 짐작할 수 있듯이, WHIP 프로토콜은 Ingest(즉, 'Broadcasting' 또는 'Publish')만을 나타냅니다. Egress(즉, 'Viewing' 또는 'Subscribing')를 처리하는 WHEP라는 별도의 프로토콜이 있습니다. 불면증으로 고생하고 있다면 🥱, WHIP 또는 WHEP에 대한 IETF 초안을 전부 읽어보세요.

OBS를 사용하여 Amazon IVS Stage로 브로드캐스팅하기

OBS는 화면 전환, 오버레이, 간편한 화면 공유, 오디오 믹싱 등과 같은 고급 제작 기능으로 인해 널리 사용되고 있습니다. OBS에서 Amazon IVS Stage로 브로드캐스팅하려면 사용자는 OBS 버전 30 이상과 Stage 참여자 토큰이 필요합니다. 토큰의 만료 시간은 일반적으로 12시간(기본값)이지만 최대 14일까지 연장할 수 있습니다.

사용해 보려면, AWS SDK, AWS CLI, 또는 Amazon IVS 관리 콘솔을 통해 Stage 참가자 토큰을 생성하고 OBS의 'Settings' 대화 상자로 이동합니다.

'Stream' 탭에서 'Service'로 'WHIP'을 선택하고, 'Server'에 https://global.whip.live-video.net을 입력한 다음, 유효한 Stage 참가자 토큰을 'Bearer Token'에 붙여 넣습니다.

참고: OBS는 WHIP 브로드캐스팅에 Opus 오디오 인코딩이 필요하다고 경고할 것입니다. 이는 예상되었던 것이므로, 계속하려면 'Yes'를 선택하세요.

다음으로, 'Output' 탭으로 이동하여 'Output Mode'가 'Advanced'으로 설정되어 있는지 확인하세요.

최상의 성능을 위해 'Bitrate'를 2500 Kbps 이하로 설정하고, 'Keyframe Interval'은 1s 또는 2s를 사용하고, 'CPU Usage Preset'은 ultrafast로, 'Tune'을 zerolatency로 설정하세요.

이제 'Settings' 대화 상자를 종료하고 'Start Streaming'을 클릭하면 Stage로 브로드캐스팅을 시작하게 됩니다.

좀 더 자세한 내용은 OBS and WHIP Support 문서를 참조하세요.

GStreamer를 사용하여 Amazon IVS Stage로 브로드캐스팅하기

여러분이 오픈 소스 멀티미디어 프레임워크인 GStreamer의 팬이라면, GStreamer에서도 역시 WHIP 지원을 이용할 수 있습니다. 다음은 웹캠과 마이크를 Stage에 게시하는 데 사용할 수 있는 간단한 파이프라인입니다. 이 파이프라인은 MacOS에서 테스트되었지만, 지원되는 모든 OS에 적용될 수 있습니다. 참가자 토큰을 가져와서 IVS_STAGE_TOKEN에 설정해야 합니다. (또는 토큰을 복사하여 붙여넣어도 됩니다)

gst-launch-1.0 \
  avfvideosrc device-index=0 \
  ! videoconvert \
  ! x264enc tune=zerolatency bitrate=2500 speed-preset=ultrafast \
  ! rtph264pay \
  ! 'application/x-rtp,media=video,encoding-name=H264,payload=97,clock-rate=90000,width=1280,height=720,framerate=30/1' \
  ! whip.sink_0 autoaudiosrc wave=4 \
  ! audioconvert \
  ! opusenc \
  ! rtpopuspay \
  ! 'application/x-rtp,media=audio,encoding-name=OPUS,payload=96,clock-rate=48000,encoding-params=(string)2' \
  ! whip.sink_1 \
  whipsink \
  name=whip \
  auth-token=$IVS_STAGE_TOKEN \
  whip-endpoint=https://global.whip.live-video.net/

요약

이번 포스팅에서는, WHIP 호환 인코더를 통해 Amazon IVS 실시간 Stage에 퍼블리싱하는 방법에 대해 알아보았습니다. 이러한 지원은 Amazon IVS를 통한 실시간 스트리밍에 대한 많은 가능성을 보여주고 있습니다. 자세한 내용은 OBS and WHIP Support의 Amazon IVS 실시간 사용자 가이드 페이지를 참조하세요. 사용 사례에 대한 질문이나 아이디어가 있으면 Todd Sharp's Broadcasting to an Amazon IVS Real-Time Stream with WHIP from OBS에 댓글을 남겨주세요!

Terraform을 이용해서 Amazon IVS Live Streams 및 Chat 배포하기 (Deploy Amazon IVS Live Streams and Chat with Terraform)

Junpyeong Kim — Tue, 31 Jan 2023 02:12:30 +0000

Disclaimer
이 블로그 포스트는 Amazon IVS Engineer인 Kevin Eady가 포스팅한 Deploy Amazon IVS Live Streams and Chat with Terraform의 한국어 번역 포스트입니다.
(This blog post is the Korean translation of Amazon IVS Engineer, Kevin Eady's Deploy Amazon IVS Live Streams and Chat with Terraform.)

IaC(Infrastructure as Code)는 사용자 인터페이스를 통해 직접하기 보다는, 코드를 통해 서비스 인프라를 관리하고 프로비저닝하는 방법입니다. 여기에는 서버, 로드 밸런서, 데이터베이스, 네트워크 구성 등과 같은 리소스가 포함될 수 있습니다.

코드를 사용하여 인프라를 관리함으로써 많은 팀들이 인프라의 버전을 제어하고 리소스 프로비저닝 및 관리를 보다 쉽게 자동화할 수 있습니다. 이는 보다 일관되고 예측 가능한 배포가 가능하므로 많은 팀이 있고 복잡한 인프라가 있는 대규모 조직에서 특히 유용할 수 있습니다. 또한 필요한 경우 변경 사항을 쉽게 롤백할 수 있습니다.

Hashicorp Terraform은 인프라를 안전하고 효율적으로 구축, 변경 및 버전 관리하기 위한 오픈 소스 도구입니다. Terraform은 AWS Provider를 통해 AWS 리소스를 비롯한 다양한 리소스 유형을 관리하는 데 사용할 수 있습니다. 이 블로그 포스트에서는 Terraform 설치, Amazon IVS(Interactive Video Service) 채널 생성, Amazon S3(Simple Storage Service)에 녹화하기, 채널 보호 활성화 및 IVS 채팅방 생성 과정을 안내합니다.

Terraform 설치

시작하려면 Terraform tutorial의 가이드에 따라 Terraform을 설치합니다. 이렇게 하면 terraform 커맨드라인 인터페이스(CLI)를 사용하여 HCL(HashiCorp Configuration Language)로 작성된 코드를 사용하여 인프라를 배포할 수 있습니다.

AWS 계정 생성

Amazon IVS를 사용하려면 계정이 있어야 합니다. Amazon은 현재 AWS Free Tier for Amazon IVS에 따라 Amazon IVS 무료 평가판을 제공합니다(매월 기본 입력 5시간 및 SD 비디오 출력 100시간 - 그 외 다수).

프로덕션 애플리케이션에서 Amazon IVS를 실행하는 데 드는 비용이 궁금하십니까? Amazon IVS Cost Estimator를 확인하세요!

AWS Terraform Provider 사용

Terraform은 Provider를 사용하여 API와의 상호 작용을 가능하게 합니다. Terraform AWS Provider 설명서는 AWS 인증 및 리전 선택과 같은 Provider 구성에 대한 세부 정보를 제공합니다. 또한 자격 증명 사용에 대한 가이드와 모범 사례를 제공합니다.

Amazon IVS에 Terraform 사용하기

Terraform은 다음 리소스 및 데이터 소스를 사용하여 AWS Terraform Provider 버전 v4.40.0부터 IVS를 완벽하게 지원합니다.

Channels: aws_ivs_channel
Playback Key Pairs: aws_ivs_playback_key_pair
Recording Configurations: aws_ivs_recording_configuration
Stream Key: aws_ivs_stream_key

IVS Channel 만들기

aws_ivs_channel 리소스는 S3에 저장하기 또는 재생 권한 부여 등 채널 속성을 구성하기 위한 많은 인수를 지원합니다.이 리소스는 Ingest endpoint(ingest_endpoint)와 Playback URL(playback_url) 등의 출력 속성도 가지고 있습니다.

terraform {
  required_version = ">= 0.12"
}

provider "aws" {
  region = "us-west-2"
}

resource "aws_ivs_channel" "example" {
  type = "BASIC"
}

data "aws_ivs_stream_key" "example" {
  channel_arn = aws_ivs_channel.example.arn
}

output "ingest_endpoint" {
  value = aws_ivs_channel.example.ingest_endpoint
}

output "stream_key" {
  value = data.aws_ivs_stream_key.example.value
}

output "playback_url" {
  value = aws_ivs_channel.example.playback_url
}

참고: AWS Free Tier에는 Basic 채널 유형만 적용됩니다.

terraform apply를 통해 이 구성을 적용할 때 Terraform은 인프라 Plan을 표시하고 구성을 적용하려면 "yes"라는 사용자 입력을 필요로 합니다. 이렇게 Plan을 적용하고 나면 출력변수들(ingest_endpoint, stream_key 및 playback_url)이 표시되는것을 볼 수 있습니다.

➜  terraform apply

Terraform used the selected providers to generate the following execution plan. Resource actions are indicated with the following symbols:
 + create
<= read (data resources)

Terraform will perform the following actions:

 # data.aws_ivs_stream_key.example will be read during apply
 # (config refers to values not yet known)
<= data "aws_ivs_stream_key" "example" {
     + arn         = (known after apply)
     + channel_arn = (known after apply)
     + id          = (known after apply)
     + tags        = (known after apply)
     + value       = (known after apply)
   }

 # aws_ivs_channel.example will be created
 + resource "aws_ivs_channel" "example" {
     + arn                         = (known after apply)
     + authorized                  = (known after apply)
     + id                          = (known after apply)
     + ingest_endpoint             = (known after apply)
     + latency_mode                = (known after apply)
     + name                        = (known after apply)
     + playback_url                = (known after apply)
     + recording_configuration_arn = (known after apply)
     + tags_all                    = (known after apply)
     + type                        = (known after apply)
   }

Plan: 1 to add, 0 to change, 0 to destroy.

Changes to Outputs:
 + ingest_endpoint = (known after apply)
 + playback_url    = (known after apply)
 + stream_key      = (known after apply)

Do you want to perform these actions?
 Terraform will perform the actions described above.
 Only 'yes' will be accepted to approve.

 Enter a value: yes

aws_ivs_channel.example: Creating...
aws_ivs_channel.example: Creation complete after 3s [id=arn:aws:ivs:us-west-2:326937407773:channel/EmVV0KxDONIR]
data.aws_ivs_stream_key.example: Reading...
data.aws_ivs_stream_key.example: Read complete after 1s [id=arn:aws:ivs:us-west-2:326937407773:stream-key/0Dy6pn6CQhMx]

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

Outputs:

ingest_endpoint = "a447f74b0a52.global-contribute.live-video.net"
playback_url = "https://a447f74b0a52.us-west-2.playback.live-video.net/api/video/v1/us-west-2.326937407773.channel.EmVV0KxDONIR.m3u8"
stream_key = "sk_us-west-xxxxxxxxxxxxx"

ingest_endpoint와 stream_key를 가지고 Amazon IVS - Web Broadcast Tool로 이동하여 스트리밍을 시작합니다. 페이지 하단 근처에 있는 "Open settings" 톱니바퀴 아이콘을 클릭합니다…

... Ingest endpoint와 Stream key를 입력합니다.

"Save"을 클릭한 다음 "Start Streaming" 버튼을 클릭합니다.

... 그러면 당신의 스트림이 시작됩니다!

스트림을 보려면 Amazon IVS Player Tester로 이동하세요. 오른쪽 상단 모서리에 있는 톱니바퀴 아이콘을 클릭합니다.

... 그리고 IVS Player를 추가합니다.

재생 URL을 입력하고 "Load" 버튼을 클릭하면 라이브 스트림 재생이 시작됩니다.

S3에 레코드를 추가하기 위해 IVS 채널을 수정

이 예제에서는 Recording Configuration에서 사용할 새로운 S3 Bucket과 대상 Bucket 및 Thumbnail 속성을 지정하는 Recording Configuration을 생성하고, 이전에 생성한 채널에 Recording Configuration을 할당합니다. 이전 예제 설정을 수정해 봅시다.

provider "aws" {
   region = "us-west-2"
 }
+
+resource "aws_s3_bucket" "example" {
+  bucket_prefix = "tf-ivs-stream-archive-"
+  force_destroy = true
+}
+
+resource "aws_ivs_recording_configuration" "example" {
+  name = "tf-ivs-recording-configuration"
+  lifecycle {
+    create_before_destroy = true
+  }
+  thumbnail_configuration {
+    recording_mode = "INTERVAL"
+    target_interval_seconds = 30
+  }
+  destination_configuration {
+    s3 {
+      bucket_name = aws_s3_bucket.example.id
+    }
+  }
+}
+
 resource "aws_ivs_channel" "example" {
  type = "BASIC"
+  recording_configuration_arn = aws_ivs_recording_configuration.example.arn
 }

 data "aws_ivs_stream_key" "example" {

참고: create_before_destroy lifecycle 옵션은 Recording Configuration이 삭제되어야 하는 설정 수정이 발생할 경우에 필요합니다. 왜냐하면, Recording Configuration은 in-place 수정이 불가하고 수정 사항이 존재하는 경우 재생성되어야 하기 때문입니다. Recording Configuration은 채널에서 사용하는 동안 삭제할 수 없으므로, 이 옵션(후속 수정 시)은 이전 Recording Configuration을 삭제하기 전에 새로운 Recording Configuration으로 채널을 업데이트합니다.

스트리밍하는 동안 IVS는 생성된 S3 Bucket 내부에 스트림을 저장합니다. 자세한 내용은 Auto-Record to Amazon S3 - Amazon Interactive Video Service를 참조하십시오.

참고: 라이브 상태인 채널은 수정할 수 없습니다. Terraform은 라이브 상태인 채널을 수정하려고 시도하는 경우 Unable to perform: ivs:UpdateChannel while resource: <arn> is live처럼 적절한 오류를 보고합니다.

재생 권한 부여 기능을 가지는 IVS Channel 만들기

이 예제에서는 Amazon Key Management Service(KMS)를 사용하여 새로운 비대칭 키 쌍을 생성 후, 여기서 생성된 공개 키를 사용하여 새로운 Playback Key Pair를 생성하고, 마지막으로 인증 권한이 추가된 채널을 생성합니다:

resource "aws_kms_key" "example" {
  description              = "KMS Key for IVS Playback"
  key_usage                = "SIGN_VERIFY"
  customer_master_key_spec = "ECC_NIST_P384"
}

data "aws_kms_public_key" "example" {
  key_id = aws_kms_key.example.key_id
}

resource "aws_ivs_playback_key_pair" "example" {
  name       = "tf-ivs-playback-key-pair"
  public_key = data.aws_kms_public_key.example.public_key_pem
}

resource "aws_ivs_channel" "example" {
  name       = "tf-ivs-playback-key-pair-example"
  authorized = true
}

인증 권한이 추가된 채널은 재생 URL에 JWT token URL 파라미터 추가를 요구합니다. Generate and Sign Playback Tokens에서 자세한 내용을 확인하십시오.

다음은 서명된 URL을 생성하는 Node.js(v18) 콘솔 스크립트의 예제입니다. 이 스크립트는 npm 또는 yarn을 통해 설치된 다음의 노드 모듈을 필요로 합니다.

이 스크립트는 keyId, channelArn, 그리고 만료 시간을 나타내는 expiresIn을 인수로 사용합니다. Terraform 설정(terraform show를 사용하거나 설정 파일에 출력을 추가하여 확인 가능)을 통해서 생성된 인프라에 대해서 아래 스크립트를 실행하면 유효한 토큰이 추가된 재생 URL이 반환됩니다.

➜  node create-playback-url-with-token.mjs \
  --keyId 3df50d5f-054a-4f20-88c6-bb7a73306dd0 \
  --channelArn arn:aws:ivs:us-west-2:326937407773:channel/aVbMPCM9Il2x \
  --expiresIn 30

https://a447f74b0a52.us-west-2.playback.live-video.net/api/video/v1/us-west-2.326937407773.channel.aVbMPCM9Il2x.m3u8?token=eyJhbGciOiJFUzM4NCIsInR5cCI6IkpXVCJ9.eyJhd3M6Y2hhbm5lbC1hcm4iOiJhcm46YXdzOml2czp1cy13ZXN0LTI6MzI2OTM3NDA3NzczOmNoYW5uZWwvYVZiTVBDTTlJbDJ4IiwiYXdzOmFjY2Vzcy1jb250cm9sLWFsbG93LW9yaWdpbiI6IiIsImV4cCI6MTY3MzI3MzY5NCwiaWF0IjoxNjczMjczNjY0fQ.YAvlvVdO3rAq-7K3KHRPBvN1sU-JXJZ2963_thbaHBlBaYfyGYGAiqdJEN8XraEm3uc-h8NZiea8o0_XlOCHWIh9F1TGI1hSPqD7YY757C0ZF5cNsyBU49-sPbPvqpqa

IVS Chat에 Terraform 사용하기

Terraform은 다음 리소스 및 데이터 소스를 사용하여 AWS Terraform Provider 버전 v4.41.0부터 IVS Chat을 완벽하게 지원합니다.

Logging Configuration: aws_ivschat_logging_configuration
Room: aws_ivschat_room

IVS Chat Room 만들기

IVS Chat Room은 ivschat_room 리소스를 사용하여 쉽게 생성할 수 있습니다.

resource "aws_ivschat_room" "example" {
}

이렇게 생성된 Chat Room은 Amazon IVS Chat과 함께 사용할 수 있습니다. 좀 더 상세한 정보를 위해 Getting Started with Amazon IVS Chat과 이전에 생성된 리소스들을 사용하여 채팅 기능을 검증하는 Amazon IVS Chat Web Demo도 살펴보시기 바랍니다.

Message Handler가 추가된 IVS Chat Room 만들기

IVS Chat Message Review Handler는 채팅 메시지 전송 전에 메시지 수정 또는 메시지 전송 거부를 가능하도록 하는 Lambda Function입니다. 이 예제에서는 Lambda Function, IVS Chat이 Lambda Function을 실행가능하도록 하는 IAM Role, 그리고 여기서 생성한 Lambda Function을 Message Review Handler로 사용하는 IVS Chat Room을 생성합니다.

// index.js

/** IVS Chat message review handler */
exports.handler = async function ({ Content }) {
    return {
        ReviewResult: "ALLOW",
        Content: `${Content} - edited by Lambda`
    };
}

# main.tf

data "aws_region" "current" {}

data "aws_caller_identity" "current" {}

resource "aws_iam_role" "example" {
  name               = "tf-ivschat-message-handler-role"
  assume_role_policy = <<EOF
{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": ["sts:AssumeRole"],
        "Principal": {"Service": "lambda.amazonaws.com"}
    }]
}
EOF
}

data "archive_file" "message_review_handler" {
  type        = "zip"
  source_file = "${path.module}/index.js"
  output_path = "${path.module}/lambda-handler.zip"
}

resource "aws_lambda_function" "example" {
  filename         = data.archive_file.message_review_handler.output_path
  function_name    = "tf-ivschat-message-handler"
  role             = aws_iam_role.example.arn
  source_code_hash = data.archive_file.message_review_handler.output_base64sha256
  runtime          = "nodejs18.x"
  handler          = "index.handler"
}

resource "aws_lambda_permission" "example" {
  action         = "lambda:InvokeFunction"
  function_name  = aws_lambda_function.example.function_name
  principal      = "ivschat.amazonaws.com"
  source_account = data.aws_caller_identity.current.account_id
  source_arn     = "arn:aws:ivschat:${data.aws_region.current.name}:${data.aws_caller_identity.current.account_id}:room/*"
}

resource "aws_ivschat_room" "example" {
  name       = "tf-ivschat-room"
  depends_on = [aws_lambda_permission.example]

  message_review_handler {
    uri             = aws_lambda_function.example.arn
    fallback_result = "ALLOW"
  }
}

Logging이 가능한 IVS Chat Room 만들기

IVS Chat은 S3 Bucket 또는 CloudWatch와 같은 다양한 유형의 대상에 채팅 메시지를 Logging할 수 있도록 지원합니다. 이 예제에서는 Logging Configuration에 사용할 S3 Bucket을 생성하고, 이전에 생성한 Room에 Logging Configuration을 할당합니다:

resource "aws_s3_bucket" "example" {
  bucket_prefix = "tf-ivschat-logging-"
  force_destroy = true
}

resource "aws_ivschat_logging_configuration" "example" {
  name = "tf-ivschat-logging-configuration"
  destination_configuration {
    s3 {
      bucket_name = aws_s3_bucket.example.id
    }
  }
}

resource "aws_ivschat_room" "example" {
  name                              = "tf-ivschat-room"
  logging_configuration_identifiers = [aws_ivschat_logging_configuration.example.arn]
}

마무리

Terraform을 사용해서도, 개발자는 설정 파일을 생성해서 IVS 및 IVS Chat 리소스의 배포를 관리할 수 있습니다. IaC를 사용하면 개발팀에 버전 제어, 공동 작업, 재사용성 및 재해 복구와 같은 여러 가지 이점을 제공할 수 있습니다. Amazon IVS 및 IVS Chat과 관련된 모든 기능을 살펴보려면 Amazon IVS 사용 설명서를 살펴보십시오.