目录

通用命令<ExternCommand>

功能概述

通用命令ExternCommand,用来向外部程序发送命令,目前仅能够支持解锁命令(仅在锁屏中有效),用这个命令可以实现解锁操作。

ExternalCommand,与ExternCommand相对,是用来接收外部的命令。ExternalCommand是一种特殊的Command,不集成在<Trigger>标签之下,而是直接写在<Lockscreen>标签之下,作为监测开关屏的命令。

XML规范

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>