QuickSettings之使用

一、添加一个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()