Rilevamento nelle vicinanze
Verificare app.capabilities per il supporto delle funzionalità e app.access insieme alle autorizzazioni host per l’autorizzazione. Gli esempi usano valori sintetici; sostituire percorsi, ID, input e filtri prima della chiamata.
Ogni 2 secondi la pagina legge isDiscovering e nearbyDevices con una sola query GraphQL, aggiorna l’elenco e chiama startDiscovery solo se la scansione è ferma. Alla chiusura chiama stopDiscovery indipendentemente dalle altre pagine. La scansione termina cinque minuti dopo l’ultimo avvio. BLE funziona separatamente.
UDP → 224.0.0.251:5353PTR query
Multicast IPv4, non broadcast IP: 224.0.0.251:5353. A cerca ogni 5 s; B si annuncia anche all’avvio e ogni 60 s. Le risposte PTR includono SRV, TXT e A. I popup mostrano record DNS sintetici decodificati.
Definizioni di tipo
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
}Operazioni
acquireMdnsDebugSession
Acquisire una sessione di debug mDNS con un token UUID del chiamante. Richiede HTTP_SERVER; rilasciarla alla chiusura della pagina.
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}releaseMdnsDebugSession
Rilasciare la sessione di debug mDNS con il token corrispondente. Richiede HTTP_SERVER.
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}startDiscovery
Avviare il rilevamento dei dispositivi.
mutation startDiscovery {
startDiscovery
}stopDiscovery
Interrompere il rilevamento dei dispositivi.
mutation stopDiscovery {
stopDiscovery
}isDiscovering
Indicare se è in corso una scansione di rilevamento.
query isDiscovering {
isDiscovering
}mdnsState
Leggere lo stato corrente del rilevamento mDNS e i dettagli selezionati di servizi o pacchetti.
query mdnsState {
mdnsState { runtimeId revision running scanning }
}nearbyDevices
Elencare i dispositivi vicini attualmente noti disponibili per il rilevamento o l’associazione.
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}parsePairingQrCode
Decodificare un codice di associazione valido nelle informazioni di connessione di un dispositivo vicino.
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}