通用命令ExternCommand,用来向外部程序发送命令,目前仅能够支持解锁命令(仅在锁屏中有效),用这个命令可以实现解锁操作。
ExternalCommand,与ExternCommand相对,是用来接收外部的命令。ExternalCommand是一种特殊的Command,不集成在<Trigger>标签之下,而是直接写在<Lockscreen>标签之下,作为监测开关屏的命令。
ExternCommand
<ExternCommand command="" condition="" delay="" delayCondition=""/>
ExternalCommand
<ExternalCommands> <!--action通常用来接收亮屏/熄屏消息,从而执行一些命令,resume表示亮屏时执行的命令,pause表示熄屏时执行的命令--> <Trigger action=""> <Command target="" value=""/> </Trigger> </ExternalCommands>
参 数 | 类 型 | 选 项 | 注 释 |
|---|---|---|---|
command | 字符串 | 必填 | 命令名,目前可以使用的一种命令是解锁命令unlock(仅在锁屏中有效) |
condition | 表达式 | 选填 | 条件判断该Command是否执行,支持表达式。仅当值为非0或者为true时,该命令执行。为false或者0则不执行 |
delay | 数值 | 选填 | 延迟,单位ms。延迟delay毫秒后执行该命令 |
delayCondition | 表达式 | 选填 | 延迟判断,为真则delay命令生效,否则失效。默认为true或者1时,表示可以延迟启动命令,如果false或者非1则不延迟执行 |
示例一:解锁命令,执行该命令能够直接解锁锁屏。
<ExternCommand command="unlock"/>
示例二:在锁屏中,接收开屏/关屏命令,从而执行一些命令;在桌面插件中,用来检测切屏从而执行命令resume表示开屏时执行的命令,pause表示关屏时执行的命令。该示例在接受开屏信号之后,将name等于target的组件的动画启动,在关屏了之后,将目前的时间记录在pause_time变量里面。
<ExternalCommands> <Trigger action="resume"> <Command target="target.animation" value="play"/> </Trigger> <Trigger action="pause"> <VariableCommand name="pause_time" expression="#time_sys"/> </Trigger> </ExternalCommands>