Memutar ulang Travel ke stempel waktu video yang ditentukan dan melanjutkan operasi dari titik pendaratan yang sebenarnya. Travel harus terlebih dahulu memasuki status paused.
Cakupan
Memutar ulang Travel ke stempel waktu video yang ditentukan dan melanjutkan operasi dari titik pendaratan yang sebenarnya. Sebelum memanggil, pastikan hal berikut:
- Autentikasi: Kunci API utama tidak wajib; kunci API utama atau sementara dapat digunakan untuk memanggilnya. Untuk cara mendapatkannya, lihat Mendapatkan kredensial autentikasi.
- Prasyarat: Travel harus terlebih dahulu memasuki status
paused; tidak dapat diputar ulang secara langsung saatrunning. Confirm melalui Query Travel Status. - Pemanggil: Server atau klien Anda dapat memanggilnya.
Permintaan HTTP
- Singapore
- AS (Virginia)
POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v2/apps/happyoyster-1.0-directing/openapi/v1/travels/rewindGanti {WorkspaceId} dengan ID Workspace Anda yang sebenarnya.Parameter permintaan |
|
Content-Typestring(Wajib)Tipe konten permintaan. Parameter ini harus diatur ke application/json. | |
Authorization string (Wajib)Autentikasi Kunci API. Kunci API utama tidak wajib; kunci API utama atau sementara dapat digunakan untuk memanggilnya.
| |
Request Body | |
encryptedTravelId string (Wajib)ID Travel terenkripsi Directing yang akan diputar ulang. Dikembalikan oleh Enter Travel. | |
rewindToSec number (Wajib)Waktu video target, dalam detik. Lebih besar dari atau sama dengan 0; kelipatan 4 direkomendasikan (seperti 4, 8, 12). Server membulatkannya ke batas 4 detik terdekat menggunakan Math.round(rewindToSec / 4) × 4. Titik pendaratan yang sebenarnya ditentukan oleh resumedAtSec / actualRewindToSec dalam respons.userAgent string (Opsional)Pengidentifikasi versi SDK atau klien. String tidak kosong; didahulukan daripada HTTP User-Agent. |
Parameter respons |
|
code integerKode pengembalian. 0 berarti berhasil; bukan nol adalah kode kesalahan. | |
message stringPesan kesalahan. null jika berhasil. | |
data objectData respons. null jika gagal.
Properti encryptedTravelId stringID Travel yang terenkripsi.status stringStatus setelah pemutaran ulang selesai; mengembalikan running.resumedAtSec numberJumlah detik yang sebenarnya saat pemutaran dilanjutkan; mungkin sedikit menyimpang dari nilai yang diminta.actualRewindToSec numberTitik pendaratan pemutaran ulang yang sebenarnya; identik dengan resumedAtSec. |
Status prasyarat dan catatan pemanggilan
- Travel harus terlebih dahulu memasuki
paused; tidak dapat diputar ulang secara langsung saatrunning. - Pause Travel memiliki hambatan konfirmasi asinkron sekitar 3 detik. Setelah menerima respons jeda, Anda sebaiknya tetap melakukan polling Query Travel Status dan memastikan bahwa status yang terlihat secara eksternal sudah
pausedsebelum memanggil endpoint ini. - Skrip diatur dalam Block 4 detik; kelipatan 4 seperti 4, 8, atau 12 direkomendasikan untuk
rewindToSec(misalnya,6 → 8). - Titik pendaratan yang sebenarnya ditentukan oleh
resumedAtSec/actualRewindToSec.
Kode kesalahan
Jika pemanggilan model gagal dan mengembalikan kesalahan, lihat Kode Kesalahan HappyOyster untuk menyelesaikannya.
Langkah selanjutnya
Setelah pemutaran ulang, Travel kembali ke running:
- Query Travel Status: konfirmasi status berjalan.
- Mode standar: Send Process Instruction.
- Pause Travel: jeda lagi untuk pemutaran ulang berikutnya.
- End Travel: akhiri sesi dan proses artefak.