V1에서 V2로 마이그레이션 가이드

주요 변경 사항

• TTL은 더 이상 유효한 옵션이 아닙니다. 모든 요청에 이력을 사용해야 합니다.
• 이제 API는 스토리지용 GCP 버킷을 지원합니다.
• API가 더욱 편안하게 재설계되었습니다:
  • 상태 완료 파일은 이제 콜백 서버로 대체되었습니다.
• 이제 SSR에서는 Unity Cloud 조직의 서비스 계정을 사용해야 합니다.
• 중복 제거 기능이 삭제되었습니다. 중복된 요청에 대해

  409

  오류 코드가 더 이상 표시되지 않습니다.
• 자동 종료 기능이 제거되었습니다. 요청은 항상 이력 요청의 전체 기간 동안 실행됩니다.
• 더 이상 오디오 디코드를 요청할 필요가 없습니다. Vivox가 상태를 관리하며 최종 제품은 채널의 스피커당 .WAV 파일 1개입니다.

Authentication 변경 사항

1. 이제 SSR에서는 모든 요청에 ​​대해 Unity Authentication을 사용해야 합니다.
   • 조직이나 프로젝트를 생성하지 않은 경우 하나를 생성합니다. 자세한 내용은 프로젝트 생성 방법 을 참고하시기 바랍니다.
2. 프로젝트와 조직이 정해지면 해당 세부 정보를 세일즈 담당자와 공유해야 합니다. 그러면 세일즈 담당자가 조직에서 SSR을 활성화합니다.
3. SSR을 활성화하면 API로 인증할 서비스 계정을 생성해야 합니다. 서비스 계정 생성 방법을 참고하시기 바랍니다.
4. 서비스 계정 페이지에서 서비스 계정에 권한을 할당합니다. Manage organization permissions를 선택하고

   Server Side Recording Processor Role

   을 할당합니다. 그러면 이 서비스 계정이 SSR API에 액세스할 수 있습니다.

   

5. 이 서비스 계정을 사용하려면 서비스 계정으로 인증하는 방법을 참고하시기 바랍니다.

API 변경 사항

요청 변경 사항

1. 이제

   destination_credentials

   가

   storageOptions

   에 포함됩니다. V1 API와 동일한 방식으로 AWS를 사용하려면 특정 코드 세그먼트를 교체해야 합니다.

   이 코드 교체	코드 교체 결과
   { "destination_credentials": { "bucket": "my-bucket", "access_key_id": "secret", "secret_access_key": "secret" } }	{ "storageOptions": { "provider": "aws", "credentials": { "bucket": "my-bucket", "accessKeyId": "secret", "secretAccessKey": "secret" } } }

2. target_type

   필드를 제거합니다. V2 API는 채널 구독만 지원합니다.

3. ttl

   필드가 제거되었습니다.

   history

   필드를 사용하여 녹음 기간을 지정합니다.

callbackUri

SSR 디코더

콜백 서버

status_complete

status_decoded