Skip to main content

Referencia de la API HappyOyster-Directing-Rewind Travel

Rebobinar un Travel a una marca de tiempo de video especificada y reanudar la ejecución desde el punto de aterrizaje real. El Travel debe entrar primero en el estado de pausa.

Ámbito

Rebobinar un Travel a una marca de tiempo de video especificada y reanudar la ejecución desde el punto de aterrizaje real. Antes de llamar, confirme lo siguiente:
  • Autenticación: La clave de API principal no es obligatoria; pueden invocarla tanto la clave principal como una temporal. Para saber cómo obtenerlas, consulte Obtener credenciales de autenticación.
  • Prerequisites: El Travel debe entrar primero en el estado paused; no se puede rebobinar directamente mientras está en running. Confirm mediante Query Travel Status.
  • Solicitante: Puede invocarla su servidor o su cliente.

Solicitud HTTP

  • Singapore
  • EE. UU. (Virginia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewindReemplace {WorkspaceId} con su ID de espacio de trabajo real.

Parámetros de solicitud

  • Rewind Travel
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewind' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "encryptedTravelId": "{encryptedTravelId}",
    "rewindToSec": 84.0,
    "userAgent": "your-client/1.2.0"
}'
Content-Typestring(Requerido)Tipo de contenido de la solicitud. Este parámetro debe establecerse en application/json.
Authorization string (Requerido)Autenticación mediante clave de API. No se requiere la clave de API principal; pueden invocarla tanto la clave principal como una temporal.
  • Clave de API principal: comienza con sk-, por ejemplo, sk-xxx.
  • Clave de API temporal: comienza con st-, por ejemplo, st-xxx.
Cuerpo de la solicitud
encryptedTravelId string (Obligatorio)El ID de Travel cifrado de Directing a rebobinar. Devuelto por Enter Travel.
rewindToSec number (Required)El tiempo de video objetivo, en segundos. Mayor o igual a 0; se recomienda un múltiplo de 4 (como 4, 8, 12). El servidor lo redondea al límite de 4 segundos más cercano usando Math.round(rewindToSec / 4) × 4. El punto de aterrizaje real está determinado por resumedAtSec / actualRewindToSec en la respuesta.userAgent string (Opcional)Identificador de versión del SDK o del cliente. Una cadena no vacía; tiene prioridad sobre el User-Agent HTTP.

Parámetros de respuesta

  • Rebobinado exitoso
{
    "code": 0,
    "message": null,
    "data": {
        "encryptedTravelId": "trvl_a1b2****",
        "status": "running",
        "resumedAtSec": 84.0,
        "actualRewindToSec": 84.0
    }
}
code integerCódigo de retorno. 0 indica éxito; un valor distinto de cero es un código de error.
message stringMensaje de error. null en caso de éxito.
data objectDatos de respuesta. null en caso de fallo.

Propiedades

encryptedTravelId stringEl ID de viaje cifrado.status stringEl estado después de que se completa el rebobinado; devuelve running.resumedAtSec numberEl número real de segundos en el que se reanuda la reproducción; puede desviarse ligeramente del valor solicitado.actualRewindToSec numberEl punto de aterrizaje real del rebobinado; idéntico a resumedAtSec.

Estados previos y notas de llamada

  • El Travel debe entrar primero en paused; no se puede rebobinar directamente mientras está en running.
  • Pause Travel tiene una barrera de confirmación asíncrona de aproximadamente 3 segundos. Después de recibir la respuesta de pausa, aún debe sondear Query Travel Status y confirmar que el estado visible externamente ya es paused antes de llamar a este endpoint.
  • El script está organizado en Bloques de 4 segundos; se recomienda un múltiplo de 4 como 4, 8 o 12 para rewindToSec (por ejemplo, 6 → 8).
  • El punto de aterrizaje real está determinado por resumedAtSec / actualRewindToSec.

Códigos de error

Si la llamada al modelo falla y devuelve un error, consulte Códigos de error de HappyOyster para resolverlo.

Siguientes pasos

Después del rebobinado, el Travel vuelve a running: