KIOT Cordova Plugin Home Console

This plugin allows your Android app to download and install compressed updates without the Google Play Store.

Features

• ApkUpdater: Download and install APK updates
• KioskPlugin: Kiosk mode functionality
• RockChipInterface: RockChip specific interface
• Haptic: Haptic feedback control
• RelayControl: Relay control functionality
• Insomnia: Keep device awake
• SystemControls: Battery status monitoring and brightness control
• EdgeToEdge: Edge-to-edge display detection and view adjustment for Android

Installation

cordova plugin add kiot-cordova-plugin-home-console

SystemControls Plugin

The SystemControls plugin provides battery status monitoring and brightness control functionality.

Battery Status

Get current battery status:

// Get current battery status
SystemControls.getBatteryStatus().then(function(status) {
    console.log('Battery level: ' + status.level + '%');
    console.log('Is plugged: ' + status.isPlugged);
}).catch(function(error) {
    console.error('Error getting battery status:', error);
});

Monitor battery status changes:

// Start monitoring battery status
SystemControls.startBatteryMonitoring().then(function(status) {
    console.log('Initial battery status:', status);
}).catch(function(error) {
    console.error('Error starting battery monitoring:', error);
});

// Listen for battery status changes
SystemControls.addEventListener('batterystatus', function(status) {
    console.log('Battery status changed:', status);
});

// Listen for power connection events
SystemControls.addEventListener('powerconnected', function(status) {
    console.log('Device plugged in');
});

SystemControls.addEventListener('powerdisconnected', function(status) {
    console.log('Device unplugged');
});

// Stop monitoring when done
SystemControls.stopBatteryMonitoring().then(function() {
    console.log('Battery monitoring stopped');
}).catch(function(error) {
    console.error('Error stopping battery monitoring:', error);
});

Brightness Control

Control screen brightness:

// Get current brightness (0.0 to 1.0)
SystemControls.getBrightness().then(function(brightness) {
    console.log('Current brightness: ' + brightness);
}).catch(function(error) {
    console.error('Error getting brightness:', error);
});

// Set brightness (0.0 to 1.0)
SystemControls.setBrightness(0.5).then(function() {
    console.log('Brightness set to 50%');
}).catch(function(error) {
    console.error('Error setting brightness:', error);
});

// Get system brightness (0 to 255)
SystemControls.getSystemBrightness().then(function(brightness) {
    console.log('System brightness: ' + brightness);
}).catch(function(error) {
    console.error('Error getting system brightness:', error);
});

// Set system brightness (0 to 255)
SystemControls.setSystemBrightness(128).then(function() {
    console.log('System brightness set to 128');
}).catch(function(error) {
    console.error('Error setting system brightness:', error);
});

Ionic/Angular Usage

import { SystemControls } from 'kiot-cordova-plugin-home-console';

// Battery status
const status = await SystemControls.getBatteryStatus();
console.log(`Battery: ${status.level}%, Plugged: ${status.isPlugged}`);

// Brightness control
await SystemControls.setBrightness(0.7); // 70% brightness
const brightness = await SystemControls.getBrightness();
console.log(`Current brightness: ${brightness}`);

API Reference

SystemControls

Battery Methods

• getBatteryStatus(): Returns current battery status
• startBatteryMonitoring(): Start monitoring battery changes
• stopBatteryMonitoring(): Stop monitoring battery changes
• addEventListener(event, callback): Listen for battery events
• removeEventListener(event, callback): Remove battery event listener

Brightness Methods

• getBrightness(): Get current app brightness (0.0-1.0)
• setBrightness(brightness): Set app brightness (0.0-1.0)
• getSystemBrightness(): Get system brightness (0-255)
• setSystemBrightness(brightness): Set system brightness (0-255)

Events

• batterystatus: Fired when battery level or charging status changes
• powerconnected: Fired when device is plugged in
• powerdisconnected: Fired when device is unplugged

Permissions

The SystemControls plugin requires the following permissions:

• android.permission.WRITE_SETTINGS (for system brightness control)

Supported Platforms

• Android
• iOS

License

MIT