情景模式

0.1. 前言
0.2. 介绍
0.3. 新建
0.4. Fatcs-params
0.5. Handle
0.6. 全局变量

0.1. 前言

You can build a simple rules engine yourself. All you need is to create a bunch of objects with conditions and actions, store them in a collection, and run through them to evaluate the conditions and execute the actions. Martin Fowler

0.2. 介绍

情景模式简单理解：

“什么时候，干什么。”

什么时候就是触发条件（condition）

干什么就是动作（actions）

0.3. 新建

新建一条入门实例如下，以JSON格式为例：

[
  {
    "name": "Current pkg",
    "description": "应用切换时，使用Toast显示当前应用的当前应用包名",
    "priority": 2,
    "delay": 2000,
    "condition": "frontPkgChanged == true",
    "actions": [
      "ui.showShortToast(activity.getFrontAppPackage());"
    ]
  }
]

参数解释：

参数名	含义
name	请使用英文，情景模式名字，多个模式不能重复，否则会被覆盖
description	任意的描述
priority	优先级，决定执行顺序
delay	action 动作执行的延迟，时间单位为毫秒
condition	触发条件，支持mvel表达式，条件可选的基于事实的facts-param请参考下面的章节语法注意：双引号需要使用\转移字符转义
actions	要执行的动作，支持mvel表达式，可以设置多个，动作可选的handle请参考下面的章节语法注意：双引号需要使用\转移字符转义

0.4. Fatcs-params

除了提供规则引擎之外，Thanox也会提供常用的事实与参数，用于condition条件判断。

0.4.1. 应用安装、卸载、更新

应用安装、卸载、更新之后，thanox会发布这个事实，并注入一些参数，你可以使用这些参数做条件判断，或者执行动作时作为参数使用。

参数名	类型	含义	示例
pkgAdded	Boolean	新应用已经安装	如下
pkgRemoved	Boolean	应用被卸载	如下
pkgUpdated	Boolean	应用已更新	如下
pkgName	String	安装的应用包名	如下

pkgAdded 示例

作为条件判断：
```
"condition":  "pkgAdded == true"
```

pkgName示例

作为条件判断：

"condition":  "pkgAdded == true && pkgName == \"com.tencent.mm\""

作为动作参数：
```
"ui.showShortToast(pkgName);"
```

0.4.2. 应用切换

前台应用切换时，thanox也会发布这个事实，参数如下。

参数名	类型	含义	示例
frontPkgChanged	Boolean（true/false）	前台应用已切换	如下
from	String（字符串）	从哪个应用切换的，包名	如下
to	String（字符串）	切换到哪个应用，包名	略

frontPkgChanged示例

作为条件判断：

"condition":  "frontPkgChanged == true"

from示例

作为条件判断，微信是否回到了后台：

"condition":  "frontPkgChanged == true && from == \"com.tencent.mm\""

0.4.3. 任务清理

当某个应用的任务被移除时，一般场景为最近任务中，该任务被用户划掉。此时thanox也会发布这个事实，参数如下。

参数名	类型	含义	示例
taskRemoved	Boolean（true/false）	任务已移除	如下
pkgName	String（字符串）	从哪个应用切换的，包名	如下

taskRemoved示例

作为条件判断：
```
"condition":  "taskRemoved == true"
```

pkgName示例：

作为条件判断，微信任务移除时杀死应用：

"condition":  "taskRemoved == true && pkgName == \"com.tencent.mm\""，
"actions": [
  		"ui.showShortToast(\"正在杀死微信\");",
      "killer.killPackage(pkgName);"
    ]

0.4.4. Activity Created

通常一个应用的活动页已经创建好，可以称为Activity Created。此时thanox也会发布这个事实，参数如下。通常一个活动的生命周期为Created（创建好）–>Resumed（显示好，可以交互了）–> Paused（暂停）–> Destroyed（销毁了），需要注意的是，

如果一个活动走到Resumed状态时，被其他活动覆盖，例如被支付宝支付页面覆盖，那么它会走如下生命周期： Resumed–> Paused（被其他活动覆盖）–>Resumed（如果其他活动销毁了，回到了该活动，那么又会恢复到Resumed，而不会再次Create）。

详细的Android活动的生命周期可以参考：https://developer.android.com/guide/components/activities/activity-lifecycle

参数名	类型	含义	示例
activityCreated	Boolean（true/false）	活动页已经创建好	如下
componentNameAsString	String（字符串）	活动的组件全名，Thanox的显示当前活动复制来的名字就是这个	如下
componentNameAsShortString	String（字符串）	活动的组件缩名	如下
componentName	ComponentName	活动的组件	如下
pkgName	String（字符串）	应用的包名	如下

0.4.5. Activity Resumed

通常一个应用的活动页已经显示，可以称为Activity Resumed。此时thanox也会发布这个事实，参数如下。

参数名	类型	含义	示例
activityResumed	Boolean（true/false）	活动已经显示	如下
componentNameAsString	String（字符串）	活动的组件全名，Thanox的显示当前活动复制来的名字就是这个	如下
componentNameAsShortString	String（字符串）	活动的组件缩名	如下
componentName	ComponentName	活动的组件	如下
pkgName	String（字符串）	应用的包名	如下

通常很多应用启动首页会有一个首页显示广告，有个跳过按钮可以点击，下面是使用该事实实现的广告跳过示例：

[
  {
    "name": "AD Skip",
    "description": "彩云天气广告页面点击跳过",
    "priority": 1,
    "condition": "activityResumed == true && componentNameAsShortString == \"com.nowcasting.activity/.SplashActivity\"",
    "actions": [
      "ui.showShortToast(\"尝试点击跳过...\");",
      "ui.findAndClickViewByText(\"跳过\", \"com.nowcasting.activity/com.nowcasting.activity.SplashActivity\");"
    ]
  }
]

提示：此处条件只判断了彩云天气，可以使用

操作符做多条件判断。此处的ui操作后续会介绍。

0.4.6. Activity Changed

当前前台活动(Activity)发生改变时thanox会发布该事件。(Since Thanox(or Pro)-2.5)

参数名	类型	含义	示例
frontActivityChanged	Boolean（true/false）	前台Activity改变	无
fromActivity	ComponentName	活动的组件	无
toActivity	ComponentName	活动的组件	无

ComponentName 是活动组件名称。

例如：com.android.messaging/com.android.messaging.ui.conversationlist.ConversationListActivity

Thanox的开发者设置中，”显示当前Activity”功能也可以显示当前activity的ComponentName。

0.4.7. 应用停止运行

应用被杀死或者其他原因停止运行，Thanox会发布该事实。

参数名	类型	含义	示例
pkgKilled	Boolean（true/false）	任务已移除	如下
pkgName	String（字符串）	应用包名	如下

0.4.8. 屏幕开关

参数名	类型	含义	示例
screenOn	Boolean（true/false）	亮屏事件	无
screenOff	Boolean（true/false）	灭屏事件	无
userPresent	Boolean（true/false）	解锁事件	无

0.4.9. 电量变化

参数名	类型	含义	示例
batteryChanged	Boolean（true/false）	电量发生变化	无
batteryLevel	int	电量	无
isCharging	Boolean（true/false）	是否在充电	无
isAcCharge	Boolean（true/false）	是否为AC	无
isUsbCharge	Boolean（true/false）	是否为USB	无

0.4.10. 蓝牙事件

参数名	类型	含义	示例
btStateChanged	Boolean（true/false）	蓝牙开关状态发生变化	无
btStateOff	Boolean（true/false）	蓝牙为关闭状态	无
btStateTurningOff	Boolean（true/false）	蓝牙为正在关闭状态	无
btStateOn	Boolean（true/false）	蓝牙为开启状态	无
btStateTurningOn	Boolean（true/false）	蓝牙为正在开启状态	无

btConnectionStateChanged	Boolean（true/false）	蓝牙连接状态发生变化	无
btConnectionStateConnected	Boolean（true/false）	蓝牙为已连接状态	无
btConnectionStateConnecting	Boolean（true/false）	蓝牙为正在连接状态	无
btConnectionStateDisconnected	Boolean（true/false）	蓝牙为断开连接状态	无
btConnectionStateDisconnecting	Boolean（true/false）	蓝牙为正在断开连接状态	无

btBoundedDevices	List of BluetoothDevice	绑定的蓝牙设备模型列表	无
btBoundedDeviceAddresses	List of String	绑定的蓝牙设备地址列表	无
btBoundedDeviceAliasNames	List of String	绑定的蓝牙设备Alias列表	无
btBoundedDeviceBatteryLevel	List of Int	绑定的蓝牙设备电量信息列表	无

提示： Battery level in percents from 0 to 100, or -1 if Bluetooth is disabled, or device is disconnected, or does not have any battery reportingservice, or return value is invalid

示例1：

[
  {
    "name": "BT Connection State",
    "description": "蓝牙连接状态监听，此处监听连接事件，Toast显示所有连接设备，并判断是不是连接的MDR-XB650BT",
    "priority": 2,
    "condition": "btConnectionStateChanged == true && btConnectionStateConnected == true",
    "actions": [
      "ui.showShortToast(\"蓝牙连接连接到新设备了，所有设备名称为：\" + btBoundedDeviceAliasNames);",
      "ui.showShortToast(\"蓝牙连接连接到新设备了，包含MDR-XB650BT设备吗？\" + btBoundedDeviceAliasNames.contains(\"MDR-XB650BT\"));"
    ]
  }
]

示例2：

[
  {
    "name": "BT Connection State Advanced",
    "description": "同蓝牙连接状态监听，只是使用了btBoundedDevices:BluetoothDevice参数",
    "priority": 2,
    "condition": "btConnectionStateChanged == true && btConnectionStateConnected == true",
    "actions": [
      "ui.showShortToast(\"蓝牙连接连接到新设备了，第一个设备名称为：\" + btBoundedDevices.get(0).getAddress());"
    ]
  }
]

0.4.11. Wifi状态变化

Wifi状态变化时发出的事件。（Since Thanox 2.5-2）

参数名	类型	含义	示例
wifiStateChanged	Boolean（true/false）	Wifi状态是否改变	无
wifiState	WifiState	状态	无

WifiState:

data class WifiState(
  // 是否是开启状态
  val enabled: Boolean, 
  // 状态信息（例如：No network）
  val statusLabel: String?, 
  // SSID（例如：ChinaNet-d2Xq-5G）
  val ssid: String?
)

0.4.12. 系统启动

参数名	类型	含义	示例
systemReady	Boolean（true/false）	系统启动完成	无

0.4.13. 推送消息

参数名	类型	含义	示例
fcmPushMessageArrived	Boolean（true/false）	收到GCM/FCM消息推送	无
pkgName	String（字符串）	应用包名	无

0.4.14. 通知

参数名	类型	含义	示例
notificationAdded	Boolean（true/false）	新通知到达	无
notificationUpdated	Boolean（true/false）	通知更新	无
notificationRemoved	Boolean（true/false）	通知移除	无
pkgName	String（字符串）	通知所属应用包名	无
userId	Int	通知app的用户id	无
notificationTitle	String（字符串）	通知标题	无
notificationContent	String（字符串）	通知内容	无
notification	NotificationRecord	通知记录，该模型包含更详细的信息，查看模型定义	无

示例：

[
  {
    "name": "Notification events",
    "description": "通知事件",
    "priority": 1,
    "condition": "notificationAdded || notificationRemoved || notificationUpdated",
    "actions": [
      "ui.showShortToast(\"通知事件 \" + pkgName + notificationContent);"
    ]
  }
]

0.5.15 快捷方式

你可以创建一个有”意义的“桌面快捷方式，当你点击这个桌面快捷方式的时候，Thanox会发布这个快捷方式代表的事实。

例如；实现一个一键锁屏快捷方式，即：点击桌面一键锁屏快捷方式时锁屏。

首先创建一个快捷方式引擎：

prlfile-shortcut-create

接下来，添加一个情景模式，监听这个快捷方式的启动事件，并指定锁屏命令：

[
  {
    "name": "Profile shortcut",
    "description": "监听一个快捷方式启动事件，以一键锁屏为例",
    "priority": 2,
    "condition": "shortcutLaunched == true && shortcutValue == \"turn screen off\"",
    "actions": [
      "power.sleep(0);"
    ]
  }
]

保存之后，点击桌面上的一键锁屏快捷方式即可实现一键锁屏功能了。

0.5. Handle

Thanox会提供一部分执行动作所需要的handle能力。例如ui，专门用于做界面显示相关的动作。

你可以使用handle.action(params)来执行自定义的动作。

下面是目前支持的Handle能力。

0.5.1. killer

能力	含义	参数	举例	返回值
killPackage	杀死应用	包名	killer.killPackage(“com.tencent.mm”)	Boolean（true/false）

接口定义：

@HandlerName("killer")
interface IKiller {
    boolean killPackage(String pkgName);
}

举例：

"actions": [
  // 杀死微信
  "killer.killPackage(\"com.tencent.mm\")"
]

0.5.2. activity

能力	含义	参数	举例	返回值
launchProcessForPackage	启动应用进程	包名	如下	Boolean（true/false）
launchMainActivityForPackage	打开应用主界面	包名	如下	Boolean（true/false）
getLaunchIntentForPackage	获取应用的启动Intent	包名	如下	Intent
getFrontAppPackage	获取当前前台应用包名	无	如下	String（字符串）
getFrontAppPackageComponent	获取当前前台应用组件	无	如下	ComponentName

接口定义：

@HandlerName("activity")
interface IActivity {
    boolean launchProcessForPackage(String pkgName);

    boolean launchActivity(Intent intent);

    boolean launchMainActivityForPackage(String pkgName);

    Intent getLaunchIntentForPackage(String pkgName);

    String getFrontAppPackage();

    ComponentName getFrontAppPackageComponent();
}

举例：

"actions": [
  // 启动微信进程
  "activity.launchProcessForPackage(\"com.tencent.mm\")",
  // 打开微信主界面
  "activity.launchMainActivityForPackage(\"com.tencent.mm\")",
  // 吐司显示目前前台应用包名
  "toast.showShortToast(activity.getFrontAppPackage())"
]

0.5.3. power

电源相关能力

能力	含义	参数	举例	返回值
sleep	休眠（锁屏）	延迟的毫秒数	如下	无
wakeup	唤醒	延迟的毫秒数	如下	无
setBrightness	设置屏幕亮度	亮度Level值(0~255)	如下	无
getBrightness	获取当前屏幕亮度	无	如下	度Level值(0~255)
setAutoBrightnessEnabled	设置自动亮度开关	true/false	如下	无
isAutoBrightnessEnabled	是否开启自动亮度	无	如下	true/false

接口定义：

@HandlerName("power")
interface IPower {
    void sleep(long delay);

    void wakeup(long delay);
  
    void setBrightness(int level);

    int getBrightness();

    void setAutoBrightnessEnabled(boolean enable);

    boolean isAutoBrightnessEnabled();
}

举例：

{
    "actions": [
        // 立即锁屏
        "power.sleep(0)",
        // 1秒后亮屏
        "power.wakeup(1000)",
        "power.setAutoBrightnessEnabled(false)",
        "power.setBrightness(power.getBrightness() + 1)",
    ]
}

0.5.4. task

任务相关能力

能力	含义	参数	举例	返回值
removeTasksForPackage	移除应用的最近任务	包名	如下	无
hasTaskFromPackage	应用是否有最近任务	包名	如下	Boolean（true/false）
clearBackgroundTasks	调用thanox的任务清理功能，清理所有最近任务	无	如下	无

接口定义：

@HandlerName("task")
interface ITask {
    void removeTasksForPackage(String pkgName);

    boolean hasTaskFromPackage(String pkgName);

    void clearBackgroundTasks();
}

举例：

{
  	// 判断微信是否有任务
    "condition": "true && task.hasTaskFromPackage(\"com.tencent.mm\")",
    "actions": [
        // 移除微信的最近任务
        "task.removeTasksForPackage(\"com.tencent.mm\")"
    ]
}

0.5.5. ui

界面相关

能力	含义	参数	举例	返回值
showShortToast	显示提示	无	如下	无
showLongToast	显示时间较短的提示	无	如下	无
showDialog	显示对话框	标题文本，信息文本，确认按钮文本	如下	无
showNotification	显示通知	标签（可用于取消通知）标题文本，信息文本，是否重要	如下	无
cancelNotification	取消通知	标签	如下	无
showDanmu	显示一条弹幕 [since Thanox4.0.9]	弹幕文本	如下	无
showDanmu	显示一条带图标的弹幕 [since Thanox4.0.9]	图标，弹幕文本	如下	无

接口定义：

@HandlerName("ui")
interface IUI {

    void showShortToast(@NonNull String msg);

    void showLongToast(@NonNull String msg);

    void showDialog(@Nullable String title,
                    @NonNull String msg,
                    @Nullable String yes);

    void showNotification(
            @NonNull String notificationTag,
            @NonNull String title,
            @NonNull String msg,
            boolean important);

    void cancelNotification(@NonNull String notificationTag);
    
    void showDanmu(@NonNull Object msg);

    /**
     * Show a danmu on your screen.
     *
     * @param icon Icon for danmu, supported format:
     *             app icon: app://app.package.name
     * @param msg  The text to show
     */
    void showDanmu(@Nullable String icon, @NonNull Object msg);
}

使用弹幕API的例子：

[
  {
    "name": "弹幕通知 Danmu notification",
    "description": "收到通知时用弹幕展示 Show Danmu on notification posted",
    "priority": 1,
    "condition": "notificationAdded && !notification.isForegroundService && pkgName != \"android\"",
    "actions": [
      "ui.showDanmu(\"app://\" + pkgName, thanos.pkgManager.getAppInfo(pkgName).appLabel + \" \" + notificationTitle + \"\n\" + notificationContent);"
    ]
  }
]

0.5.6. hw

硬件操作能力

能力	含义	参数	举例	返回值
enableWifi	看名字	包名	如下	Boolean（true/false）
disableWifi	看名字	无	如下	Boolean（true/false）
isWifiEnabled	看名字	无	如下	Boolean（true/false）
enableLocation	看名字	无	如下	Boolean（true/false）
disableLocation	看名字	无	如下	Boolean（true/false）
isLocationEnabled	看名字	无	如下	Boolean（true/false）
enableBT	看名字	无	如下	Boolean（true/false）
disableBT	看名字	无	如下	Boolean（true/false）
isBTEnabled	看名字	无	如下	Boolean（true/false）
enableNfc	看名字	无	如下	Boolean（true/false）
disableNfc	看名字	无	如下	Boolean（true/false）
isNfcEnabled	看名字	无	如下	Boolean（true/false）
enabledFlashlight	看名字	无	如下	Boolean（true/false）
disableFlashlight	看名字	无	如下	Boolean（true/false）
isFlashlightEnabled	看名字	无	如下	Boolean（true/false）
isFlashlightAvailable	手电筒是否可用（被占用？无硬件？）	无	如下	Boolean（true/false）

接口定义：

@HandlerName("hw")
interface IHW {
    boolean enableWifi();

    boolean disableWifi();

    boolean isWifiEnabled();

    boolean enableLocation();

    boolean disableLocation();

    boolean isLocationEnabled();

    boolean enableBT();

    boolean disableBT();

    boolean isBTEnabled();

    boolean enableNfc();

    boolean disableNfc();

    boolean isNfcEnabled();
  
    boolean enabledFlashlight();

    boolean disableFlashlight();

    boolean isFlashlightEnabled();

    boolean isFlashlightAvailable();
}

举例：

[
  {
    "name": "Enable BT",
    "description": "打开微信时，打开蓝牙",
    "priority": 2,
    "condition": "frontPkgChanged == true && to == \"com.tencent.mm\"",
    "actions": [
      "ui.showShortToast(\"蓝牙状态\" + (hw.isBTEnabled() ? \"开启\" : \"关闭\"));",
      "ui.showShortToast(\"正在打开蓝牙...\");",
      "ui.showShortToast(\"蓝牙打开\" + (hw.enableBT() ? \"成功\" : \"失败\"));",
      // 打开GPS
      "hw.enableLocation()",
      "hw.enableWifi()"
    ]
  }
]

0.5.7. io

文件读写能力。

注意：受限于文件权限，所有文件的根目录为/data/system/thanos_xxx/profile_user_io

能力	含义	参数	举例	返回值
read	读取文件	文件相对路径	略	String
write	写内容到文件	文件相对路径	略	Boolean
writeAppend	写内容到文件，追加	文件相对路径	略	Boolean

接口定义：

@HandlerName("io")
interface IIO {

    String read(String path);

    boolean write(String path, String content);

    boolean writeAppend(String path, String content);
}

0.5.8. data

移动数据相关能力。

能力	含义	参数	举例	返回值
setDataEnabled	设置移动数据开启状态	true打开，false关闭	如下	Boolean（true/false）
setDataEnabled	设置移动数据开启状态（可以指定卡序号）	卡序号，true打开，false关闭	如下	无
setDataEnabledForSlot	设置移动数据开启状态（可以指定卡槽号）	卡序号，true打开，false关闭	如下	无
isDataEnabled	获取移动数据开启状态	true打开，false关闭	如下	Boolean（true/false）
isDataEnabledForSlot	获取移动数据开启状态（可以指定卡槽号）	true打开，false关闭	如下	Boolean（true/false）
setDataNetworkType	设置网络模式	type	如下	无
setDataNetworkTypeForPhone	设置网络模式（指定某个卡）	phoneId，type	如下	无
setDataNetworkTypeForSlot	设置网络模式（指定某个卡槽号）	slotId，type	如下	无
getCurrentPreferredNetworkMode	获取当前默认卡的网络模式	无	如下	int
getCurrentPreferredNetworkMode	获取某subId的网络模式	subId	如下	int
getCurrentPreferredNetworkModeForSlot	获取某卡槽的网络模式	slotId	如下	int
isAirplaneModeEnabled	是否开启了飞行模式	无	无	Boolean

接口定义：

@HandlerName("data")
interface IData {
    void setDataEnabled(boolean enable);

    void setDataEnabled(int subId, boolean enable);

    void setDataEnabledForSlot(int slotId, boolean enable);

    boolean isDataEnabled();

    boolean isDataEnabledForSlot(int slotId);

    void setDataNetworkType(int type);

    void setDataNetworkTypeForPhone(int phoneId, int type);

    void setDataNetworkTypeForSlot(int slotId, int type);

    int getCurrentPreferredNetworkMode();

    int getCurrentPreferredNetworkMode(int subId);

    int getCurrentPreferredNetworkModeForSlot(int slotId);
}

数据网络模式类型：

// Network type enums, primarily used by android/telephony/TelephonyManager.java.
// Do not add negative types.
enum NetworkTypeEnum {
    NETWORK_TYPE_UNKNOWN = 0;
    NETWORK_TYPE_GPRS = 1;
    NETWORK_TYPE_EDGE = 2;
    NETWORK_TYPE_UMTS = 3;
    NETWORK_TYPE_CDMA = 4;
    NETWORK_TYPE_EVDO_0 = 5;
    NETWORK_TYPE_EVDO_A = 6;
    NETWORK_TYPE_1XRTT = 7;
    NETWORK_TYPE_HSDPA = 8;
    NETWORK_TYPE_HSUPA = 9;
    NETWORK_TYPE_HSPA = 10;
    NETWORK_TYPE_IDEN = 11;
    NETWORK_TYPE_EVDO_B = 12;
    NETWORK_TYPE_LTE = 13;
    NETWORK_TYPE_EHRPD = 14;
    NETWORK_TYPE_HSPAP = 15;
    NETWORK_TYPE_GSM = 16;
    NETWORK_TYPE_TD_SCDMA = 17;
    NETWORK_TYPE_IWLAN = 18;
    NETWORK_TYPE_LTE_CA = 19;
    NETWORK_TYPE_NR = 20;
}

举例：

[
  {
    "name": "Enable Data",
    "description": "打开微信时，打开移动数据",
    "priority": 2,
    "condition": "frontPkgChanged == true && to == \"com.tencent.mm\"",
    "actions": [
      "ui.showShortToast(\"移动数据当前\" + (data.isDataEnabled() ? \"开启\" : \"关闭\"));",
      "ui.showShortToast(\"正在打开移动数据...\");",
      "data.setDataEnabled(true)"
    ]
  }
]

0.5.9. ringtone

铃音振动能力。

能力	含义	参数	举例	返回值
dingdingding	看名字	无或者重复次数	如下	无
wengwengweng	看名字	无或者重复次数	如下	无

接口定义：

@HandlerName("ringtone")
interface IRingtone {
    void dingdingding();

    void wengwengweng();

    void dingdingding(int repeat);

    void wengwengweng(int repeat);
}

0.5.10. sh

Shell sh能力。

能力	含义	参数	举例	返回值
exe	执行sh命令	命令字符串	无	结果

接口定义：

@HandlerName("sh")
interface ISh {
    CommandResult exe(String command);
}

0.5.11. input

按键输入能力。

能力	含义	参数	举例	返回值
injectKey	执行sh命令	命令字符串	无	结果
getLastKey	返回上次按键码	无	无	按键码
getLastKeyTime	返回上次按键的系统时间	无	无	系统时间mills

接口定义：

@HandlerName("input")
interface IInput {

    boolean injectKey(int code);

    int getLastKey();

    long getLastKeyTime();
}

0.5.12. pkg

包管理能力。

能力	含义	参数	举例	返回值
disableApplication	冻结应用	包名	无	无
enableApplication	解冻应用	包名	无	无
isApplicationEnabled	应用是否为非冻结状态	包名	无	Boolean(true/false)

接口定义：

@HandlerName("pkg")
interface IPkg {

    void disableApplication(String pkg);

    void enableApplication(String pkg);

    boolean isApplicationEnabled(String pkg);
}

0.5.13. Log

日志打印工具。

使用示例:

log.log("Log message");

接口定义：

@HandlerName("log")
public interface ILog {
    void log(String content);
}

0.5.14. Audio

声音管理相关。

能力	含义	参数	举例	返回值
getRingerMode	获取铃音模式	无	无	模式的int值
setRingerMode	设置铃音模式	模式的int值	无	无

铃音模式的int值标识：https://developer.android.com/reference/android/media/AudioManager#RINGER_MODE_SILENT
int RINGER_MODE_SILENT = 0;
int RINGER_MODE_VIBRATE = 1;
int RINGER_MODE_NORMAL = 2;

接口定义：

@HandlerName("audio")
interface IAudio {
    int getRingerMode();
  
  	// https://developer.android.com/reference/android/media/AudioManager#setRingerMode(int)
    void setRingerMode(int ringerMode);
}

0.5.15. Battery

Battery相关。

能力	含义	参数	举例	返回值
getBatteryState	获取电池状态	无	参考下方例子	BatteryState

BatteryState类型定义：

data class BatteryState(
    // 电量
    val batteryLevel: Int = 0,
    // 是否在充电
    val isCharging: Boolean = false,
    // 是否在AC充电
    val isAcCharge: Boolean = false,
    // 是否在USB充电
    val isUsbCharge: Boolean = false,
)

接口定义：

@HandlerName("battery")
public interface IBattery {
    BatteryState getBatteryState();
}

使用举例，获取电池电量：battery.getBatteryState().batteryLevel

0.5.16. Context

Android System Context，Android系统上下文。基于Context可以实现更丰富的功能调用。举例：

[
  {
    "name": "Use System Context",
    "description": "调用Context，获取当前User信息",
    "priority": 1,
    "condition": "screenOn == true",
    "actions": [
      "ui.showShortToast(\"User info: \" + context.getSystemService(context.USER_SERVICE).getUserInfo(android.os.UserHandle.getCallingUserId()).name);"
    ]
  }
]

0.5.17. Thanos

你可以使用thanox或thanos来调用Thanos API，举例：

[
  {
    "name": "Thanos API",
    "description": "Example actions with thanos API",
    "priority": 2,
    "condition": "frontPkgChanged == true && to == \"com.tencent.mm\"",
    "actions": [
      "thanos.getProfileManager().enableRuleByName(\"my_we_chat_rule\");"
    ]
  }
]

0.5.18. Actor(废弃)

~~情景模式Action相关，目前支持Action的延迟执行。~~

Actor已被废弃：请使用delay属性实现延迟效果。例如：

[
  {
    "name": "Delayed action example",
    "description": "...",
    "priority": 1,
    "delay": 2000,
    "condition": "...",
    "actions": [...]
  }
]

能力	含义	参数	举例	返回值
delayed	延迟执行一个Action	延迟毫秒数，Action表达式	无	无

接口定义：

@HandlerName("actor")
public interface IActor {
    void delayed(long delayMillis, String action);
}

举例：

[
  {
    "name": "Delayed action example",
    "description": "Execute the action delay 2s: show a short toast and log the event 2s after app switched.",
    "priority": 1,
    "condition": "frontPkgChanged == true",
    "actions": [
      "actor.delayed(2000, \"ui.showShortToast(\\\"App switched 2s ago\\\")\")",
      "actor.delayed(2000, \"log.log(to)\")"
    ]
  }
]

0.6. 全局变量

全局变量：name-List，名字---字符串列表

可用于条件判断，事件处理等。

Thanox支持创建，导入全局变量。发布事实时，你可以用过globalVarOf$拼接变量名来访问。以变量apps为例：

[
  {
    "name": "Use var example",
    "description": "应用切换时，如果当前前台应用在定义的变量列表apps中，Toast使用输出包名",
    "priority": 1,
    "condition": "frontPkgChanged == true && globalVarOf$apps.contains(to)",
    "actions": [
      "ui.showShortToast(to);"
    ]
  }
]

情景模式

Table of contents

0.1. 前言

0.2. 介绍

0.3. 新建

0.4. Fatcs-params

0.4.1. 应用安装、卸载、更新

0.4.2. 应用切换

0.4.3. 任务清理

0.4.4. Activity Created

0.4.5. Activity Resumed

0.4.6. Activity Changed

0.4.7. 应用停止运行

0.4.8. 屏幕开关

0.4.9. 电量变化

0.4.10. 蓝牙事件

0.4.11. Wifi状态变化

0.4.12. 系统启动

0.4.13. 推送消息

0.4.14. 通知

0.5.15 快捷方式

0.5. Handle

0.5.1. killer

0.5.2. activity

0.5.3. power

0.5.4. task

0.5.5. ui

0.5.6. hw

0.5.7. io

0.5.8. data

0.5.9. ringtone

0.5.10. sh

0.5.11. input

0.5.12. pkg

0.5.13. Log

0.5.14. Audio

0.5.15. Battery

0.5.16. Context

0.5.17. Thanos

0.5.18. Actor(废弃)

0.6. 全局变量