Objek Config dari template reguler - Intelligent Media Services

Ketika Anda mengirimkan tugas pengeditan dan produksi dengan menentukan parameter TemplateId, Intelligent Media Services (IMS) menggabungkan objek Config dari template reguler yang ditentukan oleh parameter TemplateId dan pengaturan tertentu dari parameter ClipsParam menjadi objek Timeline. Anda kemudian dapat menggunakan objek Timeline untuk mengedit dan memproduksi video. Topik ini menjelaskan contoh objek Config dari template reguler serta objek Timeline yang sesuai.

Contoh objek Config di mana parameter umum digunakan

Menambahkan watermark ke video

Config

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "$Video"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : 40,
                    "Y" : 40
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "****20b48fb04483915d4f2cd8ac****"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : 40,
                    "Y" : 40
                }
            ]
        }
    ]
}

Deskripsi:

Nilai parameter dalam objek Config dari template reguler dimulai dengan $. Contohnya: "$Video" dalam objek Config sampel sebelumnya.
Saat mengirimkan tugas pengeditan dan produksi, atur parameter TemplateId ke IceSys_SingleVideo_Watermark dan tambahkan Video ke pengaturan parameter ClipsParam. Untuk informasi lebih lanjut tentang objek Timeline yang dihasilkan, lihat objek Timeline sampel sebelumnya.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\"}
&<Common parameters>
```

Menambahkan watermark ke video (Nilai parameter default didukung dalam objek Config)

Config

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "$Video"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : "$X:40",
                    "Y" : "$Y:40",
                    "TimelineIn" : "$TimelineIn:0",
                    "TimelineOut" : "$TimelineOut:NULL"
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "****20b48fb04483915d4f2cd8ac****"
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******",
                    "Width" : 200,
                    "Height" : 60,
                    "X" : 40,
                    "Y" : 40,
                    "TimelineIn" : 5
                }
            ]
        }
    ]
}

Deskripsi:

Nilai parameter default didukung dalam objek Config dari template reguler. Jika Anda tidak menentukan parameter, IMS akan menggunakan nilai default dari parameter tersebut. Contohnya: "$TimelineIn:0" dan "$TimelineOut:NULL" dalam objek Config sampel sebelumnya. Nilai setelah tanda titik dua (:) adalah nilai default dari parameter TimelineIn dan TimelineOut.
Jika nilai default dari parameter adalah NULL dan Anda tidak menentukan parameter tersebut, parameter tersebut akan dihapus dari objek Timeline yang dihasilkan.
Saat mengirimkan tugas pengeditan dan produksi, atur parameter TemplateId ke IceSys_SingleVideo_Watermark dan tambahkan Video ke pengaturan parameter ClipsParam. Untuk informasi lebih lanjut tentang objek Timeline yang dihasilkan, lihat objek Timeline sampel sebelumnya.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateId=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\",\"TimelineIn\":\"5\"}
&<Common parameters>
```

Contoh objek Config di mana parameter array digunakan

Bisukan seluruh trek video

Config

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId",
                        "Effects": [
                            {
                                "Type": "Volume",
                                "Gain": "0"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId" : "******05512043f49f697f7425******",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                        }
                    ]
                },
                {
                    "MediaId" : "******2788e810116a45109f2e******",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                        }
                    ]
                },
                {
                    "MediaId" : "******67f44f4964e6c998dee8******",
                    "Effects": [
                        {
                            "Type": "Volume",
                            "Gain": "0",
                        }
                    ]
                }
            ]
        }
    ]
}

Deskripsi:

Bagian berikut dalam objek Config sampel sebelumnya menggunakan struktur berbasis array untuk menampung sejumlah variabel material yang didefinisikan dalam $VideoArray:
```
{
    "Sys_Type" : "ArrayItems",
    "Sys_ArrayObject" : "$VideoArray",
    "Sys_Template" : {
        "MediaId" : "$MediaId",
        "Effects": [
            {
                "Type": "Volume",
                "Gain": "0"
            }
        ]
    }
}
```
Saat mengirimkan tugas pengeditan dan produksi, atur parameter TemplateId ke IceSys_VideoMute dan tambahkan VideoArray ke pengaturan parameter ClipsParam. Untuk menghasilkan objek Timeline, IMS melintasi parameter VideoArray, menghasilkan elemen menggunakan objek Sys_Template, dan membungkus elemen-elemen tersebut ke dalam array baru. Untuk informasi lebih lanjut tentang objek Timeline yang dihasilkan, lihat objek Timeline sampel sebelumnya.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"}]}
&<Common parameters>
```
Jika objek Sys_Template hanya berisi satu parameter, Anda dapat menyederhanakan input parameter dengan hanya menentukan nilai parameter untuk elemen dalam array. Anda tidak perlu menentukan nama parameter yang sesuai. Objek Timeline yang dihasilkan sama dengan objek Timeline sampel sebelumnya.
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[\"b3f37e05512043f49f697f7425b9188b\",\"9987d22788e810116a45109f2ea88648\",\"a8f5f167f44f4964e6c998dee827110c\"]}
&<Common parameters>
```

Tambahkan video intro dan outro

Config

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // ID video intro yang akan digabungkan.
                },
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId"
                    }
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // ID video outro yang akan digabungkan.
                }
            ]
        }
    ]
}

Timeline

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // ID video intro yang akan digabungkan.
                },
                {
                    "MediaId": "******05512043f49f697f7425******"
                },
                {
                    "MediaId": "******2788e810116a45109f2e******"
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******"
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // ID video outro yang akan digabungkan.
                }
            ]
        }
    ]
}

Deskripsi:

Template reguler menyisipkan video intro tetap dan video outro tetap di awal dan akhir trek video. Anda perlu menentukan sejumlah variabel material antara video intro dan video outro menggunakan parameter array. Saat mengirimkan tugas pengeditan dan produksi, atur parameter TemplateId ke IceSys_OpeningEnding dan tambahkan VideoArray ke pengaturan parameter ClipsParam.

http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_OpeningEnding
&ClipsParam={\"VideoArray\":[\"******05512043f49f697f7425******\",\"******2788e810116a45109f2e******\",\"******67f44f4964e6c998dee8******\"]}
&<Common parameters>

Untuk menghasilkan objek Timeline, IMS melintasi parameter VideoArray, menghasilkan elemen menggunakan objek Sys_Template, dan membungkus elemen-elemen tersebut ke dalam array baru. Namun, format objek Timeline yang dihasilkan secara pendahuluan tidak valid karena item perantara antara video intro dan video outro dalam VideoTrackClips diproses sebagai array klip. Contoh kode:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // ID video intro yang akan digabungkan.
                },
                [
                    {
                        "MediaId": "******05512043f49f697f7425******"
                    },
                    {
                        "MediaId": "******2788e810116a45109f2e******"
                    },
                    {
                        "MediaId": "******67f44f4964e6c998dee8******"
                    }
                ],
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // ID video outro yang akan digabungkan.
                }
            ]
        }
    ]
}

Dalam hal ini, IMS melakukan toleransi kesalahan otomatis. Secara khusus, IMS mengekstrak elemen dalam array berdasarkan konteks saat ini dan mentransformasikan array menjadi array satu dimensi. Untuk informasi lebih lanjut tentang objek Timeline yang dihasilkan akhirnya, lihat objek Timeline sampel sebelumnya.

Intelligent Media Services：Objek Config dari template reguler

Contoh objek Config di mana parameter umum digunakan

Menambahkan watermark ke video

Menambahkan watermark ke video (Nilai parameter default didukung dalam objek Config)

Contoh objek Config di mana parameter array digunakan

Bisukan seluruh trek video

Tambahkan video intro dan outro

Referensi