sunmiT2Screen

来自于：开发者立即使用

screenInit showWelcome showText showMenu showImg showImgs showVideo showVideos imageLists videoLists imagesLists videosLists exitScreen cachefile

概述

这是双屏异显功能，副屏可以显示不同于主屏的内容，可用来向用户展示广告，视频，图片，购物订单等内容

注意

使用该模块时需要使用升级后的编译环境，请在云编译的时候勾选“使用升级环境编译”，并且在控制台 “高级设置” 中将固件版本设置为4.4或以上

screenInit

初始化副屏

screenInit(callback(ret, err))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.screenInit(function(ret, err) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android系统

可提供的1.0.0及更高版本

showWelcome

显示欢迎

showWelcome(callback(ret, err))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.showWelcome(function(ret, err) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android系统

可提供的1.0.0及更高版本

showText

显示文本

showText({params},callback(ret, err))

params

title： content:

  • 类型：字符串
  • 描述：（必填项）显示数据
  • 字段：
  1. title:'金额',//显示的标题
  2. content:'￥18.5'//显示的内容

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.showText({
  3. title:'金额',
  4. content:'￥18.5'
  5. },function(ret, err) {
  6.     alert(JSON.stringify(ret));
  7. });

可用性

Android系统

可提供的1.0.0及更高版本

showMenu

显示清单

showMenu({params}, callback(ret, err))

params

json：

  • 类型：JSON 对象
  • 描述：（必填项）显示数据
  • 内部字段：
  1. {
  2.         "title": "本小店欢迎你",//显示店名
  3.         "head": {
  4.             "param1": "序列号",//显示商品列表表头序列号
  5.             "param2": "商品名",//显示商品列表表头商品名
  6.             "param3": "单价",//显示商品列表表头单价
  7.             "param4": "数量",//显示商品列表表头数量
  8.             "param5": "小结"//显示商品列表表头小结
  9.         },
  10.         "list": [
  11.             {
  12.               "param1": "0",//显示第一个商品的序号
  13.               "param2": "华夫饼",//显示第一个商品名称
  14.               "param3": "10.00",//显示第一个商品价格
  15.               "param4": "1",//显示第一个商品数量
  16.               "param5":"10.00"//显示第一个商品总价
  17.             },
  18.             {
  19.               "param1": "1",//显示第二个商品的序号
  20.               "param2": "吞拿鱼华夫饼",//显示第二个商品名称
  21.               "param3": "12.00",//显示第二个商品价格
  22.               "param4": "1",//显示第二个商品数量
  23.              "param5":"12.00"//显示第二个商品总价
  24.             }
  25.         ],
  26.         "KVPList": [
  27.             {
  28.                 "name": "收款",//表格底部显示收款
  29.                 "value": "￥40.00"//表格底部显示收款总价
  30.             },
  31.            {
  32.                 "name": "优惠",//表格底部显示优惠
  33.                 "value": "￥3.00"//表格底部显示优惠金额
  34.             },
  35.            {
  36.                 "name": "找零",//表格底部显示找零
  37.                 "value": "￥3.00"//表格底部显示找零金额
  38.             },
  39.            {
  40.                 "name": "实收",//表格底部显示实收
  41.                 "value": "￥37.00"//表格底部显示实收金额
  42.             }
  43.         ]
  44. };

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：result 为返回结果各参数可参考以上参数
  1. {
  2.     status: true, //false
  4. }

示例代码

  1. var obj = api.require('sunmiT2Screen');
  2. demo.showMenu({
  3.             json:{
  4.         "title": "本小店欢迎你",
  5.         "head": {
  6.             "param1": "序列号",
  7.             "param2": "商品名",
  8.             "param3": "单价",
  9.             "param4": "数量",
  10.             "param5": "小结"
  11.         },
  12.         "list": [
  13.             {
  14.               "param1": "1",
  15.               "param2": "华夫饼",
  16.               "param3": "10.00",
  17.               "param4": "1",
  18.              "param5":"10.00"
  19.             },
  20.             {
  21.               "param1": "1",
  22.               "param2": "吞拿鱼华夫饼",
  23.               "param3": "12.00",
  24.               "param4": "1",
  25.              "param5":"12.00"
  26.             }
  27.         ],
  28.         "KVPList": [
  29.             {
  30.                 "name": "收款",
  31.                 "value": "￥40.00"
  32.             },
  33.             {
  34.                 "name": "优惠",
  35.                 "value": "￥3.00"
  36.             },
  37.            {
  38.                 "name": "找零",
  39.                 "value": "￥3.00"
  40.             },
  41.            {
  42.                 "name": "实收",
  43.                 "value": "￥37.00"
  44.             }
  45.         ]
  46. };
  47.             },function(ret){
  48.             alert(JSON.stringify(ret));
  49.             });

可用性

Android系统

可提供的1.0.0及更高版本

showImg

显示图片

showImg({params},callback(ret, err))

params

img：

  • 类型：String
  • 描述：（必填项）显示数据

  • 内部字段：

    1. img:显示图片本地路径

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.showImg({
  3. img:"widget://image/img_06.png"
  4. },function(ret, err) {
  5.     alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本

showImgs

显示轮播图片

showImgs({params},callback(ret, err))

params

imgs： rotation_time：

  • 类型：String数组和Long类型
  • 描述：（必填项）显示数据

  • 内部字段：

    1. imgs:显示图片本地路径的数组
    2. rotation_time：轮播时间间隔

    callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.showImgs({
  3.              imgs:[
  4.                      "widget://image/img_06.png",
  5.                      "widget://image/img_04.png",
  6.                      "widget://image/img_02.png"
  7.                 ],
  8.                 rotation_time:3000
  9.             },function(ret){
  10.                 alert(JSON.stringify(ret));
  11.             });

可用性

Android系统

可提供的1.0.0及更高版本

showVideo

显示单个视频

showVideo({params},callback(ret, err))

params

PathVideo:

  • 类型：String类型
  • 描述：（必填项）显示数据

  • 内部字段：

    1. pathVideo:显示视频本地路径

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.showVideo(
  3.      {
  4.      pathVideo:"widget://image/video_03.mp4",
  5.     },function(ret){
  6.     alert(JSON.stringify(ret));
  7.       });

可用性

Android系统

可提供的1.0.0及更高版本

showVideos

显示轮播视频

showVideos({params},callback(ret, err))

params

videos:

  • 类型：String数组类型
  • 描述：（必填项）显示数据

  • 内部字段：

    1. videos:显示视频本地路径的数组

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2.  demo.showVideos({
  3.             videos:[
  4.                      "widget://image/video_03.mp4",
  5.                      "widget://image/video_02.mp4",
  6.                      "widget://image/video_01.mp4"
  7.                 ],
  8.             },function(ret){
  9.                 alert(JSON.stringify(ret));
  10.             });

可用性

Android系统

可提供的1.0.0及更高版本

imageLists

显示单个图片清单

imageLists((params),callback(ret, err))

params

json: img:

  • 类型：String类型和json对象
  • 描述：（必填项）显示数据

  • 内部字段：

    1. json:和显示清单一样
    2. img:显示图片本地路径

    callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2.  demo.imageLists({
  3.             json:{
  4.         "title": "本小店欢迎你",
  5.         "head": {
  6.             "param1": "序列号",
  7.             "param2": "商品名",
  8.             "param3": "单价",
  9.             "param4": "数量",
  10.             "param5": "小结"
  11.         },
  12.         "list": [
  13.             {
  14.               "param1": "1",
  15.               "param2": "华夫饼",
  16.               "param3": "10.00",
  17.               "param4": "1",
  18.              "param5":"10.00"
  19.             },
  20.             {
  21.               "param1": "1",
  22.               "param2": "吞拿鱼华夫饼",
  23.               "param3": "12.00",
  24.               "param4": "1",
  25.              "param5":"12.00"
  26.             }
  27.         ],
  28.         "KVPList": [
  29.             {
  30.                 "name": "收款",
  31.                 "value": "￥40.00"
  32.             },
  33.             {
  34.                 "name": "优惠",
  35.                 "value": "￥3.00"
  36.             },
  37.            {
  38.                 "name": "找零",
  39.                 "value": "￥3.00"
  40.             },
  41.            {
  42.                 "name": "实收",
  43.                 "value": "￥37.00"
  44.             }
  45.         ]
  46. },
  47.             img:"widget://image/img_03.png"
  48.             },function(ret){
  49.                 alert(JSON.stringify(ret));
  50.             });

可用性

Android系统

可提供的1.0.0及更高版本

videoLists

显示单个视频清单

videoLists((parames),callback(ret, err))

parames

json: video:

  • 类型：String类型和json对象
  • 描述：（必填项）显示数据

  • 内部字段：

    1. json:和显示清单一样
    2. video:显示视频本地路径

    callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2.  demo.videoLists({
  3.             json:{
  4.         "title": "本小店欢迎你",
  5.         "head": {
  6.             "param1": "序列号",
  7.             "param2": "商品名",
  8.             "param3": "单价",
  9.             "param4": "数量",
  10.             "param5": "小结"
  11.         },
  12.         "list": [
  13.             {
  14.               "param1": "1",
  15.               "param2": "华夫饼",
  16.               "param3": "10.00",
  17.               "param4": "1",
  18.              "param5":"10.00"
  19.             },
  20.             {
  21.               "param1": "1",
  22.               "param2": "吞拿鱼华夫饼",
  23.               "param3": "12.00",
  24.               "param4": "1",
  25.              "param5":"12.00"
  26.             }
  27.         ],
  28.         "KVPList": [
  29.             {
  30.                 "name": "收款",
  31.                 "value": "￥40.00"
  32.             },
  33.             {
  34.                 "name": "优惠",
  35.                 "value": "￥3.00"
  36.             },
  37.            {
  38.                 "name": "找零",
  39.                 "value": "￥3.00"
  40.             },
  41.            {
  42.                 "name": "实收",
  43.                 "value": "￥37.00"
  44.             }
  45.         ]
  46. },
  47.             video:"widget://image/video_02.mp4",
  48.             },function(ret){
  49.             alert(JSON.stringify(ret));
  50.             });

可用性

Android系统

可提供的1.0.0及更高版本

imagesLists

显示轮播图清单

imagesLists((parames),callback(ret, err))

parames

json: imgs: rotation_time:

  • 类型：String数组类型和json对象,long类型
  • 描述：（必填项）显示数据

  • 内部字段：

    1. json:和显示清单一样
    2. imgs:显示图片数组本地路径
    3. rotation_time：轮播图切换的时间

    callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false
  4. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.imagesLists({
  3.             json:{
  4.         "title": "本小店欢迎你",
  5.         "head": {
  6.             "param1": "序列号",
  7.             "param2": "商品名",
  8.             "param3": "单价",
  9.             "param4": "数量",
  10.             "param5": "小结"
  11.         },
  12.         "list": [
  13.             {
  14.               "param1": "1",
  15.               "param2": "华夫饼",
  16.               "param3": "10.00",
  17.               "param4": "1",
  18.              "param5":"10.00"
  19.             },
  20.             {
  21.               "param1": "1",
  22.               "param2": "吞拿鱼华夫饼",
  23.               "param3": "12.00",
  24.               "param4": "1",
  25.              "param5":"12.00"
  26.             }
  27.         ],
  28.         "KVPList": [
  29.             {
  30.                 "name": "收款",
  31.                 "value": "￥40.00"
  32.             },
  33.             {
  34.                 "name": "优惠",
  35.                 "value": "￥3.00"
  36.             },
  37.            {
  38.                 "name": "找零",
  39.                 "value": "￥3.00"
  40.             },
  41.            {
  42.                 "name": "实收",
  43.                 "value": "￥37.00"
  44.             }
  45.         ]
  46. },
  47.             imgs:[
  48.                      "widget://image/img_06.png",
  49.                      "widget://image/img_04.png",
  50.                      "widget://image/img_02.png"
  51.                 ],
  52.             rotation_time:2000
  53.             },function(ret){
  54.                 alert(JSON.stringify(ret));
  55.             });

可用性

Android系统

可提供的1.0.0及更高版本

videosLists

显示轮播视频清单

videosLists((params),callback(ret, err))

parames

json: videos:

  • 类型：String数组类型和json对象
  • 描述：（必填项）显示数据

  • 内部字段：

    1. json:和显示清单一样
    2. videos:显示视频数组本地路径

    callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true, //false  
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2.  demo.videosLists({
  3.             videos:[
  4.                      "widget://image/video_03.mp4",
  5.                      "widget://image/video_02.mp4",
  6.                      "widget://image/video_01.mp4"
  7.                 ],
  8.             json:{
  9.         "title": "本小店欢迎你",
  10.         "head": {
  11.             "param1": "序列号",
  12.             "param2": "商品名",
  13.             "param3": "单价",
  14.             "param4": "数量",
  15.             "param5": "小结"
  16.         },
  17.         "list": [
  18.             {
  19.               "param1": "1",
  20.               "param2": "华夫饼",
  21.               "param3": "10.00",
  22.               "param4": "1",
  23.              "param5":"10.00"
  24.             },
  25.             {
  26.               "param1": "1",
  27.               "param2": "吞拿鱼华夫饼",
  28.               "param3": "12.00",
  29.               "param4": "1",
  30.              "param5":"12.00"
  31.             }
  32.         ],
  33.         "KVPList": [
  34.             {
  35.                 "name": "收款",
  36.                 "value": "￥40.00"
  37.             },
  38.             {
  39.                 "name": "优惠",
  40.                 "value": "￥3.00"
  41.             },
  42.            {
  43.                 "name": "找零",
  44.                 "value": "￥3.00"
  45.             },
  46.            {
  47.                 "name": "实收",
  48.                 "value": "￥37.00"
  49.             }
  50.         ]
  51. }
  52.             },function(ret){
  53.                 alert(JSON.stringify(ret));
  54.             });

可用性

Android系统

可提供的1.0.0及更高版本

exitScreen

退出副屏

exitScreen(callback(ret, err))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true 
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.exitScreen(function(ret, err) {
  3.     alert(JSON.stringify(ret));
  4. });

可用性

Android系统

可提供的1.0.0及更高版本

cachefile

清除缓存

cachefile(callback(ret, err))

callback(ret)

ret：

  • 类型：JSON对象
  • 内部字段：status 布尔型
  1. {
  2.     status: true 
  3. }

示例代码

  1. var demo = api.require('sunmiT2Screen');
  2. demo.cachefile(function(ret){
  3.      alert(JSON.stringify(ret));
  4.         });

可用性

Android系统

可提供的1.0.0及更高版本