기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Vivox Unity SDK

Vivox Unity SDK

Vivox
​
​
Vivox Unity SDK
  • Overview
  • Get started
  • Release notes
  • Developer guide
    • Set up your project
    • Create voice and text channels
    • Messaging
    • Player management
    • Device management
    • Audio management
    • Mobile development
    • Text-to-speech
    • Speech-to-text
    • Real-time recording
    • Server-side-recording
      • Migrate from V1 to V2
      • Callback Server
    • Troubleshooting
  • Tutorials
  • Reference
  1. Vivox Unity SDK 기술 자료
  3. 서버 측 녹음

콜백 서버

Set up a callback server for Vivox server-side recording.
읽는 시간 1분
최근 업데이트: 8달 전
SSR은 녹음 작업이 완료되면 알려 주는 콜백 메커니즘을 제공합니다. 이렇게 하면 녹음이 완료되었을 때 조치를 취할 수 있습니다.

콜백 서버 설정

  1. 콜백 서버를 설정하려면 SSR API에서 POST 요청을 수신할 수 있는 서버를 생성해야 합니다. 요청에는 작업 상태가 포함된 JSON 페이로드가 포함됩니다.
  2. SSR은 요청의 
    callbackUri
    필드에 있는 모든 URL에 요청을 보냅니다. 
    callbackKey
    를 지정하면 Vivox는 이를 
    Authorization
    아래 요청 헤더에 포함합니다.

콜백 페이로드

콜백 페이로드에는 다음 필드가 포함됩니다.
{    "job_status": "string",    "job_id": "string",    "code": "string",    "metadata": "object"}
  • job_status
    는 
    complete
    , 
    fail
    또는 
    partial
    입니다.
    • 작업 상태가 
      partial
      인 경우 모든 오디오가 성공적으로 녹음되거나 디코딩되지는 않았다는 의미입니다.
  • job_id
    는 작업의 ID입니다. 이는 원래 요청의 응답에서 
    job_id
    에 해당합니다.
  • code
    는 작업 실패 시 오류 코드입니다. 자세한 내용은 오류 코드를 참고하시기 바랍니다.
  • metadata
    는 원래 요청에서 전달한 메타데이터입니다. 
    metadata
    를 설정하지 않은 경우 이 필드는 요청에서 생략됩니다.

오류 코드

코드

설명

2001서비스가 활성화되어 있지 않습니다.
2002내부 서비스 오류입니다.
2003요청한 채널의 오디오를 찾을 수 없습니다.
2004유효하지 않은 스토리지입니다.
2005내부 서비스 오류입니다.
2006
filterUri
파라미터로 인해 오디오가 디코딩되지 않았습니다.
2103지원되지 않는 오디오 포맷입니다.
2107AWS 버킷이 제한되었습니다.
Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지

    • 콜백 서버 설정

    • 콜백 페이로드

    • 오류 코드

이 페이지의 문제 보고