JavaScript-Schnittstelle (PLUS)
Die JavaScript-Schnittstelle ermöglicht die Integration von Websites in das Gerät und die Funktionen vFully Kiosk. Zur Nutzung dieser API benötigen Sie einen Webentwickler oder Kenntnisse in JavaScript und HTML. Wenn Sie Node.js/React verwenden, können diese Bibliothek oder diese Bibliothek hilfreich sein.
Vergessen Sie nicht, bei Verwendung der JavaScript-Schnittstelle die Option Erweiterte Webeinstellungen >> JavaScript-Schnittstelle aktivieren zu aktivieren. Aktivieren Sie diese Option nur, wenn Sie allen geladenen Websites vertrauen (verwenden Sie eine URL-Whitelist!). Diese Option ist potenziell unsicher, da jede Website ALLE Ihre lokalen Dateien lesen, die Geräteeinstellungen ändern usw. kann.
Die folgenden JavaScript-Funktionen sind im Fully Kiosk Browser (einschließlich Beta-Versionen) implementiert.
Geräteinformationen abrufen
String fully.getCurrentLocale()
String fully.getIp4Address()
String fully.getIp4Addresses()
String fully.getIp6Address()
String fully.getIp6Addresses()
String fully.getHostname()
String fully.getHostname6()
String fully.getMacAddress()
String fully.getMacAddressForInterface(String interface)
String fully.getWifiSsid()
String fully.getWifiBssid()
String fully.getWifiSignalLevel()
String fully.getSerialNumber()
String fully.getSerialNumberDeviceOwner()
String fully.getAndroidId()
String fully.getDeviceId()
String fully.getDeviceName()
String fully.getImei()
String fully.getSimSerialNumber()
float fully.getBatteryLevel()
float fully.getScreenBrightness()
int fully.getScreenOrientation()
int fully.getDisplayWidth()
int fully.getDisplayHeight()
long fully.getIdleTime()
long fully.getLastUserInteractionTime()
boolean fully.getScreenOn()
boolean fully.isPlugged()
boolean fully.isKeyboardVisible()
boolean fully.isWifiEnabled()
boolean fully.isWifiConnected()
boolean fully.isNetworkConnected()
boolean fully.isBluetoothEnabled()
boolean fully.isScreenRotationLocked()
String fully.getFullyVersion()
int fully.getFullyVersionCode()
String fully.getWebviewVersion()
String fully.getAndroidVersion()
int fully.getAndroidSdk()
String fully.getDeviceModel()
String fully.getLocation() // Returns a JSON String
// Get storage info
long fully.getInternalStorageTotalSpace()
long fully.getInternalStorageFreeSpace()
long fully.getExternalStorageTotalSpace()
long fully.getExternalStorageFreeSpace()
// Get environment sensor info
String fully.getSensorInfo()
float fully.getSensorValue(int type)
String fully.getSensorValues(int type)
// Get data usage (Android 6+)
long fully.getAllRxBytesMobile()
long fully.getAllTxBytesMobile()
long fully.getAllRxBytesWifi()
long fully.getAllTxBytesWifi()Gerät steuern, Benachrichtigung anzeigen, Netzwerkdaten senden usw.
void fully.turnScreenOn()
void fully.turnScreenOff()
void fully.turnScreenOff(boolean keepAlive)
void fully.forceSleep()
void fully.showToast(String text)
void fully.setScreenBrightness(int level) // Use -1 for default
void fully.enableWifi() // In Android 10+ only with provisioned devices
void fully.disableWifi() // In Android 10+ only with provisioned devices
void fully.enableBluetooth()
void fully.disableBluetooth()
void fully.showKeyboard()
void fully.hideKeyboard()
void fully.openWifiSettings()
void fully.openBluetoothSettings()
void fully.vibrate(int millis)
void fully.sendHexDataToTcpPort(String hexData, String host, int port)
void fully.showNotification(String title, String text, String url, boolean highPriority)
void fully.log(int type, String tag, String message)
// Access clipboard
// No access with Android 10+ if Fully is in background
void fully.copyTextToClipboard(String text)
String fully.getClipboardText()
String fully.getClipboardHtmlText()
// Run root command (rooted devices only)
void fully.runCommand(String command)
void fully.runSuCommand(String command)
void fully.reboot() // Provisioned and rooted devices only
void fully.shutdown() // Rooted devices onlyDateien herunterladen und verwalten
// Note that write access to external SD card is not supported by many devices
void fully.deleteFile(String path)
void fully.deleteFolder(String path) // recursive!
void fully.emptyFolder(String path) // recursive!
void fully.createFolder(String path)
String fully.getFileList(String folder) // get JSON array
boolean fully.writeFile(String path, String content)
boolean fully.writeFileBase64(String path, String base64encodedContent)
boolean fully.appendFile(String path, String content) // 1.61.4+
boolean fully.appendFileBase64(String path, String base64encodedContent)
String fully.readFile(String path) // ver. 1.55+
void fully.downloadFile(String url, String dirName)
void fully.downloadFile(String url, String dirName, boolean showToastMessages)
void fully.unzipFile(String fileName)
void fully.downloadAndUnzipFile(String url, String dirName)
// Get storage paths (ver. 1.59+)
String fully.getInternalSharedStoragePath()
String fully.getInternalAppSpecificStoragePath()
String fully.getInternalAppPrivateStoragePath()
String fully.getExternalSharedStoragePath()
String fully.getExternalAppSpecificStoragePath()
// Respond to download/unzip events
void fully.bind('onDownloadSuccess','todo("$url","$dir","$code","$fileLength","$lastModified","$mimetype");')
void fully.bind('onDownloadFailure','todo("$url","$dir","$code");')
void fully.bind('onUnzipSuccess','todo("$url","$dir");')
void fully.bind('onUnzipFailure','todo("$url","$dir","$message");')Nutzung von TTS, Multimedia und PDF
void fully.textToSpeech(String text)
void fully.textToSpeech(String text, String localeOrVoice)
void fully.textToSpeech(String text, String localeOrVoice, String engine)
void fully.textToSpeech(String text, String localeOrVoice, String engine, boolean queue) // ver. 1.38+
void fully.stopTextToSpeech()
void fully.initTts() // ver. 1.55, listen for ttsInitSuccess event for $info, containing available engines, voices and locales
void fully.shutdownTts() // ver. 1.60+
void fully.playVideo(String url, boolean loop, boolean showControls, boolean exitOnTouch, boolean exitOnCompletion)
void fully.stopVideo()
// Audio Streams: 0 – Voice Call, 1 – System, 2 – Ring, 3 – Music, 4 – Alarm, 5 – Notification, 6 – Bluetooth, 8 – DTMF, 9 – TTS, 10 – Accessibility
void fully.setAudioVolume(int level, int stream) // level: 0..100
void fully.playSound(String url, boolean loop)
void fully.playSound(String url, boolean loop, int stream)
void fully.stopSound()
void fully.showPdf(String url)
int fully.getAudioVolume(int stream)
boolean fully.isWiredHeadsetOn()
boolean fully.isMusicActive()Surfen im Internet kontrollieren
// Manage web browsing
String fully.getStartUrl()
void fully.setStartUrl(String url)
void fully.loadStartUrl()
void fully.addToHomeScreen()
void fully.shareUrl()
void fully.print() // window.print() doesn't work
void fully.print2Pdf(String filename) // Print A4 paper w/o prompt
String fully.getScreenshotPngBase64()
String fully.loadStatsCSV()
void fully.requestWebAutomation(int index) // Ver. 1.60+
// Purge web items
void fully.clearCache()
void fully.clearFormData()
void fully.clearHistory()
void fully.clearCookies()
void fully.clearCookiesForUrl(String url)
void fully.clearWebstorage()
void fully.resetWebview // ver. 1.55.3+
// Manage web tabs
void fully.focusThisTab()
void fully.focusNextTab()
void fully.focusPrevTab()
void fully.focusTabByIndex(int index)
int fully.getCurrentTabIndex()
int fully.getThisTabIndex()
void fully.closeTabByIndex(int index)
void fully.closeThisTab()
String fully.getTabList() // returns a JSON array
void fully.loadUrlInTabByIndex(int index, String url)
void fully.loadUrlInNewTab(String url, boolean focus)Barcode-Scanner
// Use $code placeholder in the resultUrl, see example below
void fully.scanQrCode(String prompt, String resultUrl)
// Enhanced interface
// Use -1 for cameraId and timeout (in seconds) for defaults
void fully.scanQrCode(String prompt, String resultUrl, int cameraId, int timeout, boolean beepEnabled, boolean showCancelButton)
// Activate flashlight if needed
void fully.scanQrCode(String prompt, String resultUrl, int cameraId, int timeout, boolean beepEnabled, boolean showCancelButton, boolean useFlashlight)
// Respond to QR events
void fully.bind('onQrScanSuccess','todo(\'$code\');')
void fully.bind('onQrScanCancelled','todo();')Bluetooth-Schnittstelle
// Get a list of known devices incl. connection state and battery level
String fully.btGetDeviceListJson()
// Open a serial (SPP) bluetooth connection (GATT is not supported!)
// These functions are async, listen to events below to get results
void fully.btOpenByMac(String mac)
void fully.btOpenByUuid(String uuid)
void fully.btOpenByName(String name)
// Get info about connected device and close connection
boolean fully.btIsConnected()
String fully.btGetDeviceInfoJson()
void fully.btClose()
// Send data
boolean fully.btSendStringData(String stringData)
boolean fully.btSendHexData(String hexData)
boolean fully.btSendByteData(byte[] data)
// Respond to events
void fully.bind('onBtConnectSuccess','todo("$device");');
void fully.bind('onBtConnectFailure','todo();');
void fully.bind('onBtDataRead','todo("$data");'); // Data is buffered until LF symbol foundNFC-Tags lesen
// Note that NFC scan usually doesn't work if the screen is locked or the camera is in use
bool fully.nfcScanStart();
bool fully.nfcScanStart(int flags, int debounceMs);
bool fully.nfcScanStop();
void fully.bind('onNdefDiscovered','todo("$serial", "$message", "$data");');
void fully.bind('onNfcTagDiscovered','todo("$serial", "$type", "$message", "$data");');
void fully.bind('onNfcTagRemoved','todo("$serial");'); // Android 7+Auf Ereignisse reagieren
// The second parameter is a String containing JavaScript code to perform
void fully.bind('screenOn','todo();')
void fully.bind('screenOff','todo();')
void fully.bind('showKeyboard','todo();')
void fully.bind('hideKeyboard','todo();')
void fully.bind('networkDisconnect','todo();')
void fully.bind('networkReconnect','todo();')
void fully.bind('internetDisconnect','todo();')
void fully.bind('internetReconnect','todo();')
void fully.bind('unplugged','todo();')
void fully.bind('pluggedAC','todo();')
void fully.bind('pluggedUSB','todo();')
void fully.bind('pluggedWireless','todo();')
void fully.bind('onScreensaverStart','todo();')
void fully.bind('onScreensaverStop','todo();')
void fully.bind('onDaydreamStart','todo();')
void fully.bind('onDaydreamStop','todo();')
void fully.bind('onBatteryLevelChanged','todo("$level");')
void fully.bind('volumeUp','todo();')
void fully.bind('volumeDown','todo();')
void fully.bind('headphonesPlugged','todo();')
void fully.bind('headphonesUnplugged','todo();')
void fully.bind('onMotion','todo();') // Max. one per second
void fully.bind('facesDetected','todo($number);') // 1.48+
void fully.bind('onDarkness','todo();') // Requires screen off on darkness
void fully.bind('onMovement','todo();')
void fully.bind('onIBeacon','todo("$id1","$id2","$id3",$distance);')
void fully.bind('broadcastReceived','todo("$action","$extras");');
void fully.bind('onQrScanSuccess','todo("$code","$extras");');
void fully.bind('ttsInitSuccess','todo("$info");'); // ver. 1.55+
void fully.bind('ttsTextQueued','todo("Text Queued: $id for $text with status $status");');
void fully.bind('ttsSilenceQueued','todo("Silence Queued: $id for $millis ms with status $status");');
void fully.bind('ttsUtteranceStart','todo("Utterance Start: $id");');
void fully.bind('ttsUtteranceError','todo("Utterance Error: $id");');
void fully.bind('ttsUtteranceDone','todo("Utterance Done: $id");');Bildschirmschoner, andere Apps, Intents, Kiosk-Modus usw. verwalten
// Manage fully kiosk screensaver
void fully.startScreensaver()
void fully.stopScreensaver()
void fully.startDaydream()
void fully.stopDaydream()
// Manage fully kiosk app
boolean fully.isInForeground()
void fully.bringToForeground()
void fully.bringToForeground(long millis) // Delay in ms
void fully.bringToBackground()
void fully.restartApp()
void fully.exit()
// Manage kiosk mode and maintenance mode
void fully.enableMaintenanceMode()
void fully.disableMaintenanceMode()
void fully.setMessageOverlay(String text)
void fully.lockKiosk()
void fully.unlockKiosk()
void fully.checkKioskPin()
boolean fully.isKioskLocked()
// Manage other apps and broadcasts
void fully.startApplication(String packageName)
void fully.startApplication(String packageName, String action, String url) // Can put null to omit the parameter
void fully.startIntent(String url)
void fully.broadcastIntent(String url)
void fully.registerBroadcastReceiver(String action)
void fully.unregisterBroadcastReceiver(String action)
void fully.killBackgroundProcesses(String package) // Android 13 and older
void fully.installApkFile(String url) // Not in Google Play EditionBewegungserkennung
void fully.startMotionDetection()
void fully.stopMotionDetection()
boolean fully.isMotionDetectionRunning()
String fully.getCamshotJpgBase64()
int fully.getFaceNumber()
int fully.getAverageLuma() // Ver. 1.60+
void fully.triggerMotion()
void fully.bind('onMotion','todo();') // Triggered max. once per secondAlle Fully-Einstellungen verwalten
// Look in Remote Admin settings for the settings keys
// Or export a JSON settings file and look there
String fully.getBooleanSetting(String key)
String fully.getStringSetting(String key)
// Changes apply immediately
void fully.setBooleanSetting(String key, boolean value)
void fully.setStringSetting(String key, String value)
void fully.importSettingsFile(String url)Systemeinstellungen verwalten
// Look here for keys and restrictions
// Changing system settings usually requires provisioning or special permissions
// https://developer.android.com/reference/android/provider/Settings
int fully.getSettingsGlobalInt(String name, int default)
long fully.getSettingsGlobalLong(String name, long default)
String fully.getSettingsGlobalString(String name)
void fully.putSettingsGlobalInt(String name, int value)
void fully.putSettingsGlobalLong(String name, long value)
void fully.putSettingsGlobalString(String name, String value)
int fully.getSettingsSystemInt(String name, int def)
long fully.getSettingsSystemLong(String name, long def)
String fully.getSettingsSystemString(String name)
void fully.putSettingsSystemInt(String name, int value)
void fully.putSettingsSystemLong(String name, long value)
void fully.putSettingsSystemString(String name, String value)
int fully.getSettingsSecureInt(String name, int def)
long fully.getSettingsSecureLong(String name, long def)
String fully.getSettingsSecureString(String name)
void fully.putSettingsSecureInt(String name, int value)
void fully.putSettingsSecureLong(String name, long value)
void fully.putSettingsSecureString(String name, String value)Beispiele zur Verwendung der JavaScript-Schnittstelle:
Wie nutzt man die JavaScript-Schnittstelle?
<!-- Make actions -->
<button type="button" onclick="fully.openWifiSettings();">Wifi</button>
<!-- Show device info -->
<button type="button" onclick="alert(fully.getMacAddress());">Mac address</button>
<!-- Play Text to Speech -->
<script>
fully.bind('ttsTextQueued','showResult("Text Queued: $id for $text with status $status");');
fully.bind('ttsSilenceQueued','showResult("Silence Queued: $id for $millis ms with status $status");');
fully.bind('ttsUtteranceStart','showResult("Utterance Start: $id");');
fully.bind('ttsUtteranceError','showResult("Utterance Error: $id");');
fully.bind('ttsUtteranceDone','showResult("Utterance Done: $id");');
</script>
<button type="button" onclick="fully.textToSpeech('How do you do?','en_GB');">Say hello</button>
<!-- Change Fully Kiosk settings -->
<button type="button" onclick="fully.setStringSetting('screenBrightness','255');">Full brightness</button>
<button type="button" onclick="fully.setBooleanSetting('motionDetection',true);">Enable MD</button>
<!-- Listen for events -->
<script>
function myMotion() { alert("Motion"); }
fully.bind('onMotion','myMotion();');
</script>
<!-- Listen for iBeacon -->
<script>
function onBeacon (id1,id2,id3,distance) {
alert("iBeacon found: "+id1+"/"+id2+"/"+id3+" in "+distance+" meter");
}
fully.bind('onIBeacon','onBeacon("$id1","$id2","$id3",$distance);');
// You can also use $mac, $name, $type, $manufactorer as placeholders
</script>
<!-- Scan QR Code -->
<button type="button" onclick="fully.scanQrCode('Prompt text','javascript:alert(\'$code\');');">Scan QR Code</button>
<!-- Identify Fully Kiosk Browser -->
<script>
if (typeof FullyKiosk !== "undefined")
document.writeln("<h1>Fully Kiosk working</h1>");
</script>
<!-- Print on Bluetooth Printer -->
<script>
fully.bind('onBtConnectSuccess','alert(\'BT connected: $device\');
fully.bind('onBtConnectFailure','alert(\'BT failed\');');
fully.btOpenByUuid('0000110a-0000-1000-8000-00805f9b34fb');
</script>
<button type="button" onclick="alert(fully.btSendHexData('68656c6c6f0a'));">btSendHexData()</button>
<button type="button" onclick="alert(fully.btSendStringData('Hello\n'));">btSendStringData()</button>
<button type="button" onclick="alert(fully.btSendByteData(new Uint8Array([104, 101, 108, 108, 111, 10])));">btSendByteData()</button>Sollten Sie die Website nicht ändern können, können Sie die Funktion JavaScript einfügen nutzen, um Ihre Skripte in andere Websites einzubinden.