一、添加一个Tile
-
创建一个类继承TileService
public class MyTileService extends TileService { }
-
在AndroidManifest.xml配置这个服务
因为TileService是一个服务,所以需要在AndroidManifest.xml中进行配置
<service android:name=".MyTileService" android:label="@string/my_default_tile_label" android:icon="@drawable/my_default_icon_label" android:permission="android.permission.BIND_QUICK_SETTINGS_TILE"> <intent-filter> <action android:name="android.service.quicksettings.action.QS_TILE" /> </intent-filter> </service>
MyTileService将会被检测是否与ACTION_QS_TILE匹配,并且需要"android.permission.BIND_QUICK_SETTINGS_TILE"权限,可以指定tile的icon和label
-
添加到快速设置区域
运行程序,就可以在快速设置编辑面板的可添加区域看到新增的Tile,可长按拖动添加到快速设置面板中
二、重写TileService中的方法
1. 生命周期回调方法
在继承TileService的类中重写TileService生命周期回调方法
public class MyTileService extends TileService {
public static final String TAG = MyTileService.class.getSimpleName();
@Override
public void onTileAdded() {
super.onTileAdded();
// 当用户添加Tile到快速设置区域时调用,可以在这里进行一次性的初始化操作。
Log.d(TAG, "onTileAdded()============");
}
@Override
public void onStartListening() {
super.onStartListening();
// 当Tile变为可见时调用,这里可以进行更新Tile,注册监听或回调等操作。
Log.d(TAG, "onStartListening()============");
}
@Override
public void onStopListening() {
super.onStopListening();
// 当Tile变为不可见时调用,这里可以进行注销监听或回调等操作。
Log.d(TAG, "onStopListening()============");
}
@Override
public void onTileRemoved() {
super.onTileRemoved();
// 当用户从快速设置区域移除一个Tile时调用,这里不要做有关于此Tile的任何操作。
Log.d(TAG, "onTileRemoved()============");
}
}
2. 处理点击事件
处理Tile的点击时间需要重写TileService的onClick()发放
@Override
public void onClick() {
super.onClick();
// 这里可以响应用户点击Tile的操作
Log.d(TAG, "onClick()============");
}
3. TileService提供的方法
TileService提供了一些方法用来执行常用的操作,可以在onClick()方法中调用这些执行方法。
- [showDialog(Dialog)] 会折叠快速设置面板并显示一个对话框
[showDialog(Dialog)]:https://developer.android.com/reference/android/service/quicksettings/TileService.html#showDialog(android.app.Dialog) - [startActivityAndCollapse(Intent)] 会折叠快速设置面板并启动一个Activity
[startActivityAndCollapse(Intent)]:https://developer.android.com/reference/android/service/quicksettings/TileService.html#startActivityAndCollapse(android.content.Intent) - [unlockAndRun(Runnable)] 在执行Runnable前提示用户解锁设备。将会提示用户用当前设置的解锁方式解锁,如果用户解锁成功将会执行Runnable,如果用户未能解锁成功或取消操作,Runnable将不会执行
[unlockAndRun(Runnable)]:https://developer.android.com/reference/android/service/quicksettings/TileService.html#unlockAndRun(java.lang.Runnable) - [isLocked()] 返回屏幕是否被锁定。如果屏幕锁定,[showDialog(Dialog)]方法显示的dialog将会在锁屏之下;如果在屏幕锁定期间的Tile行为是安全的,那么应该使用startActivity(Intent)在锁屏之上运行一个Activity,否则Tile应该使用[unlockAndRun(Runnable)]给用户解锁提示。
[isLocked()]:https://developer.android.com/reference/android/service/quicksettings/TileService.html#isLocked() - [isSecure()] 返回设备是否处于安全状态(如设置的图案、PIN码或指纹解锁,在未解锁前设备处于安全状态;若没有设置解锁或滑动解锁,则设备始终处于非安全状态),Tile在响应用户点击操作时应该检测设备是否安全,并相应的改变行为。
[isSecure()]:https://developer.android.com/reference/android/service/quicksettings/TileService.html#isSecure()
三、操作Tile
1. 获取Tile
可以通过TileService提供的[getQSTile()]方法来获取到改Service的Tile,可以用来获取或设置Tile的状态,对Tile的更新只在[onStartListening()]和[onStopListening()]之间有效。
[getQSTile()]:https://developer.android.com/reference/android/service/quicksettings/TileService.html#getQsTile()
[onStartListening()]: https://developer.android.com/reference/android/service/quicksettings/TileService.html#onStartListening()
[onStopListening()]: https://developer.android.com/reference/android/service/quicksettings/TileService.html#onStopListening()
2. 修改Tile
获取到Tile之后可以使用Tile提供的方法对Tile进行修改
- [setIcon(Icon)] 设置Tile的icon,图标的颜色将会是白色的,也有可能被系统着色适配其它主题。
[setIcon(Icon)]:https://developer.android.com/reference/android/service/quicksettings/Tile.html#setIcon(android.graphics.drawable.Icon) - [setLabel(CharSequence)] 设置Tile的label
[setLabel(CharSequence)]:https://developer.android.com/reference/android/service/quicksettings/Tile.html#setLabel(java.lang.CharSequence) - [setContentDescription(CharSequence)] 设置Tile的内容描述
[setContentDescription(CharSequence)]:https://developer.android.com/reference/android/service/quicksettings/Tile.html#setContentDescription(java.lang.CharSequence) - [setState(int)] 设置Tile的状态
[setState(int)]:https://developer.android.com/reference/android/service/quicksettings/Tile.html#setState(int)
** 以上四种方法调用完之后并不会立即产生效果,只有再调用了Tile的[updateTile()]方法之后才会产生效果 **
- [updateTile()] 将当前Tile的样式和状态发送到快速设置区域以更新显示
[updateTile()]:https://developer.android.com/reference/android/service/quicksettings/Tile.html#updateTile()