Documentation

Support

Vivox Unity SDK

Vivox Unity SDK

Callback server

Set up a callback server for Vivox server-side recording.
Read time 1 minuteLast updated 2 days ago

SSR provides a callback mechanism to notify you when a recording job is complete. This allows you to take action on the recording once it is complete.

Set up a callback server

  1. To set up a callback server, you need to create a server that can receive a POST request from the SSR API. The request will contain a JSON payload with the job's status.
  2. SSR makes a request to any URL in the
    callbackUri
    field of the request. If you specify a
    callbackKey
    Vivox includes this in the header of the request under
    Authorization
    .

Callback payload

The payload of the callback contains the following fields:
{ "job_status": "string", "job_id": "string", "code": "string", "metadata": "object"}
  • job_status
    will either be
    complete
    ,
    fail
    , or
    partial
    .
    • When a job is
      partial
      , this means that not all of the audio recorded or decoded successfully.
  • job_id
    is the ID of the job. It corresponds to
    job_id
    in the response of the original request.
  • code
    is the error code if the job failed. Refer to error codes for more information.
  • metadata
    is any metadata you passed in the original request. If you did not set any
    metadata
    this field will be omitted from the request.

Error codes

Code

Description

2001Service is not enabled.
2002Internal service error.
2003No audio was found for the channel requested.
2004Invalid Storage.
2005Internal service error.
2006No audio decoded due to
filterUri
parameters.
2103Unsupported audio format.
2107AWS bucket is throttled.