动态引擎锁屏教程v3.0脚本语法兼容

1、【18:9 兼容性更新】新引擎可以兼容老，写前按照以下几个步骤判断一下：1 、新引擎支持多比例的壁纸图，会优先使用比例接近的，例如资源里面可以放default_lock_wallpdefault_lock_wallpr_18_9.jpg、default_lock_wallpr_16_10.jpg、r.jpg 等，18：9 的机器会优先找default_lock_wallpr_18_9.jpg，没有就找 default_lock_wallp版本r.jpg，这样只需要一套就能兼容各种比例的机器和老2、老只有 default_lock_wallp裁剪两边r.jpg，是 16：9 的，新引擎也能跑，会

2、把它拉长，3、如果光改壁纸不能满足需求，可以在资源中放多个，例如 18_9_manifest.xml、16_10_manifest_105.xml、manifest.xml，新引擎会根据屏幕比例选择比例接近的9 的机器会跑 18_9_manifest.xml，18：4 、中不使用 display_width 和 display_height ， 还是使用 screen_width 和screen_height16：9 的壁纸在新引擎中效果还可以的就不用添加 18：9 的，添加壁纸能解决的就没必要写多个 xml 了，上半区域的元素尽量用顶对齐，下半区域的尽量用底对齐所有必须兼容 18：9 屏幕，

3、需要在 unlock 里面的 xml 里面加上：manifest.xml 文件是描述frameRate： 指定帧率，如果动画缓慢，可以指定小一点的值，省电。默认为 30。 screenWidth： 设定屏幕宽度标准。如果指定为 720,锁屏中所有元素的位置都按 720p 的布局编写，1080p、480p 等分辨率机会自动进行缩放。壁纸元素Wallpr 元素系统设置的壁纸，除了不能指定源外其他和 Image 元素相同，可以有动画和其他属性控制。如果没有此元素则不显示壁纸。可以有多个。 例子： 变量变量expresexpres变量对应的表达式或常量 注意：如果定义字符串常量需要多一套单引号:=my

4、 stringtype= number/string 定义数值变量或字符串变量 默认：numberthreshold 阈值触发，当变量值的变化超过设定的阈值时，可以触发一些命令。例如：Var name=time3expres=#minute%10 threshold=1d d d dd=time3_anim.visibility value=true/=time3_anim.animation value=play/=time3_anim_new.visibility=time_3_anim_new.visiblity=time_3_anim_new.animationvalue=false/

5、value=truevalue=playdelay=400/delay=400/上述代码表示#time3 的值每变化 1，就会执行里面的所有命令变量数组变量数组/ 显示英文月份ItemItem.ItemItemvalue=January/value=February/value=November/value=December/全局变量 unlocker: unlocker.move_x unlocker.move_yunlocker.move_dist在x 方向的偏移在y 方向的偏移移动的距离的状态： 0 normal, 1 pressed, 2 reachedunlocker.setouch

6、：touch_x 当前触摸点的 x 坐标touch_ytouch_begin_x 按下屏幕时的初始 x 坐标touch_begin_ytouch_begin_time 按下屏幕时的时间time:time 当前时间，long time_sys 系统时间毫秒数 year 年份month 月份（取值范围是 011，0 表示一月，1 表示二月，以此类推）date 日期day_of_k（1 表示日，2 表示一，等等）hour 当前小时minute 分钟second 秒battery:battery_level当前电量，11000 正常 1 充电 2 电量低 3 已充满battery_sscreen:es

7、creen_width 屏幕宽度screen_height 屏幕高度image: image.actual_w image.actual_himage.bmp_width实际宽度文件的宽度（不受裁切、缩放的影响，只根据 src 找到指定的，并检测该文件的宽度）image.bmp_heightmusic:music_control.music_se 0 暂停 1others: sms_unread_count 未读call_missed_count 未接数数表达式支持加减乘除取模括号和函数加减乘除取模 : + - * / %支持函数:sin, cos, tan, asin, acos, atan

8、, sqrt, abs, min, maxdigit(数字, 第几位) 取给定数字的第几位 digit(12345, 2) = 4 注意：下标从右向左，并且从 1 开始round() 四舍五入取整()向下取整rand() 取 0 到 1 之间的随机数(rand()*a+b) 取到的是 b 到 b+a 之间的整数eq(x,ne(x,ge(x,gt(x,le(x,lt(x,y)y)y)y)y)y)/x=yx!=y x=y?111:000 xy ? 1 : 0 x=y ? 1 : 0 x0 ?ifelse(x, y,x=null ?1 :0/ 是否表达式包含空变量，通常用于判断绑定的变量是否0 :

9、1z) /x0y2,? y.:,zz)ifelse(x1, y1, x2,if x10 return y1;else ifx20 return y2; . ; else return z元素可见性支持表达式 visibility=“表达式” 0 可见Image, Text, align= left, alignV= top,文本Time 的属性center, right 坐标点水平对齐方式center, bottom 坐标点垂直对齐方式显示指定格式的文字，坐标属性支持变量color： 文字颜色，# size: 文字大小format： 如果需要在文字中显示变量数字，需要指定格式, 用%d 指定数

10、字位置paras: 如果指定了 format, 需要在 paras 里指定%d 对应的变量表达式, 可以有多个变量表达式用, 隔开align： left, center, right，文字坐标的对齐方式textExp: 文字表达式，可以直接调用变量等如想要输出“现在时间是 9 点”，可以写成textExp=现在时间是+#hour12+点width 文字宽度,当文字超过指定宽度时会被切掉。如果指定了多行显示，则会折行显示。如果指定了文字滚动，则会在指定的位置滚动显示文字textExp 属性支持字符串表达式：*天气信息，如果温度为空显示- 非空显示数值时间src 表示时间的前缀，如下表示使用 ti

11、me_0.png,time_dot.png. 坐标属性支持变量表达式time_1.png,.time_9.png,日期显示指定格式的日期format: 支持标准日期格式年：y 或者 yyy 或者 yyyy -数字年，2015 yy -2 位数年，15月：M - 9MM - 09 MMM - 九日：- 一年中的第几天，189 d - 数字日，23农历：NNNN - 农历：- 周三EEEE - EEEEE - 三小时：三H Kkh-24 小时制，02312 小时制，01124 小时制，12412 小时制，112分钟：m - 7mm - 07mmm - 007mmmm - 0007秒钟：s - 6s

12、s - 07sss - 007ssss - 0007例子：用来在锁屏界面上显示一个，可以指定各种属性x,y 相对于屏幕左上角的坐标w,h 宽和高pivotX, pivotY 旋转中心roion 旋转角度，一周 360 度ion= src= srcid= alpha=srcsrcid名称序列后缀数字，一般用变量表示，可以根据变量显示不同的，如果src=pic.png srcid=1 则最后会显示pic_1.pngalpha align/alignV例子:.数字 number 是要显示的数字表达式src 是源的文件名，支持 SourceAnimation如果 src=numb类似 Timeng 则

13、会使用 number_0.png number_1.png .文件来绘制数字。元素动画所有元素都支持动画动画分为：源，位置，大小，旋转，每种动画相互独立，各自循环，动画由若干关键帧组成，关键帧包括帧属性和时间，除源动画外，其它动画会根据当前时间找到相邻的两个关键帧，然后线性插值计算当前的属性。 如果第一帧时间不从 0 开始，则默认时间为 0 的第一帧为原始属性,时间为毫秒。 位置动画中的位置是相对于自身的坐标。 ition x=100 y=200 time=1000/itionAnimation/RoRoRoion angle= time=/ ion angle= time=/ ionAnim

14、ation例子：位置动画表示 1 秒从屏幕最左端到最右端，停留 1 秒，动画表示开始为175，在从最左端到最右端过程中不变，到达最右端后 0.5 秒渐变为不透明，然后 0.5秒变为透明。 然后循环。 ition x=480 y=0 time=2000/itionAnimation/AlphaAlphaAlpha time=1000/time=1500/a=0 time=2000/注意：只有支持源动画源动画稍有不同，没有插值，x, y 可选，表示相对里的找到第一个大于当前时间的那个点指定的的位置， 当前的是在列表Source x= y=Source x= y= Groupsrc=pic1.png

15、src=pic2.pngtime=100/time=1000/Group name= x=y= w= h=frameRate=0Group 是组的意思，相当于控件们的一个容器，可以用来包含住其他元素，比如，时间等等。 通过给组添加坐标和宽高，可以便捷地调整多个元素的位置和大小。 同时Group 还能添加各种动画，种类与 Image 一样全面Slidername: 名字，用来做变量名bounceInitSpeed, bounceAcceleration 回弹动画初始速度和加速度(距离为秒)，都支持表达式为像素，时间可以有任意个 Slider。Trigger Slider 的状态切换时，支持 Tr

16、igger 触发规则：当起始点（StartPo开手指即可以产生触发）的 x,y 点随手指移动落入 EndPo目标区域矩形时，此时松Slider 起始点：起始点中包含的元素都会跟随当前操作的拖动移动位置。NormalSe/从其他状态切换到 NormalSe 时，触发该 Triggerd=test_trigger.visibility value=false/从其他状态切换到 PressedSe 时，触发该 Triggere/从其他状态切换到 ReachedSe 时，触发该 Trigger -mand sound=reached.mp3 volume=1/三个状态都可以不指定，可以使用变量来改变其

17、他界面元素状态来表示触发过程。Slider 目标点：当起始点的 x,y 点落入 EndPo目标区域矩形时，达到触发位置，此时松开手指即可以产生触发，可以有多个触发目的。NormalSe!- showPressedSition if pressed trying to unlock-e!- show specified image when reached, if touch up then perform unlock-Pathition x= y= / ition x= y= /例子:Path ition x=31 y=0 /ition x=359 y=0 /EndPo Slider 的en

18、t 也可以为 Trigger 和d，一个 Trigger 可以有多个d。Trigger和d 请见 Trigger &dUnlocker 继承 Slider，以上用法只需把 tag 名的 Slider 改为 Unlocker.锁屏音效StartPo: normalSound, pressedSound ,指定在 normal 和 press 状态的音效EndPo: reachedSound, 到达该 endpo后的音效按钮按钮元素可以用来接收点击，双击等事件，并可根据 trigger 的定义来控制界面上其他元素。按钮元素也可以将事件传递给界面上其他元素，来使其他元素响应用户在锁屏界面上的操作。所

19、有元素增加 name 属性，按钮的控制对象通过 name 来指定。x, y, w, h 指定了按钮区域。一个 Button 可以有若干个 trigger，trigger 定义了按钮动作相关的操作，如控制某元素的属性action: 按钮动作： down (按下), up (抬起), double (双击): 控制目标名property: 属性名，目前支持：visibility 以后会增加其他属性控制。value: 属性值，目前针对有: true, false, toggle通常用 button 控制的目标有三类，分别是可见性控制，动画，以及执行命令，简单演示：Triggerdd=test.vis

20、ibility value=true/false=test.animation value=playmand name=test1 expres=0关于命令在后面会有详细的介绍Button 元素的 xml 结构：.Trigger &dd基础命令，可以通过对象名和对象的属性来控制界面里的其他元素。通常控制的是元素的可见性（visibility）和动画（animation）。iamge1 是被控制对象的名字，“.”后面跟的是属性（目前支持 visibility 和 animation）。控制可见性的时候，value 里面写 true 或者 false，控制动画的时候，value 写 play（目前不支持让动画暂停）condition 是条件判断，支持表达式。当 condition 里的条件判断为真时，执行命令；为假时，不执行。delay 是延迟，以毫秒记。该命令后延迟一段时间再执行delayCondition 是延时判断，在 delay 的时间之后再进行判断。例子：/ second40 时，延时 2000ms 执行/ 延时 6000ms 后，如果 second40，执行/ second40 时，延时 4000ms，此时如果 second40，执行mand变量命令，用来控制变量（Var）的值。包括 name 和expr