Bildschirm-Spiegelung

API-Referenz

Geräte-Bildschirm in die Web-UI spiegeln und Touch-Gesten zurück an das Gerät senden. Erfordert den PlainApp-Bedienungshilfen-Service für die Steuerungs-Eingabe.

Typdefinitionen

bash

type ScreenMirrorQuality {
  mode: ScreenMirrorMode!       # SMOOTH (720p) | HD (1080p)
  resolution: Int!
}

type ScreenMirrorVideoCodec {
  # Hardware/software video codec name used by the active mirror session.
  # Platform-dependent; see PlainApp source for the full list.
}

enum ScreenMirrorMode {
  SMOOTH
  HD
}

enum ScreenMirrorControlAction {
  CLICK
  LONG_PRESS
  SCROLL
  SWIPE
  TEXT
  BACK
  HOME
  RECENT
  POWER_DIALOG
  VOLUME_UP
  VOLUME_DOWN
  NOTIFICATIONS
  QUICK_SETTINGS
  LOCK_SCREEN
  SCREENSHOT
}

input ScreenMirrorControlInput {
  action: ScreenMirrorControlAction!
  x: Float
  y: Float
  x2: Float
  y2: Float
  text: String
}

Operationen

query

screenMirrorState

Gibt true zurück, wenn eine Bildschirm-Spiegelungs-Session läuft.

bash

query GetScreenMirrorState {
  screenMirrorState
}

query

screenMirrorVideoCodec

Den Video-Codec der aktuellen/letzten Spiegelungs-Session abrufen.

bash

query GetScreenMirrorVideoCodec {
  screenMirrorVideoCodec { name }
}

query

screenMirrorControlEnabled

Gibt true zurück, wenn der PlainApp-Bedienungshilfen-Service aktiviert ist und Gesten auslösen kann.

bash

query GetScreenMirrorControlEnabled {
  screenMirrorControlEnabled
}

query

screenMirrorQuality

Die aktuelle Spiegelungs-Qualitätsvorgabe abrufen.

bash

query GetScreenMirrorQuality {
  screenMirrorQuality { mode resolution }
}

mutation

startScreenMirror

Eine Bildschirm-Spiegelungs-Session starten. audio=true übergeben, um auch Geräte-Audio zu streamen (erfordert RECORD_AUDIO-Berechtigung).

bash

mutation StartScreenMirror($audio: Boolean!) {
  startScreenMirror(audio: $audio)
}

mutation

requestScreenMirrorAudio

Mikrofon-Berechtigung für Bildschirm-Spiegelungs-Audio anfordern. Gibt true zurück, wenn bereits erteilt, andernfalls false (und löst einen Berechtigungsdialog aus).

bash

mutation RequestScreenMirrorAudio {
  requestScreenMirrorAudio
}

mutation

stopScreenMirror

Die aktive Bildschirm-Spiegelungs-Session stoppen.

bash

mutation StopScreenMirror {
  stopScreenMirror
}

mutation

updateScreenMirrorQuality

Die Spiegelungs-Qualitätsvorgabe wechseln. SMOOTH zielt auf 720p, HD auf 1080p.

bash

mutation UpdateScreenMirrorQuality($mode: ScreenMirrorMode!) {
  updateScreenMirrorQuality(mode: $mode)
}

mutation

sendScreenMirrorControl

Eine Touch-Geste oder ein Tasten-Ereignis an das Gerät auslösen. Erfordert, dass der PlainApp-Bedienungshilfen-Service aktiviert ist.

bash

mutation SendScreenMirrorControl($input: ScreenMirrorControlInput!) {
  sendScreenMirrorControl(input: $input)
}