html5 udp socket

html5-udp-ソケット

[下書き]

元 W3C Sysapps WG によって提案された UDP ソケット API

注: この仕様の時点では、STREAM API はまだ最終化されていませんでした。この実装では、アルゴリズムにいくつかの調整が必要になる可能性があります。

リファレンス: TCP UDP ソケット API

使用方法

注意していただきたいことへ：

1. この実装はまだ進行中の草案にすぎません。少なくとも、 readableおよびwritable Stream プロパティの実装を完了する必要があります。
2. 専用ベンダーで動作する上位層としての利用が想定される

目的は、次のようなベンダー アダプターを作成することです。

• Cordova プラグイン (Android/iOS/...)
• React Native / NativeScript
• Chromeアプリ
• Firefox OS
• WinJS
• ノード.js / ワカンダ
• CommonJS

誰でもこのプロジェクトに貢献することを大歓迎です ;-)

使用例

 //
// 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 ) ;
) ; 

MITライセンス

著作権 (c) 2016 アレクサンドル モルゴー

本ソフトウェアおよび関連ドキュメント ファイル (以下「ソフトウェア」) のコピーを入手した人には、使用、コピー、変更、マージする権利を含むがこれらに限定されない、制限なくソフトウェアを取り扱う許可が、ここに無償で与えられます。 、以下の条件を条件として、本ソフトウェアのコピーを出版、配布、サブライセンス、および/または販売すること、および本ソフトウェアが提供される人物にそれを許可すること。

上記の著作権表示およびこの許可通知は、ソフトウェアのすべてのコピーまたは主要部分に含まれるものとします。

ソフトウェアは「現状のまま」提供され、明示的か黙示的かを問わず、商品性、特定目的への適合性、および非侵害の保証を含むがこれらに限定されない、いかなる種類の保証も行われません。いかなる場合においても、作者または著作権所有者は、契約行為、不法行為、またはその他の行為であるかどうかにかかわらず、ソフトウェアまたはソフトウェアの使用またはその他の取引に起因または関連して生じる、いかなる請求、損害、またはその他の責任に対しても責任を負わないものとします。ソフトウェア。