PlainApp
API குறிப்பு

அருகிலுள்ள சாதனக் கண்டறிதல்

அம்ச ஆதரவிற்கு app.capabilities-ஐயும் அனுமதிக்கு app.access மற்றும் host அனுமதிகளையும் சரிபார்க்கவும். எடுத்துக்காட்டுகள் செயற்கை மதிப்புகளைப் பயன்படுத்துகின்றன; அழைப்பதற்கு முன் பாதைகள், ID-கள், உள்ளீடுகள் மற்றும் வடிப்பான்களை மாற்றவும்.

Device A
UDP → 224.0.0.251:5353
Device B

PTR query

UDP · DNS

IPv4 multicast; IP broadcast அல்ல: 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 கண்டறிதல் நிலையையும் தேர்ந்தெடுத்த சேவை அல்லது packet விவரங்களையும் படிக்கவும்.

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