@urovotest/urovosdk-docs-mcp 1.0.1

package/docs/02-reference/general/devicemanager.md

@@ -0,0 +1,460 @@
+---
+title: DeviceManager API
+module: DeviceManager
+domain: general
+tags: ["general", "devicemanager", "devicemanager"]
+---
+# DeviceManager
+
+共 **21** 个 API/条目，来源 `general_sdk.md`。
+
+## API 索引
+
+| 方法 | 类路径 | Demo Activity |
+|------|--------|---------------|
+| [NTP Setting](#ntp-setting) | `-` | - |
+| [Time Zone Setting1](#time-zone-setting1) | `-` | - |
+| [System Time Setting](#system-time-setting) | `-` | - |
+| [Set APN](#set-apn) | `-` | - |
+| [Query APN Setting](#query-apn-setting) | `-` | - |
+| [Device Shutdown/Reboot](#device-shutdown-reboot) | `-` | - |
+| [Device Battery Info](#device-battery-info) | `-` | - |
+| [Launcher Setting](#launcher-setting) | `-` | - |
+| [Auto Running APP Setting](#auto-running-app-setting) | `-` | - |
+| [Double Click To Wake Up Screen](#double-click-to-wake-up-screen) | `-` | - |
+| [Get Keyboard State](#get-keyboard-state) | `-` | - |
+| [Disable Keyboard Switching](#disable-keyboard-switching) | `-` | - |
+| [Switch Keyboard State](#switch-keyboard-state) | `-` | - |
+| [Update the Keyboard State in Status bar](#update-the-keyboard-state-in-status-bar) | `-` | - |
+| [Switch Wi-Fi](#switch-wi-fi) | `-` | - |
+| [Switch Bluetooth](#switch-bluetooth) | `-` | - |
+| [Switch Airplane mode](#switch-airplane-mode) | `-` | - |
+| [Forget All Wi-Fi](#forget-all-wi-fi) | `-` | - |
+| [Check Network Status](#check-network-status) | `-` | - |
+| [Set/Get GPS Accuracy](#set-get-gps-accuracy) | `-` | - |
+| [Set physical button volume](#set-physical-button-volume) | `-` | - |
+
+## NTP Setting
+
+- **源文档章节：** 13.1
+
+- Source section: `13.1`
+
+
+
+Purpose:
+new DeviceManager().setSettingProperty("Global-ntp_server", "time.android.com");
+
+
+Source details:
+```text
+new DeviceManager().setSettingProperty("Global-ntp_server", "time.android.com");
+new DeviceManager().getSettingProperty("Global-ntp_server");
+```
+
+## Time Zone Setting1
+
+- **源文档章节：** 13.2
+
+- Source section: `13.2`
+
+
+
+Purpose:
+1. new DeviceManager().setSettingProperty("persist-persist.sys.timezone","GMT+02:00");
+
+
+Source details:
+```text
+1. new DeviceManager().setSettingProperty("persist-persist.sys.timezone","GMT+02:00");
+2. new DeviceManager().setSettingProperty("persist-persist.sys.settimezone","America/Los_Angeles");
+```
+
+## System Time Setting
+
+- **源文档章节：** 13.3
+
+- Source section: `13.3`
+
+
+
+Purpose:
+long time =
+
+
+Source details:
+```text
+long time =
+new SimpleDateFormat("yyyyMMddHHmmss").parse("20220101000000").getTime();
+new DeviceManager().setCurrentTime(time);
+```
+
+## Set APN
+
+- **源文档章节：** 13.4
+
+- Source section: `13.4`
+
+
+
+Purpose:
+boolean ret = new DeviceManager().setAPN(name, APN, "", 0, "", "", "", "", mcc, mnc, "", 0, 0, "", "", 0, "", true);
+
+
+Source details:
+```text
+boolean ret = new DeviceManager().setAPN(name, APN, "", 0, "", "", "", "", mcc, mnc, "", 0, 0, "", "", 0, "", true);
+```
+
+## Query APN Setting
+
+- **源文档章节：** 13.5
+
+- Source section: `13.5`
+
+
+
+Purpose:
+new DeviceManager().queryAPN(String selection, String[] selectionArgs).
+
+
+Source details:
+```text
+new DeviceManager().queryAPN(String selection, String[] selectionArgs).
+selection: this parameter is a key that you want to query,
+the format seems like a sql command. eg:Telephony.Carriers.APN+" = ?".
+Refer to the keys below:
+Telephony.Carriers._ID,
+Telephony.Carriers.NAME,
+Telephony.Carriers.APN,
+Telephony.Carriers.MCC,
+Telephony.Carriers.MNC,
+Telephony.Carriers.NUMERIC,
+Telephony.Carriers.PROXY,
+Telephony.Carriers.PORT,
+Telephony.Carriers.MMSPROXY,
+Telephony.Carriers.MMSPORT,
+Telephony.Carriers.MMSC,
+Telephony.Carriers.SERVER,
+Telephony.Carriers.PASSWORD,
+Telephony.Carriers.AUTH_TYPE,
+Telephony.Carriers.TYPE,
+Telephony.Carriers.USER,
+Telephony.Carriers.CURRENT.
+selectionArgs: this parameter is the value of the key what you want to query. eg:new String[]{"APN Test"}.
+For example:queryAPN(Telephony.Carriers.NAME+" = ?", new String[]{"APN Test"});
+```
+
+## Device Shutdown/Reboot
+
+- **源文档章节：** 13.4
+
+- Source section: `13.4`
+
+
+
+Purpose:
+new DeviceManager().shutdown(boolean reboot); //true: reboot, false:shutdown.
+
+
+Source details:
+```text
+new DeviceManager().shutdown(boolean reboot); //true: reboot, false:shutdown.
+```
+
+## Device Battery Info
+
+- **源文档章节：** 13.5
+
+- Source section: `13.5`
+
+
+
+Purpose:
+Bundle bundle = new DeviceManager().getBatteryInfo();
+
+
+Source details:
+```text
+Bundle bundle = new DeviceManager().getBatteryInfo();
+int level = bundle.getInt("level"); //battery percentage
+int plugged = bundle.getInt("plugged"); //Is it charging, 0:no, 1:yes.
+```
+
+## Launcher Setting
+
+- **源文档章节：** 13.6
+
+- Source section: `13.6`
+
+
+
+Purpose:
+new DeviceManager().setDefaultLauncher(ComponentName.unflattenFromString(componetStr);
+
+
+Source details:
+```text
+new DeviceManager().setDefaultLauncher(ComponentName.unflattenFromString(componetStr);
+//componentStr = "packageName/ActivityPath".
+// eg: "com.urovo.demo/com.urovo.demo.MainActivity".
+//<intent-filter>
+<action android:name="android.intent.action.MAIN" />
+
+<category android:name="android.intent.category.LAUNCHER" />
+
+<category android:name="android.intent.category.HOME" />
+
+<category android:name="android.intent.category.DEFAULT" />
+</intent-filter>
+```
+
+## Auto Running APP Setting
+
+- **源文档章节：** 13.7
+
+- Source section: `13.7`
+
+
+
+Purpose:
+new DeviceManager().setAutoRunningApp(ComponentName.unflattenFromString(componetStr, action); //action:0:disable, 1:enable
+
+
+Source details:
+```text
+new DeviceManager().setAutoRunningApp(ComponentName.unflattenFromString(componetStr, action); //action:0:disable, 1:enable
+//componentStr = "packageName/ActivityPath".
+// eg: "com.urovo.demo/com.urovo.demo.MainActivity".
+```
+
+## Double Click To Wake Up Screen
+
+- **源文档章节：** 13.8
+
+- Source section: `13.8`
+
+
+
+Purpose:
+DeviceManager deviceManager = new DeviceManager();
+
+
+Source details:
+```text
+DeviceManager deviceManager = new DeviceManager();
+enable:
+deviceManager.setSettingProperty("persist-persist.sys.urv.tp.wakeup.gesture", "doubleclick");
+disable:
+deviceManager.setSettingProperty("persist-persist.sys.urv.tp.wakeup.gesture", "");
+```
+
+## Get Keyboard State
+
+- **源文档章节：** 13.9
+
+- Source section: `13.9`
+
+
+
+Purpose:
+//keyboard state: 0-NUM, 1-LOWER, 2-UPPER.
+
+
+Source details:
+```text
+//keyboard state: 0-NUM, 1-LOWER, 2-UPPER.
+String state = new DeviceManager().getSettingProperty("Global-ufans.keyboard.state");
+```
+
+## Disable Keyboard Switching
+
+- **源文档章节：** 13.10
+
+- Source section: `13.10`
+
+
+
+Purpose:
+DeviceManager deviceManager = new DeviceManager();
+
+
+Source details:
+```text
+DeviceManager deviceManager = new DeviceManager();
+//disable
+deviceManager.setSettingProperty("persist-persist.sys.urv.disable.change_language", "true");
+//enable
+deviceManager.setSettingProperty("persist-persist.sys.urv.disable.change_language", "false");
+```
+
+## Switch Keyboard State
+
+- **源文档章节：** 13.11
+
+- Source section: `13.11`
+
+
+
+Purpose:
+//After keyboard switching, need to update the keyboard state in the status bar.
+
+
+Source details:
+```text
+//After keyboard switching, need to update the keyboard state in the status bar.
+//keyboard mode: 0-NUM, 1-LOWER, 2-UPPER.
+String MODE_KB = "0";
+new DeviceManager.setSettingProperty("Global-ufans.keyboard.state", MODE_KB);
+```
+
+## Update the Keyboard State in Status bar
+
+- **源文档章节：** 13.12
+
+- Source section: `13.12`
+
+
+
+Purpose:
+sendBroadcast(new Intent("android.intent.action.ACTION_SWITCH_KEY_STATE"));
+
+
+Source details:
+```text
+sendBroadcast(new Intent("android.intent.action.ACTION_SWITCH_KEY_STATE"));
+```
+
+## Switch Wi-Fi
+
+- **源文档章节：** 13.13
+
+- Source section: `13.13`
+
+
+
+Purpose:
+new DeviceManager().switchWifi(boolean enable);
+
+
+Source details:
+```text
+new DeviceManager().switchWifi(boolean enable);
+```
+
+## Switch Bluetooth
+
+- **源文档章节：** 13.14
+
+- Source section: `13.14`
+
+
+
+Purpose:
+new DeviceManager().switchBT(boolean enable);
+
+
+Source details:
+```text
+new DeviceManager().switchBT(boolean enable);
+```
+
+## Switch Airplane mode
+
+- **源文档章节：** 13.15
+
+- Source section: `13.15`
+
+
+
+Purpose:
+new DeviceManager().setAirplaneMode(boolean enable);
+
+
+Source details:
+```text
+new DeviceManager().setAirplaneMode(boolean enable);
+```
+
+## Forget All Wi-Fi
+
+- **源文档章节：** 13.16
+
+- Source section: `13.16`
+
+
+
+Purpose:
+new DeviceManager().forgetAllWifi();
+
+
+Source details:
+```text
+new DeviceManager().forgetAllWifi();
+```
+
+## Check Network Status
+
+- **源文档章节：** 13.17
+
+- Source section: `13.17`
+
+
+
+Purpose:
+int status = new DeviceManager().checkNetworkStatus();
+
+
+Source details:
+```text
+int status = new DeviceManager().checkNetworkStatus();
+//0:Normal network connection.
+//1:SIM card not ready.
+//2:Mobile network shutdown.
+//3:Not registered on the network.
+//4:APN configuration failed.
+//5:No data connection.
+//6:No Internet connection.
+```
+
+## Set/Get GPS Accuracy
+
+- **源文档章节：** 13.18
+
+- Source section: `13.18`
+
+
+
+Purpose:
+DeviceManager deviceManager = new DeviceManager();
+
+
+Source details:
+```text
+DeviceManager deviceManager = new DeviceManager();
+boolean ret = deviceManager.setSettingProperty("Secure-location_mode", "3");
+String value = deviceManager.getSettingProperty("Secure-location_mode");
+
+boolean ret = deviceManager.setSettingProperty("ro.ufs.gps.high_accuracy", "true");
+String value = deviceManager.getSettingProperty("ro.ufs.gps.high_accuracy");
+```
+
+## Set physical button volume
+
+- **源文档章节：** 13.19
+
+- Source section: `13.19`
+
+
+
+Purpose:
+//volume: 0-15
+
+
+Source details:
+```text
+//volume: 0-15
+int volume = 0;
+new DeviceManager().setSettingProperty("persist-persist.sys.urv.notification.volume",
+"" + volume);
+```