二次开发函数说明文档
登录后方可查看函数详细说明文档。
该文档用于价签二次开发使用,主要记录函数功能、参数,及用法,方便开发者查阅。
注意事项:所有函数不需要有空格,所有函数不需要分号结尾,每条函数以换行符结尾,字符串使用单引号括起来。
字符串不能使用特殊字符。
变量说明
在做二次开发的时候,有时候需要使用到一些设备的内置变量,变量可以以数字的形式改变内容的坐标,也可以以字符串的形式显示出来。
这里规定,所有的变量用大括弧"{}"括起来。括起来的部分为一个变量,其中变量也可以进行简单的计算。
数字变量
- {y}:返回当前年份变量,比如当前是2025年,则返回变量2025。
- {m}:返回当前月份变量,比如当前是5月,则返回变量5。
- {d}:返回当前日期变量,比如当前是15日,则返回变量15。
- {H}:返回当前小时变量,比如当前是10点,则返回变量10。
- {N}:返回当前分钟变量,比如当前是50分,则返回变量50。
- {S}:返回当前秒变量,比如当前是30秒,则返回变量30。
- {Z}:返回当前时区变量,比如当前北京时间,则返回当前的时区8,取值范围为-12~12。
- {b}/{B}:返回电池电压的ADC值,取值范围为0~2046。其中2046为3.6V。0为0V,实际上在2.0V的时候,设备已经无法正常工作。
- {c}:返回当前墨水屏温度的ADC的值。
- {C}:返回当前墨水屏温度的变量值,实际上为温度ADC/16的值。
- 其他的待程序版本升级后补充
字符串变量
- {mac}:返回当前设备的MAC地址的后六位,小写表示(xxxxxx)
- {MAC}:返回当前设备的MAC地址,大写表示,并用分号间隔(XX:XX:XX:XX:XX:XX)
- {VER}:返回当前设备的版本号,如1.29
- {GKD}:返回距离下一个高考的天数的字符串,如“距高考xx天”
- {GKd}:返回距离下一个高考的天数,如“xx”
- {ls}:返回当前日期阴历年的天干数据
- {lb}:返回当前日期阴历年的地支数据
- {ly}:返回当前日期阴历年的属相
- {lm}:返回当前日期阴历月份,如“正月”
- {ld}:返回当前日期阴历日,如“初一”
- {lT}:返回距离下一个节气的字符串数据,如“距冬至还有xx天”
- {hxn}:与倒计时有关,可以是生日或者节日,如果倒计时为未来的时间,到时间时间可以超过365天
- 目前倒计时最多支持8条
- x可取数据为:t、T、a、A、n、N、m、M、d、D,
大写与小写含义相同,
区别为:大写按照存储顺序取数据,小写按照距离的天数重新排序取数据
- t、T:代表姓名
- a、A:代表年龄
- n、N:代表距离天数
- m、M:代表设置的月份
- d、D:代表设置的日期
-
n为序号,从1开始,可以取1~8。
- {y}:返回当前日期的年,如2025
- {m}:返回当前日期的月,如05
- {d}:返回当前日期的日,如15
- {H}:返回当前时间的小时,如10
- {N}:返回当前时间的分钟,如50
- {w}:返回当前星期编号,0代表星期日,1代表星期一,以此类推
- {W}:返回当前星期,如“日”、“五”
- {b}:返回当前电池电压的ADC值,取值范围为0~2046。其中2046为3.6V。0为0V,实际上在2.0V的时候,设备已经无法正常工作。
- {B}:返回当前电池电压,取值范围为0~3.6V。
- {c}:返回当前电墨水屏温度值。比如当前温度为20度,则返回20。
- {C}:返回当前电墨水屏温度值,小数点后面有两位数字。比如当前温度为20.22度,则返回20.22。
- {z}:返回当前时区。取值范围为-12~12。默认为北京时区,返回为8。
函数列表
4.2寸专用函数列表