주변 기기 검색
기능 지원은 app.capabilities, 인가는 app.access와 호스트 권한으로 확인하세요. 예제는 합성 값을 사용합니다. 호출 전에 경로, ID, 입력, 필터를 바꾸세요.
페이지는 2초마다 하나의 GraphQL 쿼리로 isDiscovering과 nearbyDevices를 읽어 목록을 갱신하고, 검색이 중지된 경우에만 startDiscovery를 호출합니다. 닫을 때는 다른 페이지와 관계없이 stopDiscovery를 호출합니다. 검색은 마지막 시작 후 5분 뒤 중지되며 BLE는 별도로 실행됩니다.
UDP → 224.0.0.251:5353PTR query
IP 브로드캐스트가 아닌 IPv4 멀티캐스트 224.0.0.251:5353입니다. A는 5초마다 검색하며 B는 시작 시와 60초마다 알립니다. PTR 응답은 SRV, TXT, A를 포함합니다. 팝업에 디코딩된 합성 DNS 레코드를 표시합니다.
타입 정의
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
}작업
acquireMdnsDebugSession
호출자의 UUID 토큰으로 mDNS 디버그 세션을 확보합니다. HTTP_SERVER 기능이 필요하며 디버그 페이지를 닫을 때 세션을 해제해야 합니다.
mutation acquireMdnsDebugSession($token: String!) {
acquireMdnsDebugSession(token: $token)
}releaseMdnsDebugSession
일치하는 토큰으로 mDNS 디버그 세션을 해제합니다. HTTP_SERVER 기능이 필요합니다.
mutation releaseMdnsDebugSession($token: String!) {
releaseMdnsDebugSession(token: $token)
}startDiscovery
기기 검색을 시작합니다.
mutation startDiscovery {
startDiscovery
}stopDiscovery
기기 검색을 중지합니다.
mutation stopDiscovery {
stopDiscovery
}isDiscovering
현재 검색 스캔 실행 여부입니다.
query isDiscovering {
isDiscovering
}mdnsState
현재 mDNS 검색 상태와 선택된 서비스 또는 패킷 상세 정보를 읽습니다.
query mdnsState {
mdnsState { runtimeId revision running scanning }
}nearbyDevices
검색 또는 페어링할 수 있는 현재 알려진 주변 기기를 나열합니다.
query nearbyDevices {
nearbyDevices { id name ips port remoteAccess signaturePublicKey deviceType version }
}parsePairingQrCode
페어링 코드가 유효하면 주변 기기 연결 정보로 디코딩합니다.
query parsePairingQrCode($code: String!) {
parsePairingQrCode(code: $code) { id name ips port remoteAccess signaturePublicKey deviceType version }
}