Rembobiner un Voyage à un horodatage vidéo spécifié et reprendre l'exécution depuis le point d'atterrissage réel. Le Voyage doit d'abord entrer dans l'état paused.
Scope
Rembobiner un Voyage à un horodatage vidéo spécifié et reprendre l'exécution depuis le point d'atterrissage réel. Avant d'appeler, confirmez les points suivants :
- Authentification : La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler. Pour savoir comment les obtenir, voir Obtenir les identifiants d'authentification.
- Prérequis : Le Voyage doit d'abord entrer dans l'état
paused; il ne peut pas être rembobiné directement pendantrunning. Confirm via Interroger le statut du voyage. - Appelant : Votre serveur ou votre client peut l'appeler.
Requête HTTP
- Singapore
- États-Unis (Virginie)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewindRemplacez {WorkspaceId} par votre véritable ID d'espace de travail.Paramètres de la requête |
|
Content-Typestring(Requis)Type de contenu de la requête. Ce paramètre doit être défini sur application/json. | |
Authorization string (Requis)Authentification par clé API. La clé API principale n'est pas requise ; la clé principale ou une clé API temporaire peut l'appeler.
| |
Corps de la requête | |
encryptedTravelId string (Obligatoire)L'ID de Voyage chiffré Directing à rembobiner. Retourné par Entrer dans le voyage. | |
rewindToSec number (Obligatoire)Le temps vidéo cible, en secondes. Supérieur ou égal à 0 ; un multiple de 4 est recommandé (tel que 4, 8, 12). Le serveur l'arrondit à la limite de 4 secondes la plus proche en utilisant Math.round(rewindToSec / 4) × 4. Le point d'atterrissage réel est déterminé par resumedAtSec / actualRewindToSec dans la réponse.userAgent string (Facultatif)Identifiant de version du SDK ou du client. Une chaîne non vide ; prévaut sur le User-Agent HTTP. |
Paramètres de réponse |
|
code integerCode de retour. 0 indique un succès ; une valeur non nulle correspond à un code d'erreur. | |
message stringMessage d'erreur. null en cas de succès. | |
data objectDonnées de réponse. null en cas d'échec.
Propriétés encryptedTravelId stringL'identifiant de voyage chiffré.status stringLe statut après la fin du rembobinage ; retourne running.resumedAtSec numberLe nombre réel de secondes auquel la lecture reprend ; il peut s'écarter légèrement de la valeur demandée.actualRewindToSec numberLe point d'atterrissage réel du rembobinage ; identique à resumedAtSec. |
États préalables et notes d'appel
- Le Voyage doit d'abord entrer en
paused; il ne peut pas être rembobiné directement pendantrunning. - Mettre le voyage en pause a une barrière de confirmation asynchrone d'environ 3 secondes. Après avoir reçu la réponse de pause, vous devez continuer à poller Interroger le statut du voyage et confirmer que le statut visible extérieurement est déjà
pausedavant d'appeler ce point de terminaison. - Le script est organisé en Blocs de 4 secondes ; un multiple de 4 tel que 4, 8 ou 12 est recommandé pour
rewindToSec(par exemple,6 → 8). - Le point d'atterrissage réel est déterminé par
resumedAtSec/actualRewindToSec.
Codes d'erreur
Si l'appel du modèle échoue et renvoie une erreur, consultez Codes d'erreur HappyOyster pour la résoudre.
Étapes suivantes
Après le rembobinage, le Voyage revient à running :
- Interroger le statut du voyage : confirmer le statut d'exécution.
- Mode standard : Envoyer une instruction de processus.
- Mettre le voyage en pause : mettre à nouveau en pause pour le prochain rembobinage.
- Terminer le voyage : terminer la session et traiter les artefacts.