Tüm Ürünler
Search
Belge Merkezi

ApsaraVideo VOD:Temel özellikler

Son Güncelleme:Oct 20, 2026

Web için ApsaraVideo Player SDK'yı kullanırken, yaygın olarak kullanılan özelliklerin ayarları farklı oynatıcılara, oynatma yöntemlerine veya tarayıcı ortamlarına göre değişebilir. Bu konuda, Web için ApsaraVideo Player SDK'nın temel özelliklerinin nasıl yapılandırılacağı açıklanmaktadır.

Yaygın ayarlar

Web oynatıcıyı kullanarak Flash Video (FLV) ve HTTP Live Streaming (HLS) videolarını oynatmak istiyorsanız çapraz kaynak paylaşımını (CORS) yapılandırmanız gerekir. Daha fazla bilgi için bkz. Çapraz erişimi yapılandırma.

  • Web oynatıcıyı kullanırken CORS'u yapılandırmazsanız oynatma sırasında aşağıdaki hata iletisi döner:

    No 'Access-Control-Allow-Origin' header is present on the requested resource.

Not

Tam ekran oynatma başladıktan sonra sanal klavyeyi etkinleştirmek üzere mutlak konumlandırmayı ayarlayacak şekilde girişi yapılandırabilirsiniz.

Çağrı yöntemleri

Web için ApsaraVideo Player SDK'nın temel özelliklerini nitelikler veya yöntemler kullanarak etkinleştirirsiniz.

Not

Daha fazla bilgi için bkz. Aliplayer API Başvurusu.

Aşağıdaki örnek kod yöntemlerin nasıl çağrılacağını gösterir:

Oynatıcı oluşturmak için kullanılan işlevin geri aramasında aşağıdaki yöntemi çağırın. Örnek kod:

var player = new Aliplayer({},function(player) {
    player.setSpeed(2);
 });

Medya oynatmayı yönetme

Web için ApsaraVideo Player SDK videoları belirli bir zaman noktasından oynatmanıza ve oynatmayı duraklatmanıza olanak tanır.

Videoyu belirli bir zaman noktasından oynatma

Bir videoyu belirli bir zaman noktasından oynatmak için seek yöntemini çağırın. Örnek kod:

// time specifies the specified point in time. Unit: seconds. 
player.seek(time)

Oynatmayı duraklatma

Oynatmayı duraklatmak için pause yöntemini çağırın. Örnek kod:

player.pause()
Not

Büyük oynat düğmesini görüntülemek için bu parametreyi true olarak ayarlayın. Örnek: player.pause(true).

Oynatıcıyı yok etme

Bir oynatıcıyı yok etmek için dispose yöntemini çağırın. Örnek kod:

player.dispose()

Görüntüleme modunu belirtme

Not
  • PC ve iOS tarayıcıları görüntü ayarlarını destekler.

  • Android için Chrome ve Firefox görüntü ayarlarını destekler.

  • WeChat ve diğer çoğu tarayıcı oynatma için yerleşik oynatıcıyı kullanır. Bu nedenle görüntü ayarları desteklenmez.

Döndürme açısını belirtme

Bir görüntüyü belirtilen açıya göre döndürmek için setRotate işlemini çağırın. Döndürme açısını da sorgulayabilirsiniz. Örnek kod:

// Specify the rotation angle. A positive value of Angle specifies a clockwise rotation. A negative value of Angle specifies an anticlockwise rotation. For example, player.setRotate(180) specifies a clockwise rotation of 180 degrees. 
player.setRotate(<Angle>)
// Obtain the rotation angle. 
player.getRotate()

Yansıtma modunu belirtme

Yansıtma modunu yapılandırmak için setImage öğesini çağırın. Desteklenen modlar: yatay yansıtma ve dikey yansıtma. Örnek kod:

// Horizontal mirroring.
player.setImage('horizon')
// Vertical mirroring.
player.setImage('vertical')

Web için ApsaraVideo Player SDK bir videonun yüksekliğini ve genişliğini belirtmeniz için videoHeight ve videoWidth niteliklerini sağlar. Çoğu durumda bir videonun yüksekliği ve genişliği kapsayıcınınkinden daha küçüktür. Bu durum döndürme ve yansıtma sırasında videonun üst kapsayıcıdan taşmasını önler. Örnek kod:

 width: '100', // The width of the container.
 height: '100%', // The height of the container.
 videoHeight:"200px", // The height of the video.

Oynatma bilgilerini alma

Web için ApsaraVideo Player SDK mevcut oynatma ilerlemesini ve oynatma süresini almanıza olanak tanır.

Oynatma ilerlemesini alma

Mevcut oynatma ilerlemesini almak için getCurrentTime öğesini çağırın. Örnek kod:

// The returned time is measured in seconds. 
player.getCurrentTime()

Oynatma süresini alma

Bir videonun toplam süresini sorgulayabilirsiniz. Video yüklendikten sonra video süresini sorgulayabilirsiniz. Örneğin oynatma olayı gerçekleştikten sonra video süresini sorgulayabilirsiniz. Videonun toplam süresini almak için getDuration öğesini çağırın. Süreyi yalnızca video yüklendikten sonra veya oynatma olayı gerçekleştikten sonra alabilirsiniz. Örnek kod:

player.getDuration()

Oynatma durumunu alma

Oynatma durumunu almak için getStatus öğesini çağırın. Dönüş değerleri:

  • init: Başlatılıyor.

  • ready: Hazır.

  • loading: Yükleniyor.

  • play: Oynatılıyor.

  • pause: Duraklatıldı.

  • playing: Oynatılıyor.

  • waiting: Arabelleğe alınıyor.

  • error: Hata.

  • ended: Sona erdi.

Örnek kod:

player.getStatus()

Ses düzeyini belirtme

Ses düzeyini ayarlayabilir veya videonun sesini kapatabilirsiniz.

Not

iOS ve bazı Android sistemlerinde video.volume özelliği salt okunur olduğundan Web için ApsaraVideo Player SDK tarafından sağlanan getVolume ve setVolume yöntemleri iOS ve bazı Android sistemlerinde çalışmaz.

Ses düzeyini ayarlama

Ses düzeyini ayarlamak için setVolume işlemini çağırın. Mevcut ses düzeyini de alabilirsiniz. Örnek kod:

// Set the volume to a real number from 0 to 1. 
player.setVolume(0)
// Obtain the current volume. 
player.getVolume()

Sessiz modu yapılandırma

Oynatma sırasında videonun sesini kapatmak için mute yöntemini çağırın. Örnek kod:

// Mute the video.
player.mute();
// Unmute the video.
player.unMute();

Oynatma hızını belirtme

Web için ApsaraVideo Player SDK'nın varsayılan kullanıcı arayüzünü (UI) kullanıyorsanız videoyu izlerken oynatma hızını ayarlamak için yerleşik oynatma hızı özelliğini kullanabilirsiniz. Özel bir kullanıcı arayüzü kullanıyorsanız oynatma hızını ayarlamak için setSpeed işlemini çağırabilirsiniz.

Not

Oynatma hızı ayarlarının nasıl devre dışı bırakılacağı hakkında daha fazla bilgi için Aliplayer API Başvurusu konusunun setSpeed bölümüne bakın.

Örnek kod:

// Specify the playback speed. The following sample code provides an example on how to set the playback speed to twice the current speed. 
player.setSpeed(2)

Çoklu çözünürlükte oynatma

Çoklu çözünürlükte oynatma için birden çok çözünürlükteki akışların URL'lerini yapılandırabilirsiniz.

  • Oynatma için VID ve PlayAuth kullanıyorsanız ek ayar gerekmez. Web için ApsaraVideo Player SDK çözünürlük listesini ApsaraVideo VOD'dan alır. Çözünürlük listesini görüntülemek için oynatma sayfasındaki Settings seçeneğine tıklayabilirsiniz.

    Not

    Oynatma için VID ve PlayAuth kullanıyorsanız HTML5 oynatıcı için MP4 veya MP3 biçimindeki medya dosyalarının oynatılıp oynatılmayacağını belirlemek üzere format niteliğini belirtebilirsiniz. Varsayılan olarak MP4 biçimindeki medya dosyaları oynatılır.

  • URL tabanlı oynatma kullanıyorsanız birden çok çözünürlükteki akışların URL'lerini belirtmek için source niteliğindeki anahtar-değer çiftlerini yapılandırmanız gerekir. Anahtar-değer çiftleri JSON biçimindedir. Ayarlar uygulandıktan sonra çözünürlük listesini görüntülemek için oynatma sayfasındaki Settings seçeneğine tıklayabilirsiniz.

Not

Çözünürlük listesinin görüntülenme şeklini değiştirmek istiyorsanız çözünürlük bileşenini kullanabilirsiniz. Örnek kod hakkında daha fazla bilgi için bkz. İşlevler.

URL tabanlı oynatma modunda source niteliğinde aşağıdaki anahtar-değer çiftleri desteklenir:

   "OD": "<Original quality URL>"
   "FD": "<Low definition URL>"
   "LD":"<Standard definition URL>"
   "SD": "<High definition URL>"
   "HD": "<Ultra-high definition URL>"
   "2K": "<2K URL>"
   "4K": "<4K URL>"

Aşağıdaki örnek kod URL tabanlı oynatma modunda çözünürlüklerin nasıl yapılandırılacağını gösterir:

// The following example shows how to configure the high definition and ultra-high definition URLs. 
source:'{"HD":"http://******/player/hdexample.mp4","SD":"http://******/player/sdexample.mp4"}'

Web için ApsaraVideo Player SDK ayrıca çözünürlükleri artan veya azalan sırada listelemek için qualitySort niteliğini belirtmenize olanak tanır.

  • desc değeri en yüksek çözünürlükten en düşük çözünürlüğe doğru azalan sırayı belirtir.

  • asc değeri en düşük çözünürlükten en yüksek çözünürlüğe doğru artan sırayı belirtir.

Not
  • Oynatıcı belirttiğiniz çözünürlüğü korur. Videoyu bir sonraki oynatışınızda en son belirttiğiniz çözünürlük kullanılır. Videoyu en son oynattığınızda bir çözünürlük belirtmediyseniz oynatma için düşük bir çözünürlük kullanılır.

  • Video belirtilen çözünürlükte oynatılamazsa oynatıcı otomatik olarak bir sonraki daha düşük çözünürlüğe geçer ve bir mesaj görüntüler. Çözünürlük değiştirmeyi yalnızca HTML5 oynatıcı destekler.

Döngüsel oynatmayı etkinleştirme

Web için ApsaraVideo Player SDK döngüsel oynatma için rePlay niteliğini belirtmenize veya ended olayını dinlemenize olanak tanır.

rePlay niteliğini belirtmek için kullanılan örnek kod

rePlay:true

ended olayını dinlemek için kullanılan örnek kod

player.on('ended',function(){
   player.replay()
})

Mobil cihazlarda hareket işlemleri

Web için Player SDK mobil cihazlardaki küçük ekranlar için optimize edilmiştir. İlerleme çubuğunun sürüklenmesi daha kolaydır. İki özel özellik sunulur: basılı tutarak hızlandırma ve hızlı ileri veya geri sarmak için çift tıklama.

Basılı tutarak hızlandırma

Varsayılan olarak mobil cihazlarda basılı tutarak hızlandırma özelliği etkindir. İlerleme çubuğu hariç oynatıcının herhangi bir alanına 0,5 saniyeden uzun süre basılı tutarsanız video daha hızlı bir hızda oynatılır. Basılı tutmayı bıraktığınızda video orijinal hızda oynatılır.

Bu özelliği longPressFastForward: false parametresini yapılandırarak da devre dışı bırakabilirsiniz. Daha fazla bilgi için bkz. Aliplayer API Başvurusu.

Hızlı ileri veya geri sarmak için çift tıklama

Varsayılan olarak mobil cihazlarda hızlı ileri veya geri sarmak için çift tıklama özelliği etkindir. Oynatıcının sol üçte birlik alanına çift tıklarsanız video 10 saniye geri sarar. Oynatıcının sağ üçte birlik alanına çift tıklarsanız video 10 saniye ileri sarar.

Bu özelliği dbClickSkip: false parametresini yapılandırarak da devre dışı bırakabilirsiniz. Daha fazla bilgi için bkz. Aliplayer API Başvurusu.

Başvurular