html5 udp socket
1.0.0
[ร่าง]
UDP Socket API ตามที่เสนอโดยอดีต W3C Sysapps WG
หมายเหตุ: ในขณะที่ข้อกำหนดนี้ STREAM API ยังไม่สิ้นสุด การใช้งานนี้อาจต้องมีการปรับเปลี่ยนบางอย่างในอัลกอริทึมของมัน
อ้างอิง: TCP UDP Socket API
ถึงสิ่งที่ควรทราบ:
readable และ writable เสร็จสมบูรณ์วัตถุประสงค์ในการเขียนอะแดปเตอร์ของผู้จำหน่ายเช่น:
ทุกคนยินดีอย่างยิ่งที่จะมีส่วนร่วมในโครงการนี้ ;-)
//
// This example shows a simple implementation of UPnP-SSDP M-SEARCH
// discovery using a multicast UDPSocket
//
var address = '239.255.255.250' ,
port = '1900' ,
serviceType = 'upnp:rootdevice' ,
rn = 'rn' ,
search = '' ;
// Request permission to send multicast messages to the address and
// port reserved for SSDP
navigator . udpPermission . requestPermission ( { remoteAddress : "239.255.255.250" ,
remotePort : 1900 } ) . then (
( ) => {
// Permission was granted
// Create a new UDP client socket
var mySocket = new UDPSocket ( ) ;
// Build an SSDP M-SEARCH multicast message
search += 'M-SEARCH * HTTP/1.1' + rn ;
search += 'ST: ' + serviceType + rn ;
search += 'MAN: "ssdp:discover"' + rn ;
search += 'HOST: ' + address + ':' + port + rn ;
search += 'MX: 10' ;
// Receive and log SSDP M-SEARCH response messages
function receiveMSearchResponses ( ) {
mySocket . readable . getReader ( ) . read ( ) . then ( ( { value , done } ) => {
if ( done ) return ;
console . log ( 'Remote address: ' + value . remoteAddress +
'Remote port: ' + value . remotePort +
'Message: ' + ab2str ( value . data ) ) ;
// ArrayBuffer to string conversion could also be done by piping
// through a transform stream. To be updated when the Streams API
// specification has been stabilized on this point.
} ) ;
}
// Join SSDP multicast group
mySocket . joinMulticast ( address ) ;
// Send SSDP M-SEARCH multicast message
mySocket . writeable . write (
{ data : str2ab ( search ) ,
remoteAddress : address ,
remotePort : port
} ) . then (
( ) => {
// Data sent sucessfully, wait for response
console . log ( 'M-SEARCH Sent' ) ;
receiveMSearchResponses ( ) ;
} ,
e => console . error ( "Sending error: " , e ) ;
) ;
// Log result of UDP socket setup.
mySocket . opened . then (
( ) => {
console . log ( "UDP socket created sucessfully" ) ;
} ,
e => console . error ( "UDP socket setup failed due to error: " , e ) ;
) ;
// Handle UDP socket closed, either as a result of the application
// calling mySocket.close() or an error causing the socket to be
// closed.
mySocket . closed . then (
( ) => {
console . log ( "Socket has been cleanly closed" ) ;
} ,
e => console . error ( "Socket closed due to error: " , e ) ;
) ;
} ,
e => console . error ( "Sending SSDP multicast messages was denied due to error: " , e ) ;
) ; ลิขสิทธิ์ (c) 2016 Alexandre Morgaut
อนุญาตให้บุคคลใดก็ตามที่ได้รับสำเนาของซอฟต์แวร์นี้และไฟล์เอกสารที่เกี่ยวข้อง ("ซอฟต์แวร์") อนุญาตโดยไม่เสียค่าใช้จ่าย เพื่อจัดการกับซอฟต์แวร์โดยไม่มีข้อจำกัด รวมถึงแต่ไม่จำกัดเพียงสิทธิ์ในการใช้ คัดลอก ปรับเปลี่ยน ผสาน เผยแพร่ แจกจ่าย ให้อนุญาตช่วง และ/หรือขายสำเนาของซอฟต์แวร์ และอนุญาตให้บุคคลที่ได้รับซอฟต์แวร์นี้สามารถทำได้ ภายใต้เงื่อนไขต่อไปนี้:
ประกาศเกี่ยวกับลิขสิทธิ์ข้างต้นและประกาศการอนุญาตนี้จะรวมอยู่ในสำเนาทั้งหมดหรือส่วนสำคัญของซอฟต์แวร์
ซอฟต์แวร์นี้มีให้ "ตามที่เป็น" โดยไม่มีการรับประกันใดๆ ทั้งโดยชัดแจ้งหรือโดยนัย ซึ่งรวมถึงแต่ไม่จำกัดเพียงการรับประกันความสามารถในการค้าขาย ความเหมาะสมสำหรับวัตถุประสงค์เฉพาะ และการไม่ละเมิด ไม่ว่าในกรณีใดผู้เขียนหรือผู้ถือลิขสิทธิ์จะต้องรับผิดต่อการเรียกร้องค่าเสียหายหรือความรับผิดอื่นใดไม่ว่าในการกระทำของสัญญาการละเมิดหรืออย่างอื่นที่เกิดขึ้นจากหรือเกี่ยวข้องกับซอฟต์แวร์หรือการใช้งานหรือข้อตกลงอื่น ๆ ใน ซอฟต์แวร์.
