Uygulama sunucularınızdan ApsaraVideo VOD için ayrılmış Object Storage Service (OSS) paketlerine medya dosyaları yükleyebilirsiniz. ApsaraVideo VOD, yaygın programlama dilleri için sunucu yükleme SDK'ları ve örnek kodlar sunar. Bu SDK'lar, yükleme URL'leri ve kimlik bilgilerini elde etme mantığını kapsüller. Yükleme işlemini başlatmak için SDK'ları kullanmadan önce yalnızca basit yapılandırmalar yapmanız gerekir. Bu konuda sunucu yükleme SDK'larının kullanım senaryoları, yükleme süreci ve kullanımı açıklanmaktadır.
Senaryolar
Otomatik yükleme yapmak veya çok sayıda video ya da çevrimiçi medya dosyası yüklemek istiyorsanız sunucu yükleme SDK'larını kullanabilirsiniz. Çevrimiçi medya dosyalarını yüklemek için öncelikle bu dosyaları bir uygulama sunucusuna indirmeniz, ardından uygulama sunucusundan ApsaraVideo VOD'a yüklemeniz gerekir.
Özellik | Açıklama | Açıklamalar |
Programlama dilleri | Java, Python, PHP, C ve C++ desteklenir. | Diğer programlama dilleri için OSS SDK'larını kullanın. Daha fazla bilgi için bkz. OSS SDK'larını kullanarak medya dosyalarını yükleme. |
Desteklenen medya dosyaları | Desteklenen medya dosyası biçimleri hakkında bilgi için bkz. Medya yükleme. Yerel dosyaları ve çevrimiçi dosyaları yükleyebilirsiniz. Çevrimiçi dosyalar URL'ler kullanılarak yüklenir. |
Not URL'ler kullanarak medya dosyalarını yüklemek için URL'leri kodlamanız gerekir. Bu işlem, URL'lerdeki özel karakterlerden kaynaklanan yükleme hatalarını önler. |
Depolama adresleri | Varsayılan depolama adresini kullanabilir veya bir depolama adresi belirtebilirsiniz. | Varsayılan depolama adresini değiştirebilirsiniz. Daha fazla bilgi için bkz. Depolama paketlerini yönetme. URL tabanlı yükleme yalnızca Çin (Şanghay) bölgesinde desteklenir. Bir API çağrısı yaparak yükleme URL'si ve kimlik bilgisi alırken StorageLocation parametresini ayarlayarak depolama adresini belirtebilirsiniz. |
İç ağ üzerinden yükleme | Yükleme betiğini bir Elastic Compute Service (ECS) örneğine dağıtmak istiyorsanız yükleme mantığında ECS örneğinin bulunduğu bölgeyi belirtebilirsiniz. ECS örneğinin bölgesi ile ApsaraVideo VOD'un depolama bölgesi aynıysa dosyalar otomatik olarak iç ağ üzerinden yüklenir. Bu sayede yüklemeler hızlanır ve İnternet trafiği azalır. | ApsaraVideo VOD API'sine yalnızca genel alan adları üzerinden erişilebilir. Yükleme betiğini dağıtmak için İnternet'e erişimi olan bir ECS örneği kullanmanız gerekir. |
Medya varlığı yönetimi | Medya başlıkları, etiketler, kategoriler ve küçük resimler gibi medya meta verilerini yapılandırabilirsiniz. | Yükleme URL'si ve kimlik bilgisi almak için bir işlem çağrırken Title, Tags, CateId ve CoverURL gibi parametreleri ayarlayarak meta verileri yapılandırabilirsiniz. |
Ses ve video dönüştürme | Yüklenen ses ve video dosyalarını dönüştürmek için bir dönüştürme şablonu veya iş akışı belirtebilirsiniz. Ses ve video dosyalarını dönüştürmeden de yükleyebilirsiniz. | Yükleme URL'si ve kimlik bilgisi almak için bir işlem çağrırken TemplateGroupId ve WorkflowId gibi parametreleri ayarlayarak dönüştürmeyi yapılandırabilirsiniz. |
Yükleme denetimi | Yükleme ilerleme çubuğunu yapılandırabilir ve varsayılan veya özel ilerleme geri aramalarını kullanabilirsiniz. Kaldığı yerden devam eden yükleme özelliği yalnızca Java için sunucu yükleme SDK'sında desteklenir. Diğer programlama dillerine yönelik sunucu yükleme SDK'ları bu özelliği desteklemez. | M3U8 dosyaları için yükleme ilerleme çubuğunu yapılandıramazsınız. |
Olay bildirimleri | Yükleme olaylarına ilişkin bildirimleri almak için geri aramaları yapılandırabilirsiniz. Desteklenen olay bildirimleri hakkında daha fazla bilgi için bkz. Medya yükleme. | Geri aramaların nasıl yapılandırılacağı hakkında daha fazla bilgi için bkz. Geri aramaları yapılandırma. |
Yükleme yetkilendirmesi | Bir yükleme kimlik bilgisi kullanarak yükleme izni verebilirsiniz. Bu durumda bir yükleme örneğini başlatmak için bir Alibaba Cloud hesabının veya yetkili bir RAM kullanıcısının AccessKey çiftini kullanmanız gerekir. Security Token Service (STS) belirteci kullanarak da yükleme izni verebilirsiniz. Bu durumda bir yükleme örneğini başlatmak için bir STS belirteci kullanmanız gerekir. | STS belirteci kullanarak yükleme izni veriyorsanız STS belirteçlerini almak için bir hizmet dağıtmanız gerekir. |
Yükleme hızlandırma | Bu özelliği kullanmak için yükleme hızlandırma özelliğini etkinleştirmeniz gerekir. Yükleme hızlandırma özelliğini etkinleştirmek için destek talebi oluşturun. | Bu özelliği etkinleştirdikten sonra yükleme URL'si ve kimlik bilgisi almak için bir işlem çağrırken |
ApsaraVideo VOD, yükleme URL'leri ve kimlik bilgilerini almak için kullanılan aşağıdaki API işlemlerini sunar:
Yükleme süreci
Sunucu yükleme SDK'ları, yükleme URL'leri ve kimlik bilgilerini elde etme mantığını ile OSS yükleme mantığını kapsüller. Yükleme işlemini başlatmak için SDK'ları kullanmadan önce yalnızca basit yapılandırmalar yapmanız gerekir. Aşağıdaki şekil tam bir yükleme sürecini göstermektedir.
Yükleme süreci
Sunucu yükleme SDK'sını uygulama sunucunuza entegre edin ve yükleme ayarlarını tamamlayın. Örneğin; AccessKey çifti, dosya yolu, depolama adresi, medya varlığı bilgileri, dönüştürme ayarları ve yükleme denetimi ayarlarını yapılandırın.
-
Uygulama sunucusu, sunucu yükleme SDK'sını kullanarak bir API işlemini çağırır ve bir yükleme URL'si, yükleme kimlik bilgisi ile medya varlığı bilgilerini alır.
NotAlternatif olarak, bir HTTP veya HTTPS isteği oluşturarak yükleme URL'si ve kimlik bilgisi alabilirsiniz. Ancak bu yöntem imza oluşturmanızı gerektirir ve hata riski taşır. ApsaraVideo VOD, yükleme URL'leri ve kimlik bilgileriyle ilgili aşağıdaki işlemleri sunar:
-
ApsaraVideo VOD, uygulama sunucusuna yükleme URL'sini, yükleme kimlik bilgisini ve medya kimliğini döndürür.
NotApsaraVideo VOD, yükleme URL'leri ve kimlik bilgilerini döndürürken medya kimlikleri oluşturur. Medya kimlikleri yaşam döngüsü yönetimi ve medya işleme için kullanılır.
Bir video için medya kimliği
VideoIdparametresinde döndürülür.Bir görüntü için medya kimliği
ImageIdparametresinde döndürülür.Bir ek medya varlığı için medya kimliği
MediaIdparametresinde döndürülür.Medya varlığı yönetimi, ses ve video oynatma ve medya işleme gibi sonraki görevler için gerekli olan döndürülen medya kimliklerini kaydedin.
Uygulama sunucusu, sunucu yükleme SDK'sı tarafından kapsüllenmiş OSS yükleme mantığına göre yüklemeyi başlatır.
-
OSS istemcisi yükleme sonucunu döndürür.
NotYükleme sonucunu dinlemek için önceden bir geri arama da yapılandırabilirsiniz.
Başvuru kaynakları
Sunucu yükleme SDK'larını entegre etme ve kullanma prosedürü programlama diline göre değişir. Sunucu yükleme SDK'larını nasıl entegre edip kullanacağınız hakkında daha fazla bilgi için aşağıdaki konulara bakın:
Sunucu yükleme SDK'ları ile sunucu işlem SDK'ları arasındaki farklar
ApsaraVideo VOD tarafından sağlanan sunucu yükleme SDK'ları ile sunucu işlem SDK'ları farklıdır. Sunucu yükleme SDK'ları tam yükleme mantığını kapsüller; bu SDK'ları entegre edip yüklemeleri başlatabilirsiniz. Sunucu işlem SDK'ları ise ApsaraVideo VOD'un tüm özelliklerini entegre eder. Yükleme özelliği açısından sunucu işlem SDK'ları yalnızca yükleme URL'si ve kimlik bilgisi alma mantığını kapsüller. Medya dosyalarını yüklemek için sunucu işlem SDK'larını kullanıyorsanız yükleme mantığını kendiniz geliştirmeniz gerekir. Örneğin; ApsaraVideo VOD'dan bir yükleme URL'si ve kimlik bilgisi almanız, Base64 ile kodlanmış yükleme URL'si ve kimlik bilgisini çözmeniz ve dosyaları yüklemek için OSS'u kullanmanız gerekir. ApsaraVideo VOD sunucu işlem SDK'ları hakkında daha fazla bilgi için bkz. Sunucu SDK Referansı.