Videonun durumu bilgilerinin aktarımı

Yandex.Video aramasında oynatma kalitesini arttırmak için videonun durumu hakkında bilgileri almalıyız. Örneğin videonun başlangıç veya bitiş saatini, ileri sarma süresi vs. Bunun yanı sıra video oynatılırken oluşan hatalar ile ilgili bilgi almalıyız.

Videonun durum bilgilerinin aktarımı için postMessage aracını kullanın: Video oynatımının başlaması gibi, oynatıcıyı ilgilendiren her bir gelişme için JavaScript kodunda birer window.parent.postMessage işlevi etkinleştirin. Bu işlevin parametreleri olarak ilgili gelişmenin adının ve ilerleme çubuğu durumu gibi bazı ek parametrelerin kullanılması önerilir.

window.parent.postMessage({
    event: <Gelişme adı>,
    time: <İlerleme çubuğunun saniye bazındaki durumu>,
    code: <Hata kodu>,
    ...        
}, '*');

Not. NOT: 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.

Video bilgilerinin tarafımızca analiz edilebilmesi için gelişmelerin robotumuzun tanıyabileceği şekilde bildirlmesi gerekir. Robotun işlediği gelişme türleri ve aktarılması gereken parametreler aşağıdaki tabloda sıralanır:


Gelişme	Açıklama	Gelişme parametreleri
Zorunlu
inited	Oynatıcının çalıştırılması.	—
started	Video oynatılmasının başlanması.	`time`: ilerleme çubuğunun saniyeler olarak durumu. `time` parametresi belirtilmediği durumlarda değeri varsayılan olarak 0'a eşit olur.
paused	Videonun durdurulması.	`time`: ilerleme çubuğunun saniyeler olarak durumu.
ended	Videonun izlenmesi bitti (sonuna kadar oynatıldı).	`time`: ilerleme çubuğunun saniyeler olarak durumu.
error	Video oynatma hatası.	`time`: ilerleme çubuğunun saniyeler olarak durumu. `code`: Hata kodu.
Ek
autoplay	Otomatik oynatma.	`autoplay=1`: videoyu otomatik oynat `autoplay=0` (veya parametre belirtilmediyse): videoyu otomatik oynatma `<iframe src="//www.your-videohosting.com/video?autoplay=1"></iframe>` Not. İşaretlemede autoplay parametresiyle oynatıcının adresini belirtmek zorunlu değildir; aramada oynatıcıya eklendiğinde bu parametreyi desteklemek yeterlidir.
resumed	Oynatmanın yeniden başlatılması. Not. `started` gelişmesiyle değiştirilebilir.	`time`: ilerleme çubuğunun saniyeler olarak durumu.
rewound	Videonun sarılması. Not. `started` gelişmesiyle değiştirilebilir.	`time`: ilerleme çubuğunun saniyeler olarak durumu. `previousTime`: ilerleme çubuğunun saniye olarak bir önceki durumu.
adShown	Reklam gösteriminin başlatılması.	`time`: ilerleme çubuğunun saniyeler olarak durumu.


Gelişme	Açıklama	Gelişme parametreleri
Zorunlu
inited	Oynatıcının çalıştırılması.	—
started	Video oynatılmasının başlanması.	`time`: ilerleme çubuğunun saniyeler olarak durumu. `time` parametresi belirtilmediği durumlarda değeri varsayılan olarak 0'a eşit olur.
paused	Videonun durdurulması.	`time`: ilerleme çubuğunun saniyeler olarak durumu.
ended	Videonun izlenmesi bitti (sonuna kadar oynatıldı).	`time`: ilerleme çubuğunun saniyeler olarak durumu.
error	Video oynatma hatası.	`time`: ilerleme çubuğunun saniyeler olarak durumu. `code`: Hata kodu.
Ek
autoplay	Otomatik oynatma.	`autoplay=1`: videoyu otomatik oynat `autoplay=0` (veya parametre belirtilmediyse): videoyu otomatik oynatma `<iframe src="//www.your-videohosting.com/video?autoplay=1"></iframe>` Not. İşaretlemede autoplay parametresiyle oynatıcının adresini belirtmek zorunlu değildir; aramada oynatıcıya eklendiğinde bu parametreyi desteklemek yeterlidir.
resumed	Oynatmanın yeniden başlatılması. Not. `started` gelişmesiyle değiştirilebilir.	`time`: ilerleme çubuğunun saniyeler olarak durumu.
rewound	Videonun sarılması. Not. `started` gelişmesiyle değiştirilebilir.	`time`: ilerleme çubuğunun saniyeler olarak durumu. `previousTime`: ilerleme çubuğunun saniye olarak bir önceki durumu.
adShown	Reklam gösteriminin başlatılması.	`time`: ilerleme çubuğunun saniyeler olarak durumu.

Bir video oynatılması başlatıldığında bilgilerinin aktarıldığı bir örnek aşağıda açıklanır. Kullanıcı oynatıcının Play ("Oynat") butonuna tıkladığında oynatıcı videoStart işleyici işlevini etkinleştirir. Bu işlev ise gerekli parametrelerin etkinleştirilmiş olduğu window.parent.postMessage işlevini etkinleştirir.

// Kullanıcı oynatıcıda Play butonuna tıkladığında bu özellik etkinleştirilir.
function videoStart() {
    ...
    // İleti gönderimi.
    window.parent.postMessage({
        event: 'started'
        // Bunun yanı sıra time parametresi iletilebilir.
        // Time parametresi belirtilmediyse varsayılan olarak
        // 0 değerini alır.
    }, '*');
}

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ı engellenmiştir.
103	Video mevcut değil veya URL desteklenmiyor.
100	Videoya erişilemeyen diğer durumlar.
Videoya erişim sınırlıdır
151	Videoyu izlemek için haklar yetersizdir.
152	Videonun başka sitelerde oynatılması yasağı var.
153	Videonun bu coğrafi bölgede oynatılması yasağı var.
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ğeri
5	Oynatıcı hatası (HTML oynatıcısınnın çalışmasında ortaya çıkan hatalar vb.).
0	Diğer hatalar.


Hata kodu	Açıklama
Videoya erişilemiyor
101	Video kaldırıldı.
102	Video veya kullanıcı hesabı engellenmiştir.
103	Video mevcut değil veya URL desteklenmiyor.
100	Videoya erişilemeyen diğer durumlar.
Videoya erişim sınırlıdır
151	Videoyu izlemek için haklar yetersizdir.
152	Videonun başka sitelerde oynatılması yasağı var.
153	Videonun bu coğrafi bölgede oynatılması yasağı var.
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ğeri
5	Oynatıcı hatası (HTML oynatıcısınnın çalışmasında ortaya çıkan hatalar vb.).
0	Diğer hatalar.

function videoError(time, code) {
    // ...
    window.parent.postMessage({
        event: 'error',
        time: '62',
        code: '101'
    }, '*');
}