PlainApp
API 참조

주변 기기 검색

기능 지원은 app.capabilities, 인가는 app.access와 호스트 권한으로 확인하세요. 예제는 합성 값을 사용합니다. 호출 전에 경로, ID, 입력, 필터를 바꾸세요.

Device A
UDP → 224.0.0.251:5353
Device B

PTR query

UDP · DNS

IP 브로드캐스트가 아닌 IPv4 멀티캐스트 224.0.0.251:5353입니다. A는 5초마다 검색하며 B는 시작 시와 60초마다 알립니다. PTR 응답은 SRV, TXT, A를 포함합니다. 팝업에 디코딩된 합성 DNS 레코드를 표시합니다.

필드에 마우스를 올리거나 탭하세요
1 / 3

타입 정의

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 }
}