Android Lights
Android Lights
很多Android手机上都配有LED灯，手机在充电、新来短信等时候都会有相应的指示灯提示。
Android系统之中，一共定义了8个逻辑灯，包含：背光，键盘灯，按键灯，充电指示灯，通知提示等。
图表 A Android中的提示灯
其中，定义了系统中所有可能用到的Light。
Jni与Native：
与Lights相关的JNI代码在目录：frameworks/base/services/jni下，
So库的加载：
编译：Frameworks/base/services/jni/Android.mk中：
图表 B lights相关库文件的编译
生成动态库：libandroid_servers.so。
Java中加载so库时，系统调用方法：
Extern “C” jint JNI_OnLoad(JavaVM* vm, void* reserved) {
……
Register_android_server_LightsService(env);
……
}
来完成jni中相关函数的注册过程。
图表 C JNI中相关函数的注册
至此，已经通过jni建立了java与native函数的映射关系。在java代码中，可以通过调用相关函数来完成相应的功能了。
三个函数：
Jni中，通过JNI方式提供给java层调用的函数有三个：
Static JNINativeMethod mothod_table[] = {
{ “init_native”， “()I”, (void*)init_native, },
{ “finalize_native”, “(I)V”, (void*)finalize_native, },
{ “setLight_native”, “(IIIIIII)V”, (void*)setLight_native, },
};
- Static jint init_native(JNIEnv *env, jobject clazz)
{
//通过hw_get_module方法查到到注册为LIGHTS_HARDWARE_MODULE_ID，即：”lights”的module模块。
err = hw_get_module(LIGHTS_HARDWARE_MODULE_ID, (hw_module_t const**)&module);
if (err == 0)
{
Devices->lights[LIGHT_INDEX_BACKLIGHT] = get_device(module, LIGHT_ID_BACKLIGHT);
Devices->lights[LIGHT_INDEX_KEYBOARD] = get_device(module, LIGHT_INDEX_KEYBOARD);
……
}
}
- Static void finalize_native(JNIEnv *env, jobject clazz, int ptr)
{
If (devices == NULL)
{
Return;
}
Free(devices);
}
- Static void setLight_native(JNIEnv *env, jobject clazz, int ptr, int light, int colorARGB, int flashMode, int onMS, int offMS, int brightnessMode)
{
Memset(&state, 0, sizeof(light_state_t));
State.color = colorARGB;
State.flashMode = flashMode;
State.flashOnMS = onMS;
State.flashOffMS = offMS;
State.brightnessMode = brightnessMode;
……
Devices->lights[light]->setlight(devices->lights[light], &state);
}
Java Framework:
关于Light的系统服务：
services/java/com/android/server/LightsService.java
图表 D Frameworks中的LightsService
其中，有个很重要的内部类 Light，表示某种具体类型的指示灯，类图如下：
图表 E Frameworks中的Light类图
类中，最重要的一个方法：
Private void setLightLocked(int color, int mode, int onMS, int offMS, int brightnessMode)
{
mColor = color;
mMode = mode;
mOnMS = onMS;
mOffMS = offMS;
// 最后，通过调用native方法来完成函数功能
setLight_native(mNativePointer, mId, color, mode, onMS, offMS, brightnessMode);
}
二、 如何应用：
对于控制lights的服务——LightsService.java，android框架层没有提供直接的调用该类中相关功能函数的接口，所以应用程序无法通过直接调用API来控制指示灯的显示。
这里可以参考BatteryService类中对3-Color Light的使用方式：
- 获取特定的Light：
mBatteryLight = lights.getLight(LightService.LIGHT_ID_BATTERY);
- 根据需求，在不同的状态下，调用相关函数完成指示灯的功能：
mBatteryLight.setColor();
mBatteryLight.setFlashing();
