dMultiScreen

requestPermission searchList open show hide invokeJs close

概述

dMultiScreen 可以在多个显示屏下让其显示不同的内容，可在指定屏幕下让其运行指定的html，并支持在运行时通过方法来执行指定js，运行时如在同域名下，多个屏幕的db、cookie等将共享。
dMultiScreen 适用于需要多屏展示的场景下。

插件使用攻略

Android版本要求：>= Android4.4
dMultiScreen 所创建的视图并不支持官方所提供的方法，如:api等接口。

实例widget下载地址

插件接口

requestPermission

请求运行dMultiScreen所需的权限。注意：当没有权限时，只有requestPermission与searchList可用！

requestPermission(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    result: 'ok'      //字符串型；ok表示已获取权限
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: 'Permission android.permission.SYSTEM_ALERT_WINDOW is denied.'     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').requestPermission(function(ret, err) {
    console.log(ret, err);
    if(ret && 'ok' == ret.result) {
        console.log('获取权限成功');
    }
    else {
        console.log(JSON.stringify(err));
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

searchList

搜索当前设备的所有显示器。

searchList(callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON数组
  • 内部字段：
[
    {
        id:       //显示器序号
        name:     //显示器名称
        width：   //横向分辨率
        height：  //纵向分辨率
    }
]

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ''     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').searchList(function(ret, err) {
    if(err)
         console.log(JSON.stringify(err));
    else
        console.log(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

open

在指定显示器上运行网页。

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

params

id：

  • 类型：整形数字
  • 描述：(可选) 默认为主屏幕，从searchList中得到的id赋值,id为-1取最后一个可用屏幕。

url：

  • 类型：字符串型
  • 描述：(必须) 加载指定页面，支持widget:// , https:// ,http:// 协议

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    result: 'ok'      //字符串型；ok表示加载成功
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ''     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').open({id:0, url:"https://www.baidu.com"}, function(ret, err) {
    if(err)
         console.log(JSON.stringify(err));
    else
        console.log(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

show

在指定的显示器上显示内容。

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

params

id：

  • 类型：整形数字
  • 描述：(可选) 默认为主屏幕，从searchList中得到的id赋值,id为-1取最后一个可用屏幕。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    result: 'ok'      //字符串型；ok表示已显示
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ''     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').show({id:0}, function(ret, err) {
    if(err)
         console.log(JSON.stringify(err));
    else
        console.log(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

hide

在指定的显示器上隐藏内容。

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

params

id：

  • 类型：整形数字
  • 描述：(可选) 默认为主屏幕，从searchList中得到的id赋值,id为-1取最后一个可用屏幕。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    result: 'ok'      //字符串型；ok表示已隐藏
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ''     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').hide({id:0}, function(ret, err) {
    if(err)
         console.log(JSON.stringify(err));
    else
        console.log(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

invokeJs

在指定显示器上运行js函数。

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

params

id：

  • 类型：整形数字
  • 描述：(可选) 默认为主屏幕，从searchList中得到的id赋值,id为-1取最后一个可用屏幕。

eval：

  • 类型：字符串型
  • 描述：(必须) 在指定显示器上所要运行的js字符串,运行结果只能返回字符串类型。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    result: ''      //字符串型；当有返回值时，result不为空
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ''     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').invokeJs({id:0,eval:"function a(){console.log('success!');return 'success!';} a();"}, function(ret, err) {
    if(err)
         console.log(JSON.stringify(err));
    else
        console.log(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.0及更高版本

close

关闭指定屏幕上的视图。

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

params

id：

  • 类型：整形数字
  • 描述：(可选) 默认为主屏幕，从searchList中得到的id赋值,id为-1取最后一个可用屏幕。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
{
    result: 'ok'      //字符串型；ok表示已隐藏
}

err：

  • 类型：JSON对象
  • 内部字段：
{
    msg: ''     //字符串型；提示出错的信息
}

示例代码

api.require('dMultiScreen').close({id:0}, function(ret, err) {
    if(err)
         console.log(JSON.stringify(err));
    else
        console.log(JSON.stringify(ret));
});

可用性

Android系统

可提供的1.0.1及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2025/01/15