페어링
기능 지원은 app.capabilities, 인가는 app.access와 호스트 권한으로 확인하세요. 예제는 합성 값을 사용합니다. 호출 전에 경로, ID, 입력, 필터를 바꾸세요.
plainapp://pair?request=<URL-encoded JSON>QR
signature = Base64(Ed25519-Sign(Device A private key, signed))Ed25519-Verify(Device A public key, signed, Base64Decode(signature))JSON 부분을 열어 이 합성 예제의 전체 서명 입력을 확인하세요. 수신자는 서명자의 공개 키로 검증합니다.verificationCode = 73939800digest = SHA256(request.signature encoded as UTF-8)digest (hex) = ff44f60497bc235899f050f272165ec094a2f2c685e776d153a0711424b85dc0number = first 8 digest bytes as an unsigned big-endian integerverificationCode = number mod 100000000, padded to 8 decimal digitsQR: A가 표시하고 B가 스캔합니다. LAN c-id는 발신자를 식별하며 BLE는 자체 전송을 사용합니다. PAIR_CANCEL은 선택 사항입니다.
고정 시각의 합성 스냅샷이며 서명과 requestIds가 일치합니다. 192.0.2.0/24는 문서용으로 예약되어 있습니다. 8443은 기본 HTTPS 포트이며 실제 요청에서는 검색된 포트를 사용하세요. 시간이 제한된 이 요청들을 그대로 재사용할 수 없습니다.
PlainApp Desktop에서 새 기기나 공개 키가 변경된 기기를 관리하려면 먼저 해당 기기를 신뢰할지 명시적으로 확인합니다. 이 단계에는 비교 코드가 없으며, 공개 키가 변경된 경우 경고가 표시됩니다. 비밀번호를 사용하지 않았다면 두 기기에 표시된 코드가 일치하는지 확인한 뒤 관리 대상 기기에서 승인하세요. 비밀번호로 인증했더라도 관리 대상 기기에서 코드 없이 승인을 요청할 수 있습니다.
타입 정의
type Subscription {
peersChanged: Boolean!
pairingRequested: PairingRequestNotice!
pairingCompleted: PairingCompletedNotice!
pairingStarted: PairingProgressNotice!
pairingFailed: PairingProgressNotice!
pairingCanceled: PairingProgressNotice!
}
type Mutation {
cancelPairing(peerId: ID!): Boolean!
deletePeer(peerId: ID!): Boolean!
pairPeer(peerId: ID!, input: PairPeerInput!): Boolean!
respondToPairing(peerId: ID!, accepted: Boolean!): Boolean!
unpairPeer(peerId: ID!): Boolean!
}
type Query {
peerFileUrl(peerId: ID!, fileId: String!): String!
peers: [Peer!]!
}
enum DeviceType {
COMPUTER
PHONE
TABLET
TV
NAS
OTHER
}
scalar Instant
input PairPeerInput {
mode: PairingMode!
password: String
}
type PairingCompletedNotice {
deviceId: ID!
deviceName: String!
ip: String!
port: Int
deviceType: DeviceType
requestId: String
}
enum PairingErrorCode {
TIMEOUT
REJECTED
PASSWORD_REQUIRED
INVALID_PASSWORD
PEER_IDENTITY_CHANGED
TOO_MANY_LOGIN_ATTEMPTS
INTERNAL_ERROR
}
enum PairingMode {
CHAT
MANAGE
}
type PairingProgressNotice {
verificationCode: String
deviceId: ID!
deviceName: String!
error: PairingErrorCode
}
type PairingRequestNotice {
fromIp: String!
fromId: ID!
fromName: String!
deviceType: DeviceType!
verificationCode: String!
identityChanged: Boolean!
}
type Peer {
id: ID!
name: String!
ip: String!
status: PeerStatus!
port: Int
deviceType: DeviceType!
createdAt: Instant!
updatedAt: Instant!
online: Boolean!
managed: Boolean!
key: String!
publicKey: String!
token: String!
}
enum PeerStatus {
PAIRED
UNPAIRED
CHANNEL
}작업
peersChanged
피어 레코드 변경 시 변경 신호를 받습니다.
subscription peersChanged {
peersChanged
}pairingRequested
결정을 기다리는 수신 페어링 요청을 받습니다.
subscription pairingRequested {
pairingRequested { fromIp fromId fromName deviceType verificationCode identityChanged }
}pairingCompleted
기기 페어링 완료 알림을 받습니다.
subscription pairingCompleted {
pairingCompleted { deviceId deviceName ip port deviceType requestId }
}pairingStarted
페어링 시도 시작 알림을 받습니다.
subscription pairingStarted {
pairingStarted { verificationCode deviceId deviceName error }
}pairingFailed
페어링 시도 실패 알림을 받습니다.
subscription pairingFailed {
pairingFailed { verificationCode deviceId deviceName error }
}pairingCanceled
페어링 시도 취소 알림을 받습니다.
subscription pairingCanceled {
pairingCanceled { verificationCode deviceId deviceName error }
}cancelPairing
지정한 기기에서 진행 중인 페어링을 취소합니다.
mutation cancelPairing($peerId: ID!) {
cancelPairing(peerId: $peerId)
}deletePeer
기기와 일대일 채팅 기록을 삭제합니다. 채널이 참조하면 채널용 기기 기록을 유지합니다.
mutation deletePeer($peerId: ID!) {
deletePeer(peerId: $peerId)
}pairPeer
채팅 페어링 또는 관리 로그인을 시작합니다. true는 요청이 접수되었음을 뜻합니다.
mutation pairPeer($peerId: ID!, $input: PairPeerInput!) {
pairPeer(peerId: $peerId, input: $input)
}respondToPairing
기기의 대기 중인 페어링 요청이나 신뢰 확인을 수락하거나 거절합니다.
mutation respondToPairing($peerId: ID!, $accepted: Boolean!) {
respondToPairing(peerId: $peerId, accepted: $accepted)
}unpairPeer
이 기기에서 페어링을 해제하고 관리 권한을 제거하며 채팅 기록은 유지합니다.
mutation unpairPeer($peerId: ID!) {
unpairPeer(peerId: $peerId)
}peerFileUrl
기기의 현재 저장된 주소로 파일 다운로드 URL을 만듭니다.
query peerFileUrl($peerId: ID!, $fileId: String!) {
peerFileUrl(peerId: $peerId, fileId: $fileId)
}peers
페어링됨, 페어링 해제됨, 채널 전용 기록을 포함한 모든 저장된 기기를 나열합니다.
query peers {
peers { id name ip status port deviceType createdAt updatedAt }
}