Retroceder uma Viagem para um carimbo de data/hora de vídeo especificado e retomar a execução a partir do ponto real de aterrissagem. A Viagem deve primeiro entrar no estado pausado.
Escopo
Retroceder uma Viagem para um carimbo de data/hora de vídeo especificado e retomar a execução a partir do ponto real de aterrissagem. Antes de chamar, confirme o seguinte:
- Autenticação: A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-la. Para saber como obtê-las, veja Obter credenciais de autenticação.
- Pré-requisitos: A Viagem deve primeiro entrar no estado
paused; ela não pode ser retrocedida diretamente enquanto estiverrunning. Confirm via Consultar Status da Viagem. - Chamador: Tanto seu servidor quanto seu cliente podem fazer a chamada.
Solicitação HTTP
- Singapore
- EUA (Virgínia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewindSubstitua {WorkspaceId} pelo seu ID do Workspace real.Parâmetros da solicitação |
|
Content-Typestring(Obrigatório)Tipo de conteúdo da solicitação. Este parâmetro deve ser definido como application/json. | |
Authorization string (Obrigatório)Autenticação por Chave de API. A Chave de API primária não é obrigatória; tanto a chave primária quanto uma temporária podem chamá-lo.
| |
Corpo da solicitação | |
encryptedTravelId string (Obrigatório)O ID de Viagem criptografado do Directing a ser retrocedido. Retornado por Entrar na Viagem. | |
rewindToSec number (Obrigatório)O tempo alvo do vídeo, em segundos. Maior ou igual a 0; um múltiplo de 4 é recomendado (como 4, 8, 12). O servidor o arredonda para o limite de 4 segundos mais próximo usando Math.round(rewindToSec / 4) × 4. O ponto real de aterrissagem é determinado por resumedAtSec / actualRewindToSec na resposta.userAgent string (Opcional)Identificador de versão do SDK ou cliente. Uma string não vazia; tem precedência sobre o User-Agent HTTP. |
Parâmetros de resposta |
|
code integerCódigo de retorno. 0 indica sucesso; diferente de zero é um código de erro. | |
message stringMensagem de erro. null em caso de sucesso. | |
data objectDados da resposta. null em caso de falha.
Propriedades encryptedTravelId stringO Travel ID criptografado.status stringO status após a conclusão do retrocesso; retorna running.resumedAtSec numberO número real de segundos em que a reprodução é retomada; pode desviar ligeiramente do valor solicitado.actualRewindToSec numberO ponto real de aterrissagem do retrocesso; idêntico a resumedAtSec. |
Estados pré-requisitos e notas de chamada
- A Viagem deve primeiro entrar em
paused; ela não pode ser retrocedida diretamente enquanto estiverrunning. - Pausar Viagem tem uma barreira de confirmação assíncrona de cerca de 3 segundos. Após receber a resposta de pausa, você ainda deve fazer polling em Consultar Status da Viagem e confirmar se o status visível externamente já é
pausedantes de chamar este endpoint. - O script é organizado em Blocos de 4 segundos; um múltiplo de 4, como 4, 8 ou 12, é recomendado para
rewindToSec(por exemplo,6 → 8). - O ponto real de aterrissagem é determinado por
resumedAtSec/actualRewindToSec.
Códigos de erro
Se a chamada do modelo falhar e retornar um erro, consulte Códigos de Erro do HappyOyster para resolvê-lo.
Próximos passos
Após o retrocesso, a Viagem retorna a running:
- Consultar Status da Viagem: confirmar o status de execução.
- Modo padrão: Enviar Instrução de Processo.
- Pausar Viagem: pausar novamente para o próximo retrocesso.
- Encerrar Viagem: encerrar a sessão e processar os artefatos.