通用 SDK 文档
概述
该 SDK 封装了基于硬件的通用功能,包括:定时开机、关机、重启、设置音量、开关屏幕背光等功能。部分接口需要系统签名才能调用。
使用方式
引入依赖
首先需要在项目中添加私有仓库地址,然后在项目的 build.gradle 文件中添加如下依赖:
dependencies {
implementation 'cn.com.shine.sdk:common:3.7.9'
}
所有接口都在 SystemCommonUtils 类中。
初始化
void init(Application app)
初始化 SDK,建议在 Application 的 onCreate 方法中调用。
| 参数 | 描述 |
|---|---|
| app | Application 对象 |
重启应用
void relaunchApp()
是否使用系统签名
boolean useSystemSigning()
| 返回值 | 描述 |
|---|---|
| boolean | 是否使用系统签名 |
设置系统属性
void setSystemProperties(String key, String value)
| 参数 | 描述 |
|---|---|
| key | 属性名 |
| value | 属性值 |
获取系统属性
String getSystemProperties(String key)
| 参数 | 描述 |
|---|---|
| key | 属性名 |
| 返回值 | 描述 |
|---|---|
| String | 属性值 |
设置系统时间
boolean setSystemTime(long millis)
| 参数 | 描述 |
|---|---|
| millis | 时间戳 |
| 返回值 | 描述 |
|---|---|
| boolean | 是否设置成功 |
静默安装
boolean installSilent(Context context, String filePath)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| filePath | apk 文件路径 |
| 返回值 | 描述 |
|---|---|
| boolean | 是否安装成功 |
隐藏导航栏
void hideNavigationBar(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
显示导航栏
void showNavigationBar(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
隐藏状态栏
void hideStatusBar(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
显示状态栏
void showStatusBar(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
设置音量
void setStreamVolume(final Context context, final int streamType, final int num)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| streamType | 音量类型 |
| num | 音量值 0~100 |
获取音量
int getStreamVolume(final Context context, final int streamType)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| streamType | 音量类型 |
| 返回值 | 描述 |
|---|---|
| int | 音量值 0~100 |
关闭屏幕背光
int closeScreen(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| 返回值 | 描述 |
|---|---|
| int | 0:成功;非 0:失败 |
打开屏幕背光
int openScreen(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| 返回值 | 描述 |
|---|---|
| int | 0:成功;非 0:失败 |
获取屏幕背光状态
boolean isBacklightEnable(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| 返回值 | 描述 |
|---|---|
| boolean | true:开启;false:关闭 |
设置屏幕背光亮度
boolean setScreenBrightness(Context context, int value)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| value | 亮度值 0~255 |
| 返回值 | 描述 |
|---|---|
| boolean | true:成功;false:失败 |
获取屏幕背光亮度
int getScreenBrightness(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| 返回值 | 描述 |
|---|---|
| int | 亮度值 0~255 |
重启设备
void reboot(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
关机
void shutdown(Context context)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
设置开机时间
void setWakeUpTimeMillis(Context context, long timeMillis)
| 参数 | 描述 |
|---|---|
| context | 上下文 |
| timeMillis | 时间戳 |