App

API குறிப்பு

சாதன மற்றும் செயலி தகவலைப் பெறவும், கிளிப்போர்டை அமைக்கவும், செயலியை மீண்டும் தொடங்கவும் மற்றும் சாதன-நிலை அமைப்புகளை நிர்வகிக்கவும். பிடித்த-கோப்புறை மியூடேஷன்கள் Files பிரிவின் கீழ் ஆவணப்படுத்தப்பட்டுள்ளன.

வகை வரையறைகள்

bash

type App {
  usbConnected: Boolean!
  urlToken: String!              # current session token
  httpPort: Int!
  httpsPort: Int!
  appDir: String!
  deviceName: String!
  battery: Int!                  # battery level 0–100
  appVersion: Int!               # versionCode
  osVersion: Int!                # Android SDK level e.g. 35
  channel: String!               # "github" | "google"
  permissions: [String!]!        # granted API permissions
  audios: [PlaylistAudio!]!      # current playlist
  audioMode: MediaPlayMode!      # REPEAT | REPEAT_ONE | SHUFFLE
  audioCurrent: String!          # path of the playing track
  sdcardPath: String!
  usbDiskPaths: [String!]!
  internalStoragePath: String!
  downloadsDir: String!
  developerMode: Boolean!
  favoriteFolders: [FavoriteFolder!]!
}

type FavoriteFolder {
  rootPath: String!
  fullPath: String!
  alias: String              # optional display alias, nullable
}

type TempValue {
  key: String!
  value: String!
}

type DeviceInfo {
  # Hardware + OS info: manufacturer, model, sdkInt, buildChannel, etc.
  # Fields are platform-dependent; see PlainApp source for the full list.
}

type Battery {
  level: Int!                # 0–100
  status: BatteryStatus!     # CHARGING | DISCHARGING | FULL | NOT_CHARGING
  health: BatteryHealth!
  plugged: BatteryPlugged!
  temperature: Int!          # tenths of a degree Celsius
  voltage: Int!              # millivolts
}

enum BatteryStatus   { CHARGING DISCHARGING FULL NOT_CHARGING UNKNOWN }
enum BatteryHealth   { GOOD OVERHEAT DEAD OVER_VOLTAGE UNSPECIFIED_FAILURE UNKNOWN COLD }
enum BatteryPlugged  { AC USB WIRELESS NONE }

செயல்பாடுகள்

query

app

ஒரே query-யில் அனைத்து சாதன மற்றும் செயலி நிலையைப் பெறவும்.

bash

query GetApp {
  app {
    usbConnected urlToken httpPort httpsPort appDir deviceName
    battery appVersion osVersion channel permissions
    audios { title path duration } audioMode audioCurrent
    sdcardPath usbDiskPaths internalStoragePath downloadsDir developerMode
    favoriteFolders { rootPath fullPath alias }
  }
}

query

deviceInfo

வன்பொருள் மற்றும் OS தகவலை (உற்பத்தியாளர், மாடல், SDK நிலை, போன்றவை) பெறவும்.

bash

query GetDeviceInfo {
  deviceInfo { manufacturer model sdkInt buildChannel }
}

query

battery

தற்போதைய பேட்டரி நிலை, சார்ஜிங் நிலை, ஆரோக்கியம் மற்றும் மின்னழுத்தம் பெறவும்.

bash

query GetBattery {
  battery { level status health plugged temperature voltage }
}

mutation

setTempValue

சர்வர் நினைவகத்தில் ஒரு தற்காலிக key/value ஜோடியை அமைக்கவும். HTTP சர்வர் மறுதொடக்கம் ஆகும்போது அழிக்கப்படும்.

bash

mutation SetTempValue($key: String!, $value: String!) {
  setTempValue(key: $key, value: $value) { key value }
}

mutation

relaunchApp

சாதனத்தில் PlainApp செயல்முறையை மறுதொடக்கம் செய்யவும்.

bash

mutation RelaunchApp {
  relaunchApp
}

mutation

openAccessibilitySettings

சாதனத்தில் Android Accessibility அமைப்புகள் திரையைத் திறக்கவும். sendScreenMirrorControl சைகைகளை அனுப்புவதற்கு முன் தேவை.

bash

mutation OpenAccessibilitySettings {
  openAccessibilitySettings
}

mutation

openWebSettings

சாதனத்தில் PlainApp web-UI அமைப்புகள் திரையைத் திறக்கவும் (கடவுச்சொல், 2FA, போன்றவை).

bash

mutation OpenWebSettings {
  openWebSettings
}

mutation

setClip

கொடுக்கப்பட்ட உரைக்கு சாதன கிளிப்போர்டை அமைக்கவும்.

bash

mutation SetClip($text: String!) {
  setClip(text: $text)
}

mutation

updateDeviceName

web UI-இல் காட்டப்படும் சாதன காட்சி பெயரை மாற்றவும் மற்றும் இணைக்கப்பட்ட peers-க்கு ஒளிபரப்பவும்.

bash

mutation UpdateDeviceName($name: String!) {
  updateDeviceName(name: $name)
}