Apparaten in de buurt ontdekken
Controleer app.capabilities voor functieondersteuning en app.access plus hostrechten voor autorisatie. Voorbeelden gebruiken synthetische waarden; vervang paden, ID’s, invoer en filters vóór aanroepen.
Elke 2 seconden leest de pagina isDiscovering en nearbyDevices met één GraphQL-query, werkt de lijst bij en roept startDiscovery alleen aan als het scannen is gestopt. Bij sluiten roept zij stopDiscovery aan, ongeacht andere pagina’s. Scannen stopt vijf minuten na de laatste start. BLE werkt apart.
UDP → 224.0.0.251:5353PTR query
IPv4-multicast, geen IP-broadcast: 224.0.0.251:5353. A zoekt elke 5 s; B kondigt zich ook bij het starten en elke 60 s aan. PTR-antwoorden bevatten SRV, TXT en A. De pop-ups tonen gedecodeerde synthetische DNS-records.
Typedefinities
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
}Bewerkingen
acquireMdnsDebugSession
Een mDNS-debugsessie verkrijgen met een UUID-token van de aanroeper. Vereist HTTP_SERVER; geef de sessie vrij bij het sluiten van de debugpagina.
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}releaseMdnsDebugSession
De mDNS-debugsessie vrijgeven met het bijbehorende token. Vereist HTTP_SERVER.
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}startDiscovery
Apparaatdetectie starten.
mutation startDiscovery {
startDiscovery
}stopDiscovery
Apparaatdetectie stoppen.
mutation stopDiscovery {
stopDiscovery
}isDiscovering
Of er momenteel een detectiescan loopt.
query isDiscovering {
isDiscovering
}mdnsState
De huidige mDNS-detectiestatus en geselecteerde service- of pakketdetails lezen.
query mdnsState {
mdnsState { runtimeId revision running scanning }
}nearbyDevices
Momenteel bekende apparaten in de buurt weergeven die voor detectie of koppeling beschikbaar zijn.
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}parsePairingQrCode
Een geldige koppelingscode decoderen naar verbindingsinformatie van een apparaat in de buurt.
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}