sunmiT1Screen

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

概述

商米科技

上海商米科技有限公司是一家专注为O2O互联网平台，软件开发商、中小型商户提供专业的、高性价比的智能商用硬件设备的创新型科技企业。商米硬件设备

目前商米主推的智能商用硬件包括 V1 ， T1 ， P1 ， M1 ，D1 。设备应用于包括外卖接单，打印小票，扫描，收款，团购核销，点餐预约等一系列商业场景。

SUNMI OS商米设备运行的是SUNMIUI系统，SUNMIUI是基于Android深度优化改良的操作系统，支持安装普通基于Android系统的app，专为智能商用场景深度定制，从操作体验、性能提升与产品外观设计内外呼应，相得益彰。让用户在使用硬件的同时能享受更加专业系统的软件服务体验。 T1是一款面向互联网环境商业场景的多功能一体机，广泛应用于零售、餐饮。 sunmiT1Screen 是双屏异显功能，副屏可以显示不同于主屏的内容，可用来向用户展示广告，视频，图片，购物订单等内容。

官方文档:https://docs.sunmi.com/htmls/index.html?lang=zh##T1%E6%96%87%E6%A1%A3%E8%B5%84%E6%BA%90

注意

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

#screenInit 初始化副屏 screenInit(callback(ret, err)) ##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.screenInit(function(ret, err) {
    alert(JSON.stringify(ret));
});

##可用性 Android系统可提供的1.0.0及更高版本

#showWelcome 显示欢迎 showWelcome(callback(ret, err)) ##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.showWelcome(function(ret, err) {
    alert(JSON.stringify(ret));
});

##可用性 Android系统可提供的1.0.0及更高版本

#showText 显示文本 showText({params},callback(ret, err)) ##params title： content: - 类型：字符串 - 描述：（必填项）显示数据 - 字段：

js
title:'金额',//显示的标题
content:'￥18.5'//显示的内容

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.showText({
title:'金额',
content:'￥18.5'
},function(ret, err) {
    alert(JSON.stringify(ret));
});

##可用性 Android系统可提供的1.0.0及更高版本

#showMenu 显示清单 showMenu({params}, callback(ret, err)) ##params json： - 类型：JSON 对象 - 描述：（必填项）显示数据 - 内部字段：

js
{
        "title": "三米奶茶店欢迎您",
        "head": {
            "param1": "序列号",
            "param2": "商品名",
            "param3": "单价",
            "param4": "数量",
            "param5": "小结"
        },
        "list": [
            {
              "param1": "1",
              "param2": "华夫饼",
              "param3": "10.00",
              "param4": "1",
             "param5":"10.00"
            },
            {
              "param1": "1",
              "param2": "吞拿鱼华夫饼",
              "param3": "12.00",
              "param4": "1",
             "param5":"12.00"
            }
        ],
        "KVPList": [
            {
                "name": "收款",
                "value": "￥40.00"
            },
            {
                "name": "优惠",
                "value": "￥3.00"
            },
           {
                "name": "找零",
                "value": "￥3.00"
            },
           {
                "name": "实收",
                "value": "￥37.00"
            }
        ]
};

##callback(ret) ret： - 类型：JSON对象 - 内部字段：result 为返回结果各参数可参考以上参数

js
{
    status: true, //false

}

##示例代码

js
var obj = api.require('sunmiT1Screen');
demo.showMenu({
            json:{
                 "title": "三米奶茶店欢迎您",
                 "head": {
                     "param1": "序列号",
                     "param2": "商品名",
                     "param3": "单价",
                     "param4": "数量",
                     "param5": "小结"
                 },
                 "list": [
                     {
                       "param1": "1",
                       "param2": "华夫饼",
                       "param3": "10.00",
                       "param4": "1",
                      "param5":"10.00"
                     },
                     {
                       "param1": "1",
                       "param2": "吞拿鱼华夫饼",
                       "param3": "12.00",
                       "param4": "1",
                      "param5":"12.00"
                     }
                 ],
                 "KVPList": [
                     {
                         "name": "收款",
                         "value": "￥40.00"
                     },
                     {
                         "name": "优惠",
                         "value": "￥3.00"
                     },
                    {
                         "name": "找零",
                         "value": "￥3.00"
                     },
                    {
                         "name": "实收",
                         "value": "￥37.00"
                     }
                 ]
            }
            },function(ret){
            alert(JSON.stringify(ret));
            });

##可用性 Android系统可提供的1.0.0及更高版本

#showWXpay 微信支付 showWXpay({params},callback(ret, err)) ##params title： img： content： - 类型：String - 描述：（必填项）显示数据 - 内部字段：

js
imgs:'widget://image/qrcode.png',//显示的图片路径
title:'微信支付',//显示的标题
content:'20'//显示的内容

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.showWXpay({
imgs:"widget://image/qrcode.png",
title:'微信支付',
content:'20'
},function(ret) {
    alert(JSON.stringify(ret));
});

##可用性 Android系统可提供的1.0.0及更高版本

#showImg 显示图片 showImg({params},callback(ret, err)) ##params imgKey： img： - 类型：String - 描述：（必填项）显示数据 - 内部字段：

js
imgKey:在SharedPreferences中存储图片路径的key
img:显示图片本地路径

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.showImg({
imgKey:'imgkey',
img:"widget://image/img_06.png"
},function(ret, err) {
    alert(JSON.stringify(ret));
});

##可用性 Android系统可提供的1.0.0及更高版本

#showImgs 显示轮播图片 showImgs({params},callback(ret, err)) ##params imgsKey： imgs： rotation_time： - 类型：String数组和Long类型 - 描述：（必填项）显示数据 - 内部字段：

js
imgsKey:在SharedPreferences中存储图片路径数组的key
imgs:显示图片本地路径的数组
rotation_time：轮播时间间隔

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.showImgs({
            imgsKey:'imgskey',
            imgs:[
                 "widget://image/img_06.png",
                 "widget://image/img_04.png",
                 "widget://image/img_02.png"
            ],
            rotation_time:3000
            },function(ret){
                alert(JSON.stringify(ret));
            });

##可用性 Android系统可提供的1.0.0及更高版本

#showVideo 显示单个视频 showVideo({params},callback(ret, err)) ##params videosKey: PathVideo: - 类型：String类型 - 描述：（必填项）显示数据 - 内部字段：

js
videosKey:在SharedPreferences中存储视频路径的key
pathVideo:显示视频本地路径

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
demo.showVideo(
     {
     videoKey:'videokey'
     pathVideo:"widget://image/video_03.mp4",
    },function(ret){
    alert(JSON.stringify(ret));
      });

##可用性 Android系统可提供的1.0.0及更高版本

#showVideos 显示轮播视频 showVideos({params},callback(ret, err)) ##params videosKey: videos: - 类型：String数组类型 - 描述：（必填项）显示数据 - 内部字段：

js
videosKey:在SharedPreferences中存储视频路径数组的key
videos:显示视频本地路径的数组

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
 demo.showVideos({
            videosKey:'videoskey'
            videos:[
                     "widget://image/video_03.mp4",
                     "widget://image/video_02.mp4",
                     "widget://image/video_01.mp4"
                ],
            },function(ret){
                alert(JSON.stringify(ret));
            });

##可用性 Android系统可提供的1.0.0及更高版本

#imageLists 显示单个图片清单 imageLists((params),callback(ret, err)) ##params imgMenuKey: json: img: - 类型：String类型和json对象 - 描述：（必填项）显示数据 - 内部字段：

js
imgMenuKey:在SharedPreferences中存储图片路径的key
json:和显示清单一样
img:显示图片本地路径

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
 demo.imageLists({
            json:{
                     "title": "三米奶茶店欢迎您",
                     "head": {
                         "param1": "序列号",
                         "param2": "商品名",
                         "param3": "单价",
                         "param4": "数量",
                         "param5": "小结"
                     },
                     "list": [
                         {
                           "param1": "1",
                           "param2": "华夫饼",
                           "param3": "10.00",
                           "param4": "1",
                          "param5":"10.00"
                         },
                         {
                           "param1": "1",
                           "param2": "吞拿鱼华夫饼",
                           "param3": "12.00",
                           "param4": "1",
                          "param5":"12.00"
                         }
                     ],
                     "KVPList": [
                         {
                             "name": "收款",
                             "value": "￥40.00"
                         },
                         {
                             "name": "优惠",
                             "value": "￥3.00"
                         },
                        {
                             "name": "找零",
                             "value": "￥3.00"
                         },
                        {
                             "name": "实收",
                             "value": "￥37.00"
                         }
                     ]
             },
            imgMenuKey:'imgMenuKey',
            img:"widget://image/img_05.png"
            },function(ret){
                alert(JSON.stringify(ret));
            });

##可用性 Android系统可提供的1.0.0及更高版本

#videoLists 显示单个视频清单 videoLists((parames),callback(ret, err)) ##parames json: videoMenuKey: video: - 类型：String类型和json对象 - 描述：（必填项）显示数据 - 内部字段：

js
json:和显示清单一样
videoMenuKey:在SharedPreferences中存储视频路径的key
video:显示视频本地路径

##callback(ret) ret： - 类型：JSON对象 - 内部字段：status 布尔型

js
{
    status: true, //false
}

##示例代码

js
var demo = api.require('sunmiT1Screen');
 demo.videoLists({
            json:{
                     "title": "三米奶茶店欢迎您",
                     "head": {
                         "param1": "序列号",
                         "param2": "商品名",
                         "param3": "单价",
                         "param4": "数量",
                         "param5": "小结"
                     },
                     "list": [
                         {
                           "param1": "1",
                           "param2": "华夫饼",
                           "param3": "10.00",
                           "param4": "1",
                          "param5":"10.00"
                         },
                         {
                           "param1": "1",
                           "param2": "吞拿鱼华夫饼",
                           "param3": "12.00",
                           "param4": "1",
                          "param5":"12.00"
                         }
                     ],
                     "KVPList": [
                         {
                             "name": "收款",
                             "value": "￥40.00"
                         },
                         {
                             "name": "优惠",
                             "value": "￥3.00"
                         },
                        {
                             "name": "找零",
                             "value": "￥3.00"
                         },
                        {
                             "name": "实收",
                             "value": "￥37.00"
                         }
                     ]
             },
            videoMenuKey:'videoMenukey',
            video:"widget://image/video_03.mp4",
            },function(ret){
            alert(JSON.stringify(ret));
            });

##可用性 Android系统可提供的1.0.0及更高版本

imagesLists

显示轮播图清单

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

parames

json: imgsMenuKey: imgs: rotation_time:

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

内部字段：

json:和显示清单一样
imgsMenuKey:在SharedPreferences中存储图片数组路径的key
imgs:显示图片数组本地路径
rotation_time：轮播图切换的时间

callback(ret)

ret：

类型：JSON对象
内部字段：status 布尔型

{
    status: true, //false

}

示例代码

var demo = api.require('sunmiT1Screen');
demo.imagesLists({
            json:{
                     "title": "三米奶茶店欢迎您",
                     "head": {
                         "param1": "序列号",
                         "param2": "商品名",
                         "param3": "单价",
                         "param4": "数量",
                         "param5": "小结"
                     },
                     "list": [
                         {
                           "param1": "1",
                           "param2": "华夫饼",
                           "param3": "10.00",
                           "param4": "1",
                          "param5":"10.00"
                         },
                         {
                           "param1": "1",
                           "param2": "吞拿鱼华夫饼",
                           "param3": "12.00",
                           "param4": "1",
                          "param5":"12.00"
                         }
                     ],
                     "KVPList": [
                         {
                             "name": "收款",
                             "value": "￥40.00"
                         },
                         {
                             "name": "优惠",
                             "value": "￥3.00"
                         },
                        {
                             "name": "找零",
                             "value": "￥3.00"
                         },
                        {
                             "name": "实收",
                             "value": "￥37.00"
                         }
                     ]
             },
            imgsMenuKey:'imgsMenukey',
            imgs:[
                     "widget://image/img_06.png",
                     "widget://image/img_04.png",
                     "widget://image/img_02.png"
                ],
            rotation_time:2000
            },function(ret){
                alert(JSON.stringify(ret));
            });

可用性

Android系统

可提供的1.0.0及更高版本

videosLists

显示轮播视频清单

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

parames

json: videosMenuKey: videos:

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

内部字段：

json:和显示清单一样
videosMenuKey:在SharedPreferences中存储视频数组路径的key
videos:显示视频数组本地路径

callback(ret)

ret：

类型：JSON对象
内部字段：status 布尔型

{
    status: true, //false  
}

示例代码

var demo = api.require('sunmiT1Screen');
 demo.videosLists({
            videosMenuKey:'videosMenukey',
            videos:[
                     "widget://image/video_03.mp4",
                     "widget://image/video_02.mp4",
                     "widget://image/video_01.mp4"
                ],
            json:{
                     "title": "三米奶茶店欢迎您",
                     "head": {
                         "param1": "序列号",
                         "param2": "商品名",
                         "param3": "单价",
                         "param4": "数量",
                         "param5": "小结"
                     },
                     "list": [
                         {
                           "param1": "1",
                           "param2": "华夫饼",
                           "param3": "10.00",
                           "param4": "1",
                          "param5":"10.00"
                         },
                         {
                           "param1": "1",
                           "param2": "吞拿鱼华夫饼",
                           "param3": "12.00",
                           "param4": "1",
                          "param5":"12.00"
                         }
                     ],
                     "KVPList": [
                         {
                             "name": "收款",
                             "value": "￥40.00"
                         },
                         {
                             "name": "优惠",
                             "value": "￥3.00"
                         },
                        {
                             "name": "找零",
                             "value": "￥3.00"
                         },
                        {
                             "name": "实收",
                             "value": "￥37.00"
                         }
                     ]
             }
            },function(ret){
                alert(JSON.stringify(ret));
            });

可用性

Android系统

可提供的1.0.0及更高版本

exitScreen

退出副屏

exitScreen(callback(ret, err))

callback(ret)

ret：

类型：JSON对象
内部字段：status 布尔型

{
    status: true 
}

示例代码

var demo = api.require('sunmiT1Screen');
demo.exitScreen(function(ret, err) {
    alert(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

cachefile

清除缓存

cachefile(callback(ret, err))

callback(ret)

ret：

类型：JSON对象
内部字段：status 布尔型

{
    status: true 
}

示例代码

var demo = api.require('sunmiT1Screen');
demo.cachefile(function(ret){
     alert(JSON.stringify(ret));
        });

可用性

Android系统

可提供的1.0.0及更高版本

APICloud

模块开发

端API

设备访问

功能扩展

界面布局

导航菜单

开放SDK

云服务对接

AVM多端模块

H5模块

前端框架

云API

技术专题

开发工具

下载

微信公众号适配

七天培训课教程

其他

Faq

开放平台接入指南

自定义加速域名

云主机

入门教程

部署与管理

常见FAQ

MTL.js

sunmiT1Screen

概述

imagesLists

parames

callback(ret)

示例代码

可用性

videosLists

parames

callback(ret)

示例代码

可用性

exitScreen

callback(ret)

示例代码

可用性

cachefile

callback(ret)

示例代码

可用性