Geräte in der Nähe
Funktionsunterstützung über app.capabilities prüfen, Autorisierung über app.access und Host-Berechtigungen. Die Beispiele verwenden synthetische Werte; vor dem Aufruf Pfade, IDs, Eingaben und Filter ersetzen.
Die Seite liest alle 2 Sekunden isDiscovering und nearbyDevices mit einer GraphQL-Abfrage, aktualisiert die Liste und ruft startDiscovery nur bei gestopptem Scan auf. Beim Schließen ruft sie unabhängig von anderen Seiten stopDiscovery auf. Der Scan endet fünf Minuten nach dem letzten Start. BLE läuft unabhängig.
UDP → 224.0.0.251:5353PTR query
IPv4-Multicast, kein IP-Broadcast: 224.0.0.251:5353. A sucht alle 5 Sekunden; B kündigt sich zusätzlich beim Start und alle 60 Sekunden an. PTR-Antworten enthalten SRV, TXT und A. Die Popups zeigen dekodierte synthetische DNS-Datensätze.
Typdefinitionen
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
}Operationen
acquireMdnsDebugSession
Eine mDNS-Debugsitzung mit einem UUID-Token des Aufrufers anfordern. Erfordert HTTP_SERVER; beim Schließen der Debugseite freigeben.
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}releaseMdnsDebugSession
Die mDNS-Debugsitzung mit dem zugehörigen Token freigeben. Erfordert HTTP_SERVER.
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}startDiscovery
Startet die Geräteerkennung.
mutation startDiscovery {
startDiscovery
}stopDiscovery
Stoppt die Geräteerkennung.
mutation stopDiscovery {
stopDiscovery
}isDiscovering
Gibt an, ob gerade eine Geräteerkennung läuft.
query isDiscovering {
isDiscovering
}mdnsState
Liest den aktuellen mDNS-Erkennungsstatus und ausgewählte Dienst- oder Paketdetails.
query mdnsState {
mdnsState { runtimeId revision running scanning }
}nearbyDevices
Listet aktuell bekannte Geräte in der Nähe für Erkennung oder Kopplung auf.
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}parsePairingQrCode
Dekodiert einen gültigen Kopplungscode in Verbindungsinformationen für ein Gerät in der Nähe.
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}