Video durumu bilgilerinin aktarımı
Video durumu hakkında bilgiler Yandex.Video aramasında oynatma kalitesini artırmak için kullanılır. Örneğin, videonun başlangıç ve bitiş saati, ileri sarma süresi gibi bilgilerin yanı sıra video oynatılırken oluşan hatalar da gereklidir.
Video durumunu bildiren işlemler
Video durumu bilgilerinin aktarımı için postMessage aracını kullanın: Videonun başlatılması gibi, oynatıcıyı ilgilendiren her işlem için JavaScript kodunda birer window.parent.postMessage
işlevi etkinleştirin. Bu işlevin parametreleri olarak ilgili işlem adının ve ilerleme çubuğu durumu gibi bazı ek parametrelerin kullanılması önerilir.
postMessage
işlevi bir üst nesne olan window.parent
için etkinleştirilmelidir. Bunun nedeni, Yandex.Video'da videonun servisin ana sayfasında değil ayrı bir çerçevede (iframe öğesinde
) görüntülenmesidir. window.parent.postMessage
({ event: <İşlem adı>,
// işlemin ek parametreleri
}, '*');

TV için Yandex.Video uygulamasında ve mobil video aramasında oynatıcının gösterilmesi için zorunlu işlemler ve bunların parametreleri aktarılmalıdır. Ek işlemlerin aktarılması sayesinde kullanıcılar ile oynatıcı arasındaki etkileşim daha kullanışlı olacaktır.
İşlem | Açıklama | İşlem parametreleri |
---|---|---|
Zorunlu | ||
inited | Oynatıcının başlatılması | — |
started | Videonun başlatılması veya durdurulduktan sonra oynatmaya devam edilmesi |
|
timeupdate | Videonun oynatılması (tekrarlanarak) |
|
paused | Videonun durdurulması |
|
ended | Videonun sona ermesi (sonuna kadar oynatılması) |
|
error | Video oynatma hatası |
|
Ek | ||
resumed | Oynatmanın yeniden başlatılması |
Not. resumed işlemi zorunlu started işlemi ile değiştirilebilir. |
rewound | Videonun sarılması |
|
volumeChange | Sesin açılması, kapatılması veya seviyesinin değiştirilmesi |
|
adShown | Reklam gösteriminin başlatılması |
|
İşlem | Açıklama | İşlem parametreleri |
---|---|---|
Zorunlu | ||
inited | Oynatıcının başlatılması | — |
started | Videonun başlatılması veya durdurulduktan sonra oynatmaya devam edilmesi |
|
timeupdate | Videonun oynatılması (tekrarlanarak) |
|
paused | Videonun durdurulması |
|
ended | Videonun sona ermesi (sonuna kadar oynatılması) |
|
error | Video oynatma hatası |
|
Ek | ||
resumed | Oynatmanın yeniden başlatılması |
Not. resumed işlemi zorunlu started işlemi ile değiştirilebilir. |
rewound | Videonun sarılması |
|
volumeChange | Sesin açılması, kapatılması veya seviyesinin değiştirilmesi |
|
adShown | Reklam gösteriminin başlatılması |
|
İşlem | Açıklama | İşlem parametreleri |
---|---|---|
Zorunlu | ||
inited | Oynatıcının başlatılması | — |
started | Videonun başlatılması veya durdurulduktan sonra oynatmaya devam edilmesi |
|
paused | Videonun durdurulması |
|
ended | Videonun sona ermesi (sonuna kadar oynatılması) |
|
error | Video oynatma hatası |
|
Ek | ||
resumed | Oynatmanın yeniden başlatılması |
Not. resumed işlemi zorunlu started işlemi ile değiştirilebilir. |
rewound | Videonun sarılması |
|
adShown | Reklam gösteriminin başlatılması |
|
İşlem | Açıklama | İşlem parametreleri |
---|---|---|
Zorunlu | ||
inited | Oynatıcının başlatılması | — |
started | Videonun başlatılması veya durdurulduktan sonra oynatmaya devam edilmesi |
|
paused | Videonun durdurulması |
|
ended | Videonun sona ermesi (sonuna kadar oynatılması) |
|
error | Video oynatma hatası |
|
Ek | ||
resumed | Oynatmanın yeniden başlatılması |
Not. resumed işlemi zorunlu started işlemi ile değiştirilebilir. |
rewound | Videonun sarılması |
|
adShown | Reklam gösteriminin başlatılması |
|
Bir video başlatıldığında bilgilerin nasıl aktarıldığı aşağıda örneklenmiştir. Kullanıcı oynatıcının Play butonuna tıkladığında oynatıcı window.parent.postMessage
işlevini etkinleştirir.
// Video başlatıldığında ileti gönderimi
window.parent.postMessage({
event: 'started',
duration: 30,
time: 5 // Videonun 5. saniyeden sonra yeniden oynatılması halinde
}, '*');
Hata bilgileri
Videolarla çalışmalar sırasında ortaya çıkan hatalara dair bilgi alabilmemiz için oynatıcı window.parent.postMessage
işlevine aşağıda sıralanan hata kodları iletebilmelidir:
Hata kodu | Açıklama |
---|---|
Videoya erişilemiyor | |
101 | Video kaldırıldı |
102 | Video veya kullanıcı hesabı engellendi |
103 | Video mevcut değil veya URL desteklenmiyor |
100 | Videoya erişilemeyen diğer durumlar |
Videoya erişim sınırlı | |
151 | Videoyu izlemek için yetkiniz yok |
152 | Videonun başka sitelerde oynatılması yasak |
153 | Videonun bu bölgede oynatılması yasak |
154 | Yaş kısıtlaması gibi kullanıcının onayını gerektiren erişim kısıtlaması |
150 | Videonun izlenmesini engelleyen diğer kısıtlamalar |
Diğer | |
5 | Oynatıcı hatası (ör., HTML oynatıcısının çalışmasında ortaya çıkan hatalar) |
0 | Diğer hatalar |
Hata kodu | Açıklama |
---|---|
Videoya erişilemiyor | |
101 | Video kaldırıldı |
102 | Video veya kullanıcı hesabı engellendi |
103 | Video mevcut değil veya URL desteklenmiyor |
100 | Videoya erişilemeyen diğer durumlar |
Videoya erişim sınırlı | |
151 | Videoyu izlemek için yetkiniz yok |
152 | Videonun başka sitelerde oynatılması yasak |
153 | Videonun bu bölgede oynatılması yasak |
154 | Yaş kısıtlaması gibi kullanıcının onayını gerektiren erişim kısıtlaması |
150 | Videonun izlenmesini engelleyen diğer kısıtlamalar |
Diğer | |
5 | Oynatıcı hatası (ör., HTML oynatıcısının çalışmasında ortaya çıkan hatalar) |
0 | Diğer hatalar |
// Hata bildiriminin gönderilmesi
window.parent.postMessage({
event: 'error',
time: 62,
code: '101'
}, '*');
Oynatıcının URL'sinde parametrelerin desteklenmesi

Smart TV ve mobil cihazlarda kullanıcıların videoyu daha iyi oynatabilmesi için oynatıcının URL'sinde aşağıdaki parametreler desteklenmelidir:
Parametre | Açıklama | Geçerli değerler |
---|---|---|
Zorunlu | ||
autoplay | Videonun otomatik oynatılması |
|
tv | Smart TV'lerde etkileşimli oynatıcı öğelerinin yönetimi |
Parametre, sadece fare imleciyle tıklanabilen tüm öğelerin görüntülenmesini yönetir. Bu öğeler arasında ilerleme çubuğu, açılan sezon ve bölüm seçenekleri, oynatma kalitesi butonları, video oynatma menüsü gibi öğeler bulunur. Bu öğeler otomatik gizlenerek video daha rahat izlenebilir. |
Ek | ||
maxQuality | Oynatma kalitesi seçenekleri |
small Oynatıcı boyu: 240 piksel 4:3 formatı için minimum oynatıcı boyutları: 320 х 240 piksel medium Oynatıcı boyu: 360 piksel Minimum oynatıcı boyutları: large Oynatıcı boyu: 480 piksel Minimum oynatıcı boyutları: hd720 Oynatıcı boyu: 720 piksel Minimum oynatıcı boyutları: hd1080 Oynatıcı boyu: 1080 piksel Minimum oynatıcı boyutları: highres Oynatıcı boyu: 1080+ piksel En boy oranı 1920 x 1080 pikselden fazla default Bu parametre kullanıcı ayarlarına, video dosyasına ve diğer şartlara bağlı olarak tercih edilen oynatma kalitesini seçer. |
Parametre | Açıklama | Geçerli değerler |
---|---|---|
Zorunlu | ||
autoplay | Videonun otomatik oynatılması |
|
tv | Smart TV'lerde etkileşimli oynatıcı öğelerinin yönetimi |
Parametre, sadece fare imleciyle tıklanabilen tüm öğelerin görüntülenmesini yönetir. Bu öğeler arasında ilerleme çubuğu, açılan sezon ve bölüm seçenekleri, oynatma kalitesi butonları, video oynatma menüsü gibi öğeler bulunur. Bu öğeler otomatik gizlenerek video daha rahat izlenebilir. |
Ek | ||
maxQuality | Oynatma kalitesi seçenekleri |
small Oynatıcı boyu: 240 piksel 4:3 formatı için minimum oynatıcı boyutları: 320 х 240 piksel medium Oynatıcı boyu: 360 piksel Minimum oynatıcı boyutları: large Oynatıcı boyu: 480 piksel Minimum oynatıcı boyutları: hd720 Oynatıcı boyu: 720 piksel Minimum oynatıcı boyutları: hd1080 Oynatıcı boyu: 1080 piksel Minimum oynatıcı boyutları: highres Oynatıcı boyu: 1080+ piksel En boy oranı 1920 x 1080 pikselden fazla default Bu parametre kullanıcı ayarlarına, video dosyasına ve diğer şartlara bağlı olarak tercih edilen oynatma kalitesini seçer. |
Mobil cihazlarda kullanıcıların videoyu daha iyi oynatabilmesi için oynatıcının URL'sinde zorunlu parametreler desteklenmelidir:
Parametre | Açıklama | Geçerli değerler |
---|---|---|
autoplay | Videonun otomatik oynatılması |
|
Parametre | Açıklama | Geçerli değerler |
---|---|---|
autoplay | Videonun otomatik oynatılması |
|
Smart TV'lerde oynatıcı yönetimi
Oynatıcı yönetim komutları iframe
'e dış pencereden postMessage aracılığıyla iletilir. iframe
içindeki iletileri almak için mesaja
abone olun. Komut formatı zorunlu method
satırını içeren JSON objesidir.
Komut | Açıklama |
---|---|
play | Videonun başlatılması veya devam ettirilmesi |
pause | Videonun durdurulması |
seek | Videonun mutlak zaman olarak sarılması |
setVolume | Sesin ayarlanması |
mute | Sesin kapatılması |
unmute | Sesin açılması |
setQuality | Oynatma kalitesi ayarları |
Komut | Açıklama |
---|---|
play | Videonun başlatılması veya devam ettirilmesi |
pause | Videonun durdurulması |
seek | Videonun mutlak zaman olarak sarılması |
setVolume | Sesin ayarlanması |
mute | Sesin kapatılması |
unmute | Sesin açılması |
setQuality | Oynatma kalitesi ayarları |
Komuta göre video oynatma örneği
window.addEventListener('message', function (event) {
if (event.data.method === 'play') {
document.getElementById('video').play();
}
});
Cevap formatı
Komutların uygulanıp uygulanmadığını bildirmek için video durumu işlemlerini kullanın.