Découverte à proximité
Vérifier app.capabilities pour la prise en charge des fonctionnalités et app.access ainsi que les permissions de l’hôte pour les autorisations. Les exemples utilisent des valeurs synthétiques ; remplacer les chemins, ID, entrées et filtres avant tout appel.
Toutes les 2 secondes, la page lit isDiscovering et nearbyDevices dans une seule requête GraphQL, actualise la liste et appelle startDiscovery uniquement si le scan est arrêté. La fermeture appelle stopDiscovery sans tenir compte des autres pages. Le scan s’arrête cinq minutes après le dernier démarrage. BLE reste indépendant.
UDP → 224.0.0.251:5353PTR query
Multicast IPv4, pas une diffusion IP : 224.0.0.251:5353. A recherche toutes les 5 s ; B s’annonce aussi au démarrage et toutes les 60 s. Les réponses PTR incluent SRV, TXT et A. Les fenêtres contextuelles affichent des enregistrements DNS synthétiques décodés.
Définitions de types
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
}Opérations
acquireMdnsDebugSession
Obtenir une session de débogage mDNS avec un jeton UUID de l’appelant. Nécessite HTTP_SERVER ; libérer la session à la fermeture de la page.
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}releaseMdnsDebugSession
Libérer la session de débogage mDNS avec le jeton correspondant. Nécessite HTTP_SERVER.
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}startDiscovery
Démarrer la découverte d’appareils.
mutation startDiscovery {
startDiscovery
}stopDiscovery
Arrêter la découverte d’appareils.
mutation stopDiscovery {
stopDiscovery
}isDiscovering
Indiquer si une recherche d’appareils est en cours.
query isDiscovering {
isDiscovering
}mdnsState
Lire l’état actuel de découverte mDNS et les détails sélectionnés de services ou de paquets.
query mdnsState {
mdnsState { runtimeId revision running scanning }
}nearbyDevices
Lister les appareils à proximité actuellement connus et disponibles pour la découverte ou l’association.
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}parsePairingQrCode
Décoder un code d’association valide en informations de connexion d’un appareil à proximité.
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}