Contoh konfigurasi overlay teks Timeline - ApsaraVideo VOD

Topik ini menyediakan contoh konfigurasi Timeline umum untuk overlay teks saat mengedit video menggunakan OpenAPI, mencakup overlay teks selama durasi penuh video dan overlay teks di wilayah tertentu.

API terkait

Parameter

Parameter	Deskripsi
Koordinat teks	X: Jarak horizontal dari pojok kiri atas teks ke pojok kiri atas video output. Y: Jarak vertikal dari pojok kiri atas teks ke pojok kiri atas video output. Nilainya dapat berupa persentase atau nilai piksel: Jika nilainya berada dalam rentang 0 hingga 0,9999, nilai tersebut merepresentasikan rasio terhadap lebar atau tinggi video output. X relatif terhadap lebar, dan Y relatif terhadap tinggi. Jika nilainya merupakan bilangan bulat yang lebih besar atau sama dengan 8, nilai tersebut menunjukkan nilai piksel absolut.
Properti teks	Content: Konten teks. Font: Font teks. Font default adalah SimSun. Font berikut didukung: SimSun adalah jenis huruf Song. WenQuanYi Zen Hei WenQuanYi Zen Hei Mono juga dikenal sebagai WenQuanYi Equal-Width Zen Hei. WenQuanYi Zen Hei Sharp adalah alias untuk WenQuanYi Dot Matrix Zheng Hei. Yuanti SC Bold: Yuanti-Simplified (Bold). Yuanti SC Light: Font ringan bergaya bulat untuk bahasa Tionghoa Sederhana. Yuanti SC Regular: Simplified Round. Regular. FontSize: Ukuran font dalam piksel. Nilai default adalah 20. FontColor: Warna font dalam nilai heksadesimal. Nilainya harus diawali dengan tanda pagar (#), seperti #FFFFFF. Nilai default adalah #FFFFFF. ColorOpacity: Opasitas warna font. Nilainya berkisar antara 0 hingga 1. Nilai 1 menunjukkan warna sepenuhnya tidak transparan. Nilai 0 menunjukkan warna sepenuhnya transparan. Nilai default adalah 1. FontFace: Gaya font. Bold: Menentukan apakah font dicetak tebal. Nilai default adalah false. Italic: Menentukan apakah font dicetak miring. Nilai default adalah false. Underline: Menentukan apakah font diberi garis bawah. Nilai default adalah false.
Rentang waktu untuk overlay teks	TimelineIn: Waktu mulai teks relatif terhadap timeline. TimelineOut: Waktu akhir teks relatif terhadap timeline.

Contoh Timeline

Overlay teks durasi penuh

Overlay teks durasi penuh muncul dari awal hingga akhir video. Anda tidak perlu menentukan TimelineIn dan TimelineOut. Posisi teks dalam video output ditentukan oleh X dan Y. Kode berikut memberikan contohnya:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 30,
                            "Y": 92,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8123,
                            "Y": 0.7896,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8223,
                            "Y": 0.7796,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

Overlay teks wilayah tertentu

Overlay teks wilayah tertentu menampilkan teks pada video dalam rentang waktu tertentu. Posisi teks dalam video output ditentukan oleh X dan Y. Kode berikut memberikan contoh cara menambahkan overlay teks pada video dari 0 hingga 5 detik dan dari 5 hingga 10 detik:

Jika TimelineIn tidak ditentukan, nilai default-nya adalah 0.
Jika TimelineOut tidak ditentukan, overlay akan berlanjut hingga akhir video secara default.
Jika nilai TimelineOut melebihi durasi video, overlay akan berakhir pada akhir track video.

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 30,
                            "Y": 92,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 1124,
                            "Y": 516,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 1123,
                            "Y": 515,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

Gaya word art

Word art adalah gaya keterangan teks khusus berdasarkan efek teks banner. Kode berikut memberikan contohnya:

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId1",
          "Effects": [
            {
              "Type": "Text",
              "X": 33,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Word art with shadow and outline - First line of test text",
              "OutlineColour": "#ee00ff",
              "BackColour": "#CE1212",
              "EffectColorStyle": "skyline",
              "Angle": 300,
              "Outline": 2,
              "Shadow": 3,
              "FontSize": 42,
              "FontColorOpacity": 1,
              "FontColor": "#000000",
              "FontFace": {
                "Bold": true,
                "Italic": false,
                "Underline": false
              }
            },
            {
              "Type": "Text",
              "X": 66,
              "Y": 256,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Second line of text",
              "EffectColorStyle": "golden",
              "Angle": 60,
              "FontSize": 38,
              "FontColorOpacity": 0.8,
              "FontColor": "#d60e0e"
            },
            {
              "Type": "Text",
              "X": 0.7123,
              "Y": 0.7896,
              "TimelineIn": 5,
              "TimelineOut": 20,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "Third line of text",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

Parameter word art

Parameter	Tipe	Deskripsi
EffectColorStyle	string	Jenis gaya word art. Untuk informasi selengkapnya tentang gaya dan efek word art, lihat Contoh efek word art.
OutlineColour	string	Warna garis luar. Warna tersebut merupakan nilai RGB heksadesimal 6 digit dalam format #xxyyzz.
BackColour	string	Warna bayangan. Warna tersebut merupakan nilai RGB heksadesimal 6 digit dalam format #xxyyzz.
Shadow	int	Nilai piksel kedalaman bayangan untuk word art. Nilai default adalah 0. Rasio yang direkomendasikan antara kedalaman bayangan dan ukuran font adalah 2:25. Misalnya, jika ukuran font adalah 25, atur kedalaman bayangan menjadi 2.
Outline	int	Nilai piksel lebar garis luar untuk word art. Nilai default adalah 0. Rasio yang direkomendasikan antara lebar garis luar dan ukuran font adalah 2:25. Misalnya, jika ukuran font adalah 25, atur lebar garis luar menjadi 2.
Spacing	int	Jarak antar karakter, dalam piksel.
Angle	float	Sudut pra-rotasi baris subtitle, dalam derajat. Nilainya harus berada dalam rentang [0, 360].