Medya yükleme, medya kaynaklarınızı ApsaraVideo VOD hizmetine gönderir ve medya varlığı yönetimi, medya işleme ile dağıtım ve oynatma gibi diğer ApsaraVideo VOD hizmetleri için ön koşuldur. Bu konu, yükleme öncesinde dikkat etmeniz gereken noktaları, mevcut yükleme yöntemlerini, yükleme olay bildirimlerini ve yükleme sonrasında yapılması gerekenleri açıklar.
Yüklemeden önce
Desteklenen medya biçimleri
ApsaraVideo VOD; video, ses, görüntü ve yardımcı medya varlıkları (filigranlar, altyazılar ve materyal dosyaları) gibi medya dosyalarının yüklenmesini destekler. Dosyalar yerel dosya veya ağ dosyası olabilir (ağ dosyaları URL çekme yöntemiyle yüklenir). Aşağıdaki tabloda her medya türü için desteklenen biçimler listelenmiştir.
Yükleme sırasında dosya adı uzantısını ekleyin. Uzantılar büyük/küçük harfe duyarlı değildir. Örneğin, MP4 ve mp4 aynı kabul edilir.
| Medya türü | Desteklenen dosya biçimleri |
| Video |
Not M3U8 dosyasını ApsaraVideo VOD konsolu üzerinden yüklemek için yalnızca URL çekme yöntemi kullanılabilir. Yerel bir M3U8 dosyası yüklemek üzere ApsaraVideo VOD API'sini veya SDK'sını kullanın. Ayrıntılar için bkz. ApsaraVideo VOD API'sini kullanarak medya dosyalarını yükleme
|
| Ses | MP3, WMA, WAV, AAC, RA, M4A, FLAC, APE, AC3, AMR, CAF, ACM. |
| Görüntü | PNG, JPG, JPEG, GIF, HEIC. |
| Yardımcı medya varlığı |
|
ApsaraVideo VOD medya yükleme işlemi yalnızca yukarıda listelenen medya türlerini destekler. Diğer dosya türlerini yüklemek için OSS'e dosya yükleme bölümündeki adımları izleyin.
Depolama bölgeleri
ApsaraVideo VOD, medya kaynaklarını Alibaba Cloud Object Storage Service (OSS) üzerinde depolar. Her depolama düğümü bir depolama bölgesidir ve ApsaraVideo VOD her depolama bölgesine bir depolama adresi atar.
ApsaraVideo VOD konsolundan veya PC istemcisinden yükleme yaparken depolama adresi, oturum açtığınız veya seçtiğiniz bölgeye göre belirlenir. SDK veya API kullanarak yükleme yaparken StorageLocation parametresi gibi bir parametre aracılığıyla depolama adresini belirtebilirsiniz. Bu parametre UploadMediaByURL işlemi için geçerlidir.
ApsaraVideo VOD aşağıdaki depolama bölgelerini ve bölge kimliklerini destekler:
| Depolama bölgesi | Bölge Kimliği |
| Çin (Şanghay) | cn-shanghai |
| Çin (Pekin) | cn-beijing |
| Çin (Shenzhen) | cn-shenzhen |
| Çin (Hong Kong) | cn-hongkong |
| Japonya (Tokyo) | ap-northeast-1 |
| Singapur | ap-southeast-1 |
| Endonezya (Cakarta) | ap-southeast-5 |
| Almanya (Frankfurt) | eu-central-1 |
| ABD (Silikon Vadisi) | us-west-1 |
ApsaraVideo VOD, varsayılan olarak aynı hesap içindeki bölgeler arasında veri paylaşımı yapmaz. Yükleme yapmadan önce yükleme bölgenizin gerçek iş bölgenizle eşleştiğinden emin olun. Aksi takdirde dosyalarınızı bulamayabilirsiniz.
Depolama adresleri hakkında
| Kullanılabilir depolama adresi ayarları | Açıklama |
| ApsaraVideo VOD sistem depolama adresini etkinleştirin | ApsaraVideo VOD'u etkinleştirdikten sonra her hizmet bölgesine varsayılan olarak bağımsız bir depolama paketi (ApsaraVideo VOD sistem paketi) atanır. Ek yapılandırma gerektirmeden medya kaynaklarını yüklemek ve yönetmek için bu paketi etkinleştirin. Ayrıntılar için bkz. Depolama paketlerini yönetme. |
| Depolama adresi ekleyin | Kendi OSS paketinizi ApsaraVideo VOD'a ekleyerek OSS paketinde depolanan medya dosyalarını dönüştürmenize, anlık görüntü yakalamanıza ve oynatmanıza olanak tanır. Ayrıntılar için bkz. Depolama paketlerini yönetme. |
| Varsayılan depolama adresini değiştirin | Birden fazla depolama bölgesi için depolama adreslerini etkinleştirdikten veya birden fazla depolama adresi ekledikten sonra varsayılan depolama adresini değiştirebilirsiniz. Dosya yüklerken bir depolama adresi belirtebilir veya belirtmeyebilirsiniz. Adres belirtmezseniz ApsaraVideo VOD varsayılan depolama adresini kullanır. Ayrıntılar için bkz. Depolama paketlerini yönetme. |
Depolama faturalaması
ApsaraVideo VOD depolama, kullandıkça öde (sonradan ödemeli) ve kaynak planları (önceden ödemeli) olmak üzere iki faturalama yöntemini destekler.
Kullandıkça öde yöntemi için bkz. Medya varlığı depolama faturalaması.
Kaynak planları için bkz. ApsaraVideo VOD depolama planı.
Yükleme yöntemleri
ApsaraVideo VOD, farklı kullanıcı senaryoları için manuel yükleme ve programatik (otomatik) yükleme yöntemleri sunar. Bir yöntem seçmek için aşağıdaki rehberliği kullanın ve ayrıntılar için özet tabloya bakın.
Birkaç küçük dosyayı hızlıca yükleyin: Konsolu kullanın.
Büyük dosyaları yükleyin veya uzun süren yüklemeler çalıştırın: PC istemcisini kullanın.
Toplu yüklemeler veya otomatik entegrasyon: Sunucu tarafı yükleme SDK'sını kullanın.
Ağ dosyalarını yükleyin: URL çekme yöntemiyle yüklemeyi kullanın.
| Yükleme yöntemi | Senaryolar | Açıklama | |
| Manuel yükleme | ApsaraVideo VOD konsoluna dosya yükleme | Medya kaynaklarını ApsaraVideo VOD'a hızlı ve kolay bir şekilde yüklemeniz gereken senaryolar. Not Konsol güvenlik ilkeleri nedeniyle, oturum süresi dolduğunda büyük dosyalar için uzun süreli yüklemeler başarısız olabilir. Bu sorunu önlemek amacıyla büyük dosyaları PC istemcisi ile yükleyin. |
|
| Windows istemcisini kullanarak dosya yükleme | Büyük dosyalar, uzun süreli yüklemeler ve düşük bariyerli operasyonel senaryolar. |
| |
| Programatik entegrasyon | Yükleme SDK'sını kullanarak yükleme |
Not Yükleme SDK'sını kullanmanız önerilir. Yükleme SDK'sı dilinizi desteklemiyorsa yüklemeyi tamamlamak için OSS yerel SDK'sını kullanabilirsiniz. |
|
| OSS SDK'larını kullanarak medya dosyalarını yükleme |
|
Not Java, Python, PHP ve C/C++ için ApsaraVideo VOD yükleme SDK'sını kullanmanız önerilir. | |
| URL'lerden toplu yükleme | Dosyaların yerel sunucuda veya terminalde depolanmadığı ve genel ağdan erişilebilen bir URL'den yüklenmesi gereken senaryolar. |
|
Yükleme yöntemine göre özellik karşılaştırması
Aşağıdaki tabloda her yükleme yönteminin yükleme sırasında desteklediği özellikler karşılaştırılmaktadır. ① ve ② işaretleri, tablonun hemen ardından gelen özellik açıklamalarına karşılık gelir.
| Grup | Özellik | Konsol | PC istemcisi | Sunucu tarafı SDK-Java | Sunucu tarafı SDK-Python | Sunucu tarafı SDK-PHP | Sunucu tarafı SDK-C/C++ | OSS SDK |
| Medya varlığı yönetimi | Medya başlığını ayarlama | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir |
| Medya kategorisini belirtme | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | |
| Medya etiketlerini ayarlama | Desteklenmez | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | |
| Video küçük resmini ayarlama | Desteklenmez | Desteklenmez | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | |
| Ses ve video dönüştürme① | Dönüştürme şablonu grubu | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir |
| Medya iş akışı | Desteklenir | Desteklenmez | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | |
| Dönüştürme yok | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | |
| Yükleme kontrolü② | Yükleme ilerlemesini alma | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir | Desteklenir |
| Kaldığı yerden devam ettirme | Desteklenmez | Desteklenmez | Yalnızca Java yükleme SDK'sı tarafından desteklenir | Desteklenir | Desteklenmez | Desteklenmez | Desteklenmez | |
| Çok parçalı yükleme | Varsayılan olarak etkin | Varsayılan olarak etkin | Varsayılan olarak etkin | Varsayılan olarak etkin | Varsayılan olarak etkin | Varsayılan olarak etkin | Varsayılan olarak etkin |
Aşağıdaki notlar, önceki tabloda ① ve ② ile işaretlenen özellik gruplarını açıklar.
Ses ve video dönüştürme①
Bir ses veya video dosyası yüklerken dönüştürmeyi ayarlayın (bir dönüştürme şablonu grubu veya medya iş akışı belirterek); yükleme tamamlandıktan sonra dönüştürme otomatik olarak başlar. Dönüştürmemeyi de seçebilirsiniz. Ancak şunu unutmayın: Yalnızca aşağıdaki biçimlerdeki videolar dönüştürülmeden oynatılabilir: MP4, FLV, M3U8, MP3 ve WEBM.
Dönüştürme şablonu grubu ile dönüştürün: Dönüştürme şablonu grubu kullanmak ApsaraVideo VOD'un varsayılan işleme yöntemidir. Yükleme sırasında dönüştürme şablonu grubu işleme yöntemini seçin. ApsaraVideo VOD, yükleme tamamlandıktan sonra dönüştürmeyi otomatik olarak başlatır.
Medya iş akışı ile dönüştürün: Dönüştürme görevleri içeren bir medya iş akışı oluşturduktan sonra yükleme sırasında medya iş akışı işleme yöntemini seçin. Yükleme tamamlandıktan sonra ApsaraVideo VOD belirtilen medya iş akışını otomatik olarak çalıştırarak dönüştürmeyi tamamlar.
Dönüştürme yok: Yükleme sırasında dönüştürmeye ihtiyacınız yoksa dönüştürme şablonu grubunda No Transcoding şablonunu seçin.
Yükleme kontrolü②
Çok parçalı yükleme: Yüklenecek dosya birden çok parçaya bölünür, parçalar ayrı ayrı yüklenir ve yükleme tamamlandıktan sonra tek bir nesne olarak birleştirilir. ApsaraVideo VOD, dosyaları varsayılan olarak çok parçalı yükleme kullanarak yükler.
Çok parçalı yükleme kullanırken yükleme başarısız olursa parça dosyaları oluşabilir. Bu dosyalar yaklaşık yedi gün sonra otomatik olarak temizlenir. Parça dosyalarını manuel olarak temizlemek için DeleteMultipartUpload işlemini çağırabilirsiniz.
Yükleme ilerlemesini veya durumunu alın.
Kaldığı yerden devam ettirme: Bir ağ hatası nedeniyle yükleme başarısız olursa ApsaraVideo VOD yüklemeyi başarıyla yüklenen son parçadan itibaren sürdürebilir ve böylece kaldığı yerden devam ettirme sağlanır.
Kaldığı yerden devam ettirme işlemi yükleme SDK'sı (istemci) tarafından dahili olarak yönetilir. Bir özel durum nedeniyle oluşan başarısızlık sonrasında yeniden yükleme kaldığı yerden başladığı için kesme noktalarını veya parça kurtarma işlemlerini yönetmenize gerek yoktur.
Yükleme olay bildirimleri
Bir medya dosyası yüklemesi tamamlandıktan sonra önceden yapılandırılmış geri arama adresi aracılığıyla işleme ilerlemesini ve durumunu zamanında alabilirsiniz. ApsaraVideo VOD, olay bildirimleri için HTTP geri arama (HTTPS uyumlu) ve Message Service (MNS) geri arama olmak üzere iki geri arama yöntemini destekler. Geri callback yapılandırması hakkında bilgi edinmek için bkz. Olay bildirimi. Geri callback yapılandırmasını tamamlamak için bkz. Geri aramaları yapılandırma. Tüm yükleme yöntemleri yükleme olay bildirimlerini destekler. Yükleme ile ilgili olaylar aşağıdaki tabloda listelenmiştir.
Her bir olayla ilgili ayrıntılar için bkz. Olay bildirimleri.
| Olay adı | Olay türü | Açıklama |
| Video Upload Complete | FileUploadComplete | ApsaraVideo VOD sunucusu yüklenen bir ses veya video dosyasını almayı bitirdikten sonra oluşturulur. Not Dönüştürülmemiş ses ve video (veya ses) dosyaları için oynatma URL'sini yalnızca Video Upload Complete olay bildirimini aldıktan sonra alabilirsiniz. Yükleme sırasında dönüştürmeyi devre dışı bıraktıysanız Video Upload Complete olay bildirimini aldıktan sonra medya dönüştürme işlerini gönderme işlemini çağırarak dönüştürme yapabilirsiniz. |
| Image Upload Complete | ImageUploadComplete | ApsaraVideo VOD sunucusu yüklenen bir görüntü dosyasını almayı bitirdikten sonra oluşturulur. |
| Auxiliary Media Upload Complete | AttachedMediaUploadComplete | ApsaraVideo VOD sunucusu yüklenen bir yardımcı medya varlığı dosyasını almayı bitirdikten sonra oluşturulur. |
| Video Upload from URL Complete | UploadByURLComplete | URL ile medya dosyalarını yükleme görevini çağırdıktan sonra cloud tarafı videoyu çekip yüklemeyi tamamladığında UploadByURLComplete olayı oluşturulur. |
| Stream Transcode Complete | StreamTranscodeComplete | Bir videonun belirli bir çözünürlük ve biçimdeki akışı (örneğin standart çözünürlükte bir MP4 dosyası) dönüştürmeyi bitirdiğinde oluşturulur. Not Dönüştürülmüş ses ve video dosyaları için oynatma URL'sini yalnızca Stream Transcode Complete olay bildirimini aldıktan sonra alabilirsiniz. Geri aramayı almadan önce oynatma girişimi oynatmanın başarısız olmasına neden olabilir. |
| Video Transcode Complete | TranscodeComplete | Bir video için tüm akışlar dönüştürmeyi bitirdiğinde oluşturulur. Not Oynatma öncesinde tüm çözünürlüklerin hazır olduğundan emin olmak için Video Transcode Complete olay bildirimini alana kadar bekleyin. Geri aramayı almadan önce oynatma girişimi oynatmanın başarısız olmasına neden olabilir. |
Yüklemeden sonra yapılacaklar
Medya kaynakları ApsaraVideo VOD'a yüklendikten sonra iş durumu ve aşamasına bağlı olarak farklı medya durumlarına girer. Farklı medya durumundaki ses ve video kaynakları farklı işlemleri destekler. Örneğin, Uploading, Upload Failed veya Blocked durumundaki ses ve video dosyaları yalnızca silinebilir ve başka hiçbir işlemi desteklemez (dönüştürme başlatamaz, video anlık görüntüsü yakalayamaz veya medya varlıklarını inceleyemezsiniz). Normal durumundaki ses ve video dosyaları dönüştürme, video anlık görüntüsü, medya varlığı inceleme ve oynatma dahil tüm işlemleri destekler. Medya durumları hakkında ayrıntılı bilgi için bkz. Durum: video durumu ve Durum: görüntü durumu.
Yükleme sonrasında kullanıma sunulan ApsaraVideo VOD hizmetleri ve sonraki dağıtım ile oynatma için dikkat edilmesi gerekenler aşağıda verilmiştir:
| ApsaraVideo VOD hizmeti | Açıklama | Başvurular |
| Medya varlığı yönetimi (yükleme sonrası) | Yükleme tamamlandıktan sonra video kaynak dosyaları, dönüştürülmüş akış dosyaları ve görüntü dosyaları gibi medya dosyalarını yönetmek için ApsaraVideo VOD'u kullanın. | Medya varlığı yönetimi |
| Medya işleme | ApsaraVideo VOD, yükleme sonrasında ses ve video dönüştürme, otomatik inceleme, çevrimiçi düzenleme (cloud ortamında video düzenleme) ve AI işleme gibi işlemleri destekler. Not ApsaraVideo VOD depolamasına yüklenen ses ve video dosyalarının meta verileri (video çözünürlüğü, süre ve bit hızı gibi) varsayılan olarak çıkarılır ve videolar için varsayılan olarak küçük resimler ile sprite'lar yakalanır. Bu ön işleme tamamen ücretsizdir. | Medya işleme |
| Ses ve video oynatma | Ses veya video yüklemeyi tamamladıktan sonra dosya mutlaka hazır değildir. ApsaraVideo VOD sunucusunun dosyayı almayı bitirdiğini onaylaması gerekir. Yüklenen ses veya videonun oynatılabilir olduğunu belirlemek için olay bildirimlerini kullanın.
|
|
Yükleme güvenliği
Programatik yükleme senaryolarında hem yükleme kimlik bilgileri hem de STS, yükleme sırasında yetkilendirme ve güvenlik sorunlarını çözer; medya dosyalarının kötü niyetle yüklenmesini ve oynatılmasını önler.
Her yöntemin senaryoları için bkz. Kimlik bilgisi yöntemi ve STS yöntemi.
Belirli kullanım için her geliştirici yükleme yönteminin işlem belgelerine bakın.
-
-
-
-
Genel okuma izinli dosya yüklemelerini kısıtlama
31 Ocak 2024 tarihinden itibaren ApsaraVideo VOD, OSS x-oss-object-acl üstbilgisi aracılığıyla dosya izinlerinin değiştirilmesini artık desteklememektedir. Bu durum, doğrudan genel okuma izinli dosyaların yüklenmesinden kaynaklanan medya kaynak sızıntıları veya kötü niyetli erişim nedeniyle maliyet artışları gibi sorunların etkili bir şekilde önlenmesini sağlar. ApsaraVideo VOD'da kendi OSS paketlerinize genel okuma izinli dosya yüklemelerini kısıtlamak için aşağıdaki izin yönetimi yöntemlerini kullanabilirsiniz:
ApsaraVideo VOD'un OSS'nize ve diğer kaynaklarınıza erişimine yetki vermek için Cloud Resource Access Authorization bağlantısına tıklayın.
Kendi OSS paketlerinize genel okuma ACL'sine sahip dosyaların yüklenmesini yasaklayan özel bir ilke oluşturun. Prosedür ve ilke içeriği için bkz. ACL'si genel okuma olan nesnelerin OSS paketlerine yüklenmesini yasaklayan ilke.
AliyunVODDefaultRole rolüne önceki adımda oluşturulan kendi OSS paketlerinize genel okuma ACL'sine sahip dosyaların yüklenmesini yasaklama iznini verin.
AliyunVODDefaultRole rolüne izin verme
Resource Access Management (RAM) konsoluna oturum açın. Prosedür için bkz. RAM kullanıcı izinlerini yönetme.
Sol gezinme bölmesinde Roles öğesine tıklayın, ardından AliyunVODDefaultRole öğesini bulup tıklayın.
Permissions sekmesinde Grant Permission öğesine tıklayın.
Açılan panelde Custom Policy sekmesini seçin, hedef ilkeyi belirleyin ve yetkilendirmeyi tamamlayın.
Yükleme hızlandırma
ApsaraVideo VOD, GB veya TB düzeyindeki büyük dosyaların ve uzun mesafeli dosya transferlerinin iyileştirilmesi için yükleme hızlandırma özelliği sunar. Yükleme hızlandırma, bölgeler arası yüklemeler (örneğin deniz aşırı transferler) için geçerlidir; örneğin, videoları Çin anakarasından Singapur depolama bölgesindeki bir depolama adresine yükleme.
Nasıl etkinleştirilir
Yükleme hızlandırmayı etkinleştirmek için destek talebi oluşturun. Alibaba Cloud hesap UID'nizi ve hızlandırmak istediğiniz depolama adresini belirtin.
Faturalama
Yükleme hızlandırma, ApsaraVideo VOD'un katma değerli bir özelliğidir ve kullanıma göre faturalandırılır. Faturalama ayrıntıları için bkz. Transfer hızlandırma faturalaması.
Özelliği etkinleştirip kullanmazsanız ücretlendirilmezsiniz.
Sınırlamalar
Yalnızca ApsaraVideo VOD konsoluna dosya yükleme yöntemi hızlandırmayı desteklemez. Diğer tüm yükleme yöntemleri bu özelliği destekler.
Faturalama
Medya varlıklarını ApsaraVideo VOD'a yüklemek ek ücrete tabi değildir. İlgili ücretler, kullandığınız Alibaba Cloud ApsaraVideo VOD hizmeti kaynaklarından kaynaklanır.
| Faturalama öğesi | Açıklama |
| Depolama ücretleri | Yükleme sonrası medya dosyaları için depolama ücretleri; depolama hacmi ve süresine göre faturalandırılır. |
| Trafik ücretleri | Yükleme trafiği ücretsizdir (istemciden ApsaraVideo VOD'a gelen giden trafik ücretlendirilmez). Aşağı yönlü oynatma trafiği ayrı olarak faturalandırılır. |
| Dönüştürme ücretleri | Yükleme sonrası dönüştürme tetiklenirse çıktı dosyası süresi ve dönüştürme teknik özelliklerine göre faturalandırılır. Dönüştürme yapılmazsa ücret alınmaz. |
| Yükleme hızlandırma ücretleri | Yükleme hızlandırmayı etkinleştirip kullandığınızda hızlandırılmış trafiğe göre ek ücretlendirilir. |
Faturalama ayrıntıları için bkz. Temel hizmet faturalaması ve Kaynak planları.