Tüm Ürünler
Search

Bu Ürün

    ApsaraVideo Media Processing:Standart bir transkodlama işi oluşturun

    Belge Merkezi

    ApsaraVideo Media Processing:Standart bir transkodlama işi oluşturun

    Son Güncelleme:Oct 04, 2026

    Medyanızı istediğiniz formata dönüştürmek için ApsaraVideo Media Processing (MPS) konsolunda veya API işlemi çağırarak transkodlama işleri gönderin.

    Başlamadan önce

    Aşağıdaki hazırlıkları tamamlayın. Bu adımları daha önce yaptıysanız bu bölümü atlayabilirsiniz.

    • İşlem hattını etkinleştirme. Standart transkodlama işleri için standart bir işlem hattı kullanın.

    • İşlenecek videoyu OSS'e yükleyin.

      • Bir iş oluşturmak istiyorsanız videoyu doğrudan OSS'e yükleyin. Daha fazla bilgi için bkz. Video yükleme.

      • Bir iş akışı oluşturmak ve iş akışını otomatik olarak tetiklemek istiyorsanız videoyu yüklemeden önce medya paketlerini eklemeniz ve bir iş akışı oluşturmanız gerekir. Giriş ve çıkış medya paketlerini belirtip giriş medya paketine bir medya dosyası yükledikten sonra MPS, yüklemeyle ilgili bir mesaj alır ve ilişkili iş akışını tetikler. İş akışı tamamlandığında işlenmiş medya dosyası çıkış medya paketine yüklenir. Daha fazla bilgi için bkz. Medya paketlerini ekleme.

    • Transkodlama şablonlarını yapılandırın.

    • Videolarınıza filigran eklemeyi kolaylaştırmak için filigran şablonlarını kullanın. Daha fazla bilgi için bkz. Filigran şablonları.

    • İsteğe bağlı: Bildirim özelliğini etkinleştirin. MPS'nin işler ve iş akışlarıyla ilgili bildirimleri MNS konularına veya kuyruklarına göndermesini istiyorsanız ihtiyacınıza göre bir MNS kuyruğu veya konusu yapılandırın. Daha fazla bilgi için bkz. Bildirimleri ayarlama.

    Konsolda iş gönderme

    Tek iş

    1. ApsaraVideo Media Processing konsolu oturum açın.

    2. Üst gezinme çubuğunda bir bölge seçin. Örneğin China (Hangzhou) seçeneğini belirleyin.

    3. Sol gezinme bölmesinde Job Management seçeneğine tıklayın.

    4. Encode sekmesinde Create Task seçeneğine tıklayın.

    5. Parametreleri yapılandırın.

      Parametre

      Açıklama

      Input File URL

      Select seçeneğine tıklayın. Bucket açılır listesinden bir paket seçin. Seçilen paketteki klasörler Path altında görüntülenir. Bir giriş dosyası seçin.

      Not

      • Kullanılabilir paket yoksa OSS konsoluna gidin ve mevcut bölgede bir paket oluşturun. Daha fazla bilgi için bkz. Medya paketlerini ekleme.

      • Bir paket seçtikten sonra Path altında dosya görünmüyorsa OSS konsolunda bu pakete dosya yükleyin.

      • OSS'in etkinleştirilmediğine dair bir uyarı alırsanız OSS konsoluna giderek hizmeti etkinleştirin.

      • Bir rol hatası veya izin reddedildi mesajı görürseniz Resource Access Management (RAM) konsoluna gidin ve mevcut RAM kullanıcısına gerekli OSS izinlerini verin. İhtiyaca göre AliyunOSSFullAccess ilkesini ekleyebilir veya özel bir ilke oluşturabilirsiniz. Daha fazla bilgi için bkz. RAM kullanıcısı oluşturma ve izin verme.

      Encoding Pipeline

      Açılır listeden bir işlem hattı seçin.

      Not

      • Kullanılabilir işlem hattı yoksa önce bir işlem hattı etkinleştirin. Daha fazla bilgi için bkz. İşlem hattı oluşturma.

      • İşlem hattı eşzamanlılığı garanti edilmez ve kullanılabilir kaynaklara bağlıdır. Varsayılan eşzamanlılık değeri 200'dür.

      Output File Name

      Çıkış dosyası için bir ad girin. M3U8 dışındaki tüm dosya türleri için bir dosya uzantısı ekleyin. Örneğin example_video01.mp4 girin.

      Output Path

      Select seçeneğine tıklayın. Bucket açılır listesinden bir paket seçin. Paketteki klasörler Path altında görüntülenir. Çıkış yolu olarak bir klasör seçin.

      Not

      • Çıkış yolu giriş yoluyla aynıysa ancak dosya adları farklıysa kaynak dosyanın üzerine yazılmaz. Dosya adları aynıysa kaynak dosyanın üzerine yazılıp yazılmayacağını OSS yapılandırmanız belirler. Üzerine yazmayı önlemek için bkz. Aynı ada sahip nesnelerin üzerine yazılmasını önleme (Java SDK V1). Bu ayar etkinleştirildiğinde çıkış dosyasının adı kaynak dosya ile aynıysa iş çıkış dosyasını yazamaz. Çıkış dosyası için farklı bir ad kullanmanızı öneririz.

      • Diğer yaygın sorunlar için Input File URL açıklamasına bakın.

    6. Next seçeneğine tıklayın.

    7. Encoding Template öğesini yapılandırın.

      Parametre

      Açıklama

      Template Type

      Transkodlama şablonu türünü seçin. Ön ayarlı şablonların ayrıntıları için bkz. Ön ayarlı şablon ayrıntıları. Özel şablon oluşturmak için bkz. Transkodlama şablonları.

      Output Format

      Bir çıkış formatı seçin. Varsayılan değer mp4'tür.

      Template

      Bir şablon seçin. Varsayılan değer MP4-4K'dir.

      (İsteğe bağlı) Watermark Template

      switch anahtarını açın.

      1. Watermark Template açılır listesinden bir filigran şablonu seçin. Kullanılabilir filigran şablonu yoksa önce bir tane oluşturun.

      2. Watermark Image yanındaki Select seçeneğine tıklayın. Bucket açılır listesinden bir paket seçin. Paketteki klasörler Path altında görüntülenir. Bir görüntü dosyası seçin.

        Not

        Desteklenen filigran dosyaları arasında PNG görüntüler, animasyonlu PNG görüntüler ve MOV animasyonları bulunur.

      (İsteğe bağlı) Clip Output

      switch anahtarını açın. Kırpma işlemini tanımlamak için başlangıç zamanını ve süreyi ayarlayın.

      1. Start From alanında başlangıç zamanını SS:DD:SS formatında seçin.

        Not

        Başlangıç zamanı videonun toplam süresinden önce olmalıdır. Aksi takdirde transkodlama işi başarısız olur.

      2. Clip Length alanında süreyi SS:DD:SS formatında seçin.

        Not

        Belirtilen kırpma süresi videonun sonunu aşarsa kırpma işlemi kaynak videonun sonuna kadar devam eder.

      (İsteğe bağlı) Rotate Angle

      Saat yönünde bir döndürme açısı girin. Değer [0, 360] aralığında olmalıdır.

    8. Transkodlama işini oluşturmak ve göndermek için Submit seçeneğine tıklayın.

      İş gönderildikten sonra iş listesinde yürütme durumunu, yapılandırma ayrıntılarını, giriş yolunu ve çıkış yolunu görüntüleyebilirsiniz.

      Not

      Bir transkodlama işi başarısız olursa ve hata ayrıntılarını görüntüleyemezseniz ağ bağlantınızı kontrol edin ve işi yeniden gönderin.

    Workflow

    1. ApsaraVideo Media Processing konsolu oturum açın.

    2. Üst gezinme çubuğunda bir bölge seçin.

    3. Sol gezinme bölmesinde Workflow > Workflow Orchestration seçeneğine tıklayın.

    4. Create Workflow seçeneğine tıklayın.

    5. İhtiyacınıza göre iş akışı parametrelerini yapılandırın.

      1. Workflow Name: İş akışı için bir ad girin.

      2. Configuration Plan: Bir yapılandırma planı seçin.

        Not

        MPS yaygın kullanım durumları için önceden ayarlanmış iş akışları sağlar. Önceden ayarlanmış bir iş akışı seçip düzenleyebilir veya özel bir iş akışı oluşturabilirsiniz.

    6. İş akışı topolojisini düzenleyin.

      1. İlgili düğümün yanındaki artı simgesine (+) tıklayın ve açılır listeden Encode düğümünü seçin.

      2. Encode düğümünün yanındaki kalem simgesine tıklayarak Basic Settings sayfasını açın.

      3. Transkodlama parametrelerini yapılandırın.

        Parametre

        Açıklama

        Name

        Bu düğüm için bir ad girin.

        Encoding Template

        Select seçeneğine tıklayın. Görüntülenen iletişim kutusunda Encoding Template öğesini yapılandırın.

        1. Bir Template Type seçin.

        2. Bir Output Format seçin.

        3. Bir Template seçin.

        4. OK seçeneğine tıklayın.

        Not

        Ön ayarlı şablonların ayrıntıları için bkz. Ön ayarlı şablon ayrıntıları. Özel şablon oluşturmak için bkz. Transkodlama şablonları.

        Output Path

        Select seçeneğine tıklayın. Bucket açılır listesinden bir paket seçin. Paketteki klasörler Path altında görüntülenir. Çıkış yolu olarak bir klasör seçin.

        Not

        • Çıkış yolu giriş yoluyla aynıysa:

          • Dosya adları farklıysa kaynak dosyanın üzerine yazılmaz.

          • Dosya adları aynıysa kaynak dosyanın üzerine yazılıp yazılmayacağını OSS yapılandırmanız belirler. Üzerine yazmayı önlemek için bkz. Aynı ada sahip nesnelerin üzerine yazılmasını önleme (Java SDK V1). Bu ayar etkinleştirildiğinde çıkış dosyasının adı kaynak dosya ile aynıysa iş çıkış dosyasını yazamaz. Çıkış dosyası için farklı bir ad kullanmanızı öneririz.

        • Sonraki iş akışı çalıştırmalarında çıkış dosyalarının üzerine yazılmasını önlemek için aşağıdaki yerleşik değişkenlerin bir kombinasyonunu kullanın:

          • {RunId}: Medya iş akışının yürütme kimliği.

          • {ObjectPrefix}: Paket bilgileri hariç kaynak dosyanın yolu.

          • {FileName}: Uzantı dahil kaynak dosyanın adı. Çıkış dosyasının uzantısı seçilen transkodlama şablonu tarafından belirlenir.

          • {ExtName}: Kaynak dosyanın uzantısı.

        (İsteğe bağlı) Watermark

        switch anahtarını açın.

        1. Watermark Template açılır listesinden bir şablon adı seçin.

          Not

          Kullanılabilir filigran şablonu yoksa önce bir tane oluşturun.

        2. Filigran görüntüsü yolunu eklemek için Watermark Image yanındaki Select seçeneğine tıklayın.

          Not

          Desteklenen filigran dosyaları arasında PNG görüntüler, animasyonlu PNG görüntüler ve MOV animasyonları bulunur.

        (İsteğe bağlı) Encryption

        switch anahtarını açın.

        Encryption Method için Alibaba Cloud Private Encryption veya HLS Standard Encryption seçeneğini belirleyin. Daha fazla bilgi için bkz. Video şifreleme.

        (İsteğe bağlı) Clip

        switch anahtarını açın.

        1. Clip Method için Video Clip veya Video Ending Clip seçeneğini belirleyin.

        2. Start From alanında başlangıç zamanını seçin.

        3. Length alanında süreyi seçin.

          Not

          • Başlangıç zamanı videonun toplam süresinden önce olmalıdır. Aksi takdirde transkodlama işi başarısız olur.

          • Belirtilen kırpma süresi videonun sonunu aşarsa kırpma işlemi kaynak videonun sonuna kadar devam eder.

        (İsteğe bağlı) Add Credits

        switch anahtarını açın. File Path yanındaki Select seçeneğine tıklayın ve jenerik video dosyasının yolunu seçin.

        (İsteğe bağlı) Rotate Angle

        Saat yönünde bir döndürme açısı girin. Değer [0, 360] aralığında olmalıdır.

      4. Encode düğümünün yapılandırmasını tamamlamak için OK seçeneğine tıklayın.

    7. İş akışını oluşturmak için Save seçeneğine tıklayın.

    API aracılığıyla iş gönderme

    Konsolda iş veya iş akışı oluşturmak ihtiyaçlarınızı karşılamıyorsa SubmitJobs işlemi çağırarak transkodlama işlerini programatik şekilde gönderin ve iş mantığınıza göre parametreleri yapılandırın.

    1. Transkodlama işi göndermek için SubmitJobs işlemi çağırın.

      Daha fazla bilgi için bkz. Transkodlama işi gönderme. Oluşturma sırasında transkodlama bilgilerini aşağıdaki gibi yapılandırmanız gerekir:

      1. PipelineId: Standart bir işlem hattının kimliğini kullanın.

      2. TemplateId: İhtiyaçlarınıza göre bir transkodlama şablonu seçin. Ön ayarlı şablonlar gereksinimlerinizi karşılamıyorsa özel bir şablon oluşturun. Daha fazla bilgi için bkz. Özel transkodlama şablonu ekleme.

      3. (İsteğe bağlı) Şifreleme gerekiyorsa Output nesnesindeki Encryption parametresini yapılandırın.

        Not

        Şifrelenmiş çıkış M3U8 formatında olmalıdır. API Base64 ve KMS şifreleme yöntemlerini destekler. Daha fazla bilgi için bkz. Parametre ayrıntıları.

    2. Geri arama bildirimlerini alın.

      Bir transkodlama işi tamamlandığında ve işlem hattı için olay bildirimlerini yapılandırdığınızda belirtilen kuyruğa veya konuya Simple Message Queue (önceki adı MNS) üzerinden bir mesaj gönderilir. Daha fazla bilgi için bkz. Bildirim alma.

    3. İş sonucunu sorgulayın.

      1. İş sonucunu sorgulamak ve çıkış dosyası URL'sini almak için Transkodlama işlerini sorgulama işlemi çağırın.

      2. İşlem hattı kimliğine, iş durumuna ve oluşturma zamanı aralığına göre birden çok transkodlama işini sorgulamak için Transkodlama işlerini listeleme işlemi çağırın.