upnp_search

upnp_search_all

UPNPのSSDPを利用し条件に合うすべてのデバイスを検索します

説明

定義

upnp_search_all(検索したい文字列,[タイムアウトミリ秒]);

引数

1.検索したい文字列: 検索したいデバイスの名前やUUIDなどを書きます。
M-SEARCHメソッドの応答ヘッダーの、URN,STから検索します。
検索は部分一致です。
2.タイムアウトミリ秒: タイムアウトする時間をミリ秒で書きます。
すべてのデバイスを検索するため、タイムアウトまでこの関数は応答を返しません。
(互換性のためミリ秒で書きますが、内部的には、千分の一されて秒で計算されます。)
(ディフォルトのタイアアウトは5000ミリ秒(5秒)です)。

戻り値

見つかったデバイスを配列で返します。
デバイスが1つも見つからないと空配列を返します。
この関数は同期処理されます。

例

//rootdeviceを検索します。
var device = upnp_search_all("rootdevice",5000);
dump(device);

注意とヒント

検索は ssdp:all で行われます。

この関数はデバイスを検索するときは、ssdp:all で検索を行います。
その結果を、第一引数の検索したい文字列で絞り込みます。

必ずタイムアウトまで処理が停止します。

すべてのデバイスを検索するため、タイムアウトに指定した時間まで処理が停止します。
タイムアウトの時間まで調べてみないと、すべてのデバイスを検索しきれないためです。

参考