WebRTC - RTCDataChannel API'leri
WebRTC yalnızca ses ve video akışlarını aktarmada değil, sahip olabileceğimiz herhangi bir keyfi veride de iyidir. RTCDataChannel nesnesi burada devreye girer.
RTCDataChannel API
Özellikleri
RTCDataChannel.label (read only) - Veri kanalı adını içeren bir dize döndürür.
RTCDataChannel.ordered (read only) - İletilerin teslim sırası garantiliyse doğru veya garanti edilmezse yanlış döndürür.
RTCDataChannel.protocol (read only) - Bu kanal için kullanılan alt protokol adını içeren bir dize döndürür.
RTCDataChannel.id (read only) - RTCDataChannel nesnesinin oluşturulması sırasında ayarlanan kanal için benzersiz bir kimlik döndürür.
RTCDataChannel.readyState (read only)- Bağlantının durumunu temsil eden RTCDataChannelState numaralandırmasını döndürür. Olası değerler -
connecting- Bağlantının henüz aktif olmadığını gösterir. Bu başlangıç durumudur.
open - Bağlantının çalıştığını gösterir.
closing- Bağlantının kapanma sürecinde olduğunu gösterir. Önbelleğe alınan mesajlar gönderilme veya alınma sürecinde, ancak yeni oluşturulan hiçbir görev kabul edilmiyor.
closed - Bağlantının kurulamadığını veya kapatıldığını gösterir.
RTCDataChannel.bufferedAmount (read only)- Gönderilmek üzere sıraya alınmış bayt miktarını döndürür. Bu, RTCDataChannel.send () aracılığıyla henüz gönderilmemiş veri miktarıdır.
RTCDataChannel.bufferedAmountLowThreshold- RTCDataChannel.bufferedAmount'un düşük tutulduğu bayt sayısını döndürür. RTCDataChannel.bufferedAmount bu eşiğin altına düştüğünde, bufferedamountlow olayı tetiklenir.
RTCDataChannel.binaryType- Bağlantı tarafından iletilen ikili verinin türünü döndürür. "Blob" veya "arraybuffer" olabilir.
RTCDataChannel.maxPacketLifeType (read only) - Mesajlaşma güvenilmez moda girdiğinde, pencerenin milisaniye cinsinden uzunluğunu gösteren işaretsiz bir kısa döndürür.
RTCDataChannel.maxRetransmits (read only) - Bir kanalın teslim edilmediği takdirde veriyi yeniden ileteceği maksimum sayıyı gösteren işaretsiz bir kısa mesaj döndürür.
RTCDataChannel.negotiated (read only) - Kanalın kullanıcı aracısı veya uygulama tarafından müzakere edilip edilmediğini gösteren bir boole döndürür.
RTCDataChannel.reliable (read only) - Bağlantının güvenilmez modda mesajlar gönderebileceğini gösteren bir boole döndürür.
RTCDataChannel.stream (read only) - RTCDataChannel.id ile eşanlamlıdır
Etkinlik sahipleri
RTCDataChannel.onopen- Bu olay işleyicisi, açık olay tetiklendiğinde çağrılır. Bu olay, veri bağlantısı kurulduğunda gönderilir.
RTCDataChannel.onmessage- Bu olay işleyicisi, mesaj olayı tetiklendiğinde çağrılır. Olay, veri kanalında bir mesaj olduğunda gönderilir.
RTCDataChannel.onbufferedamountlow- Bu olay işleyicisi, bufferedamoutlow olayı tetiklendiğinde çağrılır. Bu olay, RTCDataChannel.bufferedAmount, RTCDataChannel.bufferedAmountLowThreshold özelliğinin altına düştüğünde gönderilir.
RTCDataChannel.onclose- Bu olay işleyicisi, close olayı tetiklendiğinde çağrılır. Bu olay, veri bağlantısı kapatıldığında gönderilir.
RTCDataChannel.onerror- Bu olay işleyici, hata olayı tetiklendiğinde çağrılır. Bu olay, bir hatayla karşılaşıldığında gönderilir.
Yöntemler
RTCDataChannel.close() - Veri kanalını kapatır.
RTCDataChannel.send()- Parametredeki verileri kanal üzerinden gönderir. Veriler bir blob, bir dize, bir ArrayBuffer veya bir ArrayBufferView olabilir.