Cara mengontrol durasi video akhir - Intelligent Media Services

Kontrol durasi video yang dihasilkan dalam skenario editing reguler menggunakan track utama, MaxDuration, atau penyesuaian kecepatan otomatis.

Tetapkan track utama

Kapan menggunakan track utama

Saat Anda menggabungkan audio dengan video atau gambar yang durasinya tidak diketahui, menetapkan parameter waktu pada setiap klip bersifat melelahkan dan rentan kesalahan. Sebagai gantinya, tetapkan satu track sebagai main track. Layanan ini akan menyelaraskan semua track lain ke durasi track utama dan memotong track apa pun yang lebih panjang. Dengan demikian, Anda dapat menyelesaikan editing tanpa mengetahui durasi pasti setiap klip dan tanpa menetapkan In, Out, TimelineIn, atau TimelineOut pada setiap aset.

Cara mengonfigurasi track utama

Tetapkan MainTrack ke true pada track video atau audio dalam objek Timeline. Durasi video akhir akan mengikuti durasi track tersebut.

Setiap track yang lebih panjang dari track utama dipotong menjadi durasi track utama.
Hanya satu track utama yang diizinkan. Jika beberapa track memiliki MainTrack: true, track pertama yang berlaku.
Hanya track video dan audio yang dapat menjadi track utama.
Catatan
- Hanya satu track yang dapat ditentukan sebagai track utama dalam sebuah video. Jika beberapa track ditentukan sebagai track utama, track pertama yang didahulukan.
- Anda hanya dapat menetapkan track video atau audio sebagai track utama.
- Jika TimelineOut ditetapkan dalam objek Timeline, nilai tersebut didahulukan dan layanan mengabaikan logika track utama. Gunakan TimelineIn dan InOut untuk menempatkan aset pada timeline sebagai gantinya.

Contoh

timeline di bawah ini memiliki dua track: satu track video dengan empat klip berdurasi total 20 detik, dan satu track audio dengan satu file berdurasi 15 detik. Track audio merupakan track utama.

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
            "Out": 5
        }, {
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
            "Out": 5
        }, {
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video3.mp4",
            "Out": 5
        }, {
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video4.mp4",
            "Out": 5
        }]
    }],
    "AudioTracks": [{
        "MainTrack": true,
        "AudioTrackClips": [{
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_audio.mp3"
        }]
    }]
}

Durasi video akhir: 15 detik. Track video dipotong dari 20 detik agar sesuai dengan track utama audio.

Catatan

Karena hanya file audio yang menentukan durasi output, Anda dapat menukar video dan gambar yang berbeda tanpa mengubah parameter waktu apa pun. Pendekatan track utama ini sangat cocok untuk produksi batch di mana audio tetap sementara konten visual berubah.

Tentukan MaxDuration

Kapan menggunakan MaxDuration

Saat Anda memiliki kumpulan besar materi video, audio, dan subtitle serta ingin menghasilkan banyak klip dengan durasi tetap, menetapkan parameter waktu pada setiap aset tidak praktis. Tetapkan MaxDuration dalam OutputMediaConfig untuk memberlakukan batas maksimum pada output. Setiap track secara otomatis dipotong hingga batas tersebut, dan materi tanpa durasi tampil eksplisit (seperti gambar global dan teks banner) secara otomatis diatur ke MaxDuration.

Cara mengonfigurasi MaxDuration

Saat memanggil API SubmitMediaProducingJob, tetapkan MaxDuration dalam OutputMediaConfig untuk membatasi durasi video output.

Cara kerja MaxDuration:

Jika durasi track apa pun melebihi MaxDuration, track tersebut dipotong menjadi MaxDuration. Video akhir tidak pernah melebihi MaxDuration.
Jika semua track lebih pendek dari MaxDuration, durasi output sama seperti tanpa MaxDuration.

Catatan

Jika MaxDuration dan track utama keduanya ditetapkan, MaxDuration yang berlaku dan pengaturan track utama diabaikan.

Contoh

Contoh berikut menunjukkan konfigurasi sampel untuk OutputMediaConfig dan Timeline.

OutputMediaConfig: Tetapkan MaxDuration menjadi 15 detik.

{
    "MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_output.mp4",
    "MaxDuration": 15
}

Timeline: Empat track — dua track video, satu track audio, dan satu track subtitle. Tidak ada parameter terkait waktu yang ditetapkan pada klip apa pun.

Track video 1: gambar JPG yang dikonfigurasi sebagai gambar global.
Track video 2: dua video yang ditambahkan berurutan.
Track audio: satu file audio.

Track subtitle: teks banner.

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "Type": "GlobalImage",
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_image1.jpg"
        }]
    }, {
        "VideoTrackClips": [{
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4"
        }, {
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4"
        }]
    }],
    "AudioTracks": [{
        "AudioTrackClips": [{
            "MediaUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_audio.mp3"
        }]
    }],
    "SubtitleTracks": [{
        "SubtitleTrackClips": [{
            "Type": "Text",
            "Content": "Banner text",
            "Alignment": "CenterCenter"
        }]
    }]
}

Durasi video akhir: 15 detik, sesuai dengan MaxDuration. Secara spesifik:

Durasi tampil gambar global secara otomatis diatur menjadi 15 detik.
Track video (dua klip) dan track audio dipotong menjadi 15 detik jika durasi gabungan atau individualnya melebihi batas tersebut.
Durasi tampil teks banner secara otomatis diatur menjadi 15 detik.

Penyesuaian kecepatan otomatis

Kapan menggunakan penyesuaian kecepatan

Saat track utama ditetapkan, track yang lebih panjang secara default dipotong. Pemotongan dapat merusak integritas konten — misalnya, narasi bisa terpotong di tengah kalimat. Masalah sebaliknya juga terjadi: jika video lebih pendek dari track utama audio, video berakhir lebih awal dan audio sisanya diputar di atas layar hitam.

Penyesuaian kecepatan mengatasi kedua masalah tersebut. Alih-alih memotong, layanan secara otomatis mempercepat atau memperlambat track sehingga selesai tepat pada waktu yang sama dengan track utama, mempertahankan seluruh konten sekaligus menjaga output tetap selaras secara presisi.

Cara mengonfigurasi penyesuaian kecepatan

Tetapkan TrackShortenMode dan TrackExpandMode pada track video atau audio dalam timeline untuk mengontrol perilaku track relatif terhadap track utama. Saat ini, kedua parameter hanya mendukung AutoSpeed, yang menyesuaikan kecepatan pemutaran secara otomatis.

TrackShortenMode: "AutoSpeed" — mempercepat track ketika durasinya lebih panjang dari track utama.
TrackExpandMode: "AutoSpeed" — memperlambat track ketika durasinya lebih pendek dari track utama.
1. Penyesuaian kecepatan otomatis dan penyelarasan materi antar-track tidak dapat digunakan bersamaan. Penyesuaian kecepatan mengubah waktu klip, yang merusak akurasi penyelarasan.
2. Penyesuaian kecepatan otomatis tidak berlaku untuk track yang diatur ke putar ulang berulang. Mode loop sudah secara otomatis mengisi durasi track penuh.

Contoh

Contoh 1: Track video adalah track utama. Track audio memiliki TrackShortenMode: "AutoSpeed". Jika audio lebih panjang dari video, kecepatannya secara otomatis ditingkatkan agar berakhir bersamaan dengan video.

{
	"VideoTracks": [{
		"MainTrack": true,
		"VideoTrackClips": [{
			"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
			"In": 0,
			"Out": 10
		}, {
			"Type": "Image",
			"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_image1.jpg",
			"Duration": 4
		}, {
			"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
			"In": 0,
			"Out": 5
		}]
	}],
	"AudioTracks": [{
		"TrackShortenMode": "AutoSpeed",
		"AudioTrackClips": [{
			"Content": "Freshippo baru saja membuka toko di Huilongguan. Ini adalah hari pembukaan resminya, dan tokonya cukup ramai. Freshippo menawarkan beberapa penawaran menarik untuk makanan ringan dan minuman. Ayo datang dan lihat."
			"Type": "AI_TTS",
			"Voice": "zhiqing",
			"Effects": [{
				"Type": "Volume",
				"Gain": 1
			}, {
				"FontSize": 34,
				"Y": 0.658,
				"Alignment": "TopCenter",
				"AdaptMode": "AutoWrap",
				"Type": "AI_ASR",
				"Font": "FZHei-B01S"
			}]
		}]
	}]
}

Contoh 2: Track audio adalah track utama. Track video memiliki TrackShortenMode dan TrackExpandMode yang keduanya diatur ke "AutoSpeed". Kecepatan video secara otomatis ditingkatkan jika video lebih panjang dari audio, atau diperlambat jika lebih pendek — memastikan video berakhir tepat saat audio selesai.

{
	"VideoTracks": [{
		"TrackExpandMode": "AutoSpeed",
		"TrackShortenMode": "AutoSpeed",
		"VideoTrackClips": [{
				"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video1.mp4",
				"In": 0,
				"Out": 10
			},
			{
				"Type": "Image",
				"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_image1.jpg",
				"Duration": 4
			},
			{
				"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video2.mp4",
				"In": 0,
				"Out": 5
			}
		]
	}],
	"AudioTracks": [{
		"MainTrack": true,
		"AudioTrackClips": [{
			"Content": "Freshippo just opened a store in Huilongguan. It is the grand opening day, and there is quite a crowd at the store. Freshippo offers some great deals on snacks and drinks. Come check it out.",
			"Type": "AI_TTS",
			"Voice": "zhiqing",
			"Effects": [{
					"Type": "Volume",
					"Gain": 1
				},
				{
					"FontSize": 34,
					"Y": 0.658,
					"Alignment": "TopCenter",
					"AdaptMode": "AutoWrap",
					"Type": "AI_ASR",
					"Font": "FZHei-B01S"
				}
			]
		}]
	}]
}