近くのデバイス検出
機能の対応状況は app.capabilities、認可は app.access とホストの権限で確認してください。例は合成値を使用しています。呼び出す前にパス、ID、入力、フィルターを置き換えてください。
ページは2秒ごとに1回の GraphQL クエリで isDiscovering と nearbyDevices を読み、一覧を更新し、停止中だけ startDiscovery を呼びます。閉じると他のページに関係なく stopDiscovery を呼びます。最後の開始から5分後にスキャンは停止します。BLE は独立して動作します。
UDP → 224.0.0.251:5353PTR query
IP ブロードキャストではなく、IPv4 マルチキャスト 224.0.0.251:5353 を使用します。A は 5 秒ごとに探索し、B は起動時と 60 秒ごとにも通知します。PTR 応答には SRV、TXT、A が含まれます。ポップアップにデコード済みの合成 DNS レコードを表示します。
型定義
type Mutation {
acquireMdnsDebugSession(token: String!): Boolean!
releaseMdnsDebugSession(token: String!): Boolean!
startDiscovery: Boolean!
stopDiscovery: Boolean!
}
type Query {
isDiscovering: Boolean!
mdnsState: MdnsState!
nearbyDevices: [NearbyDevice!]!
parsePairingQrCode(code: String!): NearbyDevice
}
enum DeviceType {
COMPUTER
PHONE
TABLET
TV
NAS
OTHER
}
enum DiscoveryMethod {
LAN
BLE
QR
}
scalar Instant
scalar Long
type MdnsActivity {
time: Instant!
event: String!
detail: String!
}
type MdnsPacket {
time: Instant!
direction: MdnsPacketDirection!
srcIp: String!
srcPort: Int!
dstIp: String!
dstPort: Int!
size: Long!
summary: String!
detail: String!
}
enum MdnsPacketDirection {
IN
OUT
}
type MdnsService {
serviceType: String!
instanceName: String!
instanceFqdn: String!
hostname: String!
port: Int!
txtRecords: [String!]!
ips: [String!]!
ip6s: [String!]!
complete: Boolean!
}
type MdnsState {
runtimeId: String!
packetsIn: [MdnsPacket!]!
packetsOut: [MdnsPacket!]!
revision: Long!
running: Boolean!
scanning: Boolean!
services: [MdnsService!]!
activity: [MdnsActivity!]!
}
type NearbyDevice {
id: ID!
name: String!
ips: [String!]!
port: Int!
remoteAccess: Boolean
signaturePublicKey: String!
deviceType: DeviceType!
version: String!
platform: String!
discoveryMethods: [DiscoveryMethod!]!
bestIp: String!
status: PeerStatus!
lastSeen: Instant!
}
enum PeerStatus {
PAIRED
UNPAIRED
CHANNEL
}操作
acquireMdnsDebugSession
呼び出し元の UUID トークンで mDNS デバッグセッションを取得します。HTTP_SERVER が必要です。デバッグページを閉じる際に解放してください。
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}releaseMdnsDebugSession
一致するトークンで mDNS デバッグセッションを解放します。HTTP_SERVER が必要です。
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}startDiscovery
デバイスの検出を開始します。
mutation startDiscovery {
startDiscovery
}stopDiscovery
デバイスの検出を停止します。
mutation stopDiscovery {
stopDiscovery
}isDiscovering
現在、検出スキャンが実行中かどうかを示します。
query isDiscovering {
isDiscovering
}mdnsState
現在の mDNS 検出状態と、選択したサービスまたはパケットの詳細を読み取ります。
query mdnsState {
mdnsState { runtimeId revision running scanning }
}nearbyDevices
検出またはペアリングが可能な、現在認識している近くのデバイスを一覧表示します。
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}parsePairingQrCode
ペアリングコードが有効な場合、近くのデバイスの接続情報にデコードします。
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}