API 參考
探索附近裝置
透過 app.capabilities 判斷功能支援,透過 app.access 和主機權限判斷存取授權。範例使用合成值;呼叫前請替換路徑、ID、輸入和篩選條件。
附近裝置頁面每 2 秒以一次 GraphQL 查詢同時讀取 isDiscovering 和 nearbyDevices,更新清單,並僅在未掃描時呼叫 startDiscovery。關閉頁面就呼叫 stopDiscovery,不考慮其他頁面。掃描在最後一次啟動的 5 分鐘後自動停止,BLE 掃描獨立執行。
Device A
UDP → 224.0.0.251:5353Device B
PTR query
UDP · DNS
IPv4 多點傳送,不是 IP 廣播:224.0.0.251:5353。A 每 5 秒查詢;B 也會在啟動時及每 60 秒公告。PTR 回應包含 SRV、TXT 與 A。彈出視窗顯示解碼後的合成 DNS 記錄。
將游標移至欄位或點按
型別定義
graphql
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
}操作
mutation
acquireMdnsDebugSession
使用呼叫端持有的 UUID 權杖取得 mDNS 偵錯工作階段。需要 HTTP_SERVER 能力;關閉偵錯頁面時應釋放工作階段。
graphql
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}mutation
releaseMdnsDebugSession
使用相符權杖釋放 mDNS 偵錯工作階段。需要 HTTP_SERVER 能力。
graphql
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}mutation
startDiscovery
開始發現裝置。
graphql
mutation startDiscovery {
startDiscovery
}mutation
stopDiscovery
停止發現裝置。
graphql
mutation stopDiscovery {
stopDiscovery
}query
isDiscovering
回傳目前是否正在掃描發現裝置。
graphql
query isDiscovering {
isDiscovering
}query
mdnsState
讀取目前 mDNS 探索狀態及所選服務或封包的詳細資訊。
graphql
query mdnsState {
mdnsState { runtimeId revision running scanning }
}query
nearbyDevices
列出目前已知、可用於發現或配對的附近裝置。
graphql
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}query
parsePairingQrCode
將有效配對碼解碼為附近裝置的連線資訊。
graphql
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}