# Runtime

• 方法
  • openDoc 容器-离线在线文档查看,同时支持第三方程序打开
  • openFile 调用第三方程序打开指定的文件(ios可以直接打开)
  • openURL 调用第三方程序打开指定的URL，支持打开safari打开 网页，以及app
  • openWeb 使用内置Webview窗口打开URL
  • appFinish 退出app
  • getLauncherPram 获取应用启动来源，第三方程序调用时传递给程序的参数
  • dial 拨打电话
  • existApp 是否安装某程序
  • sendSMS 发送短信

# openDoc

文档在线查看

• 参数说明

  参数名	类型	必填	说明
  url	String	是	在线文档资源路径 (Android只支持本地文件，在线文件仅支持下载链接有后缀的url（比如https://it.yusys.com.cn/ycoms/download/template/asset/diannaobuzhu.pdf）
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息

• 示例代码

foxsdk.runtime.openDoc("https://docs.qq.com/sheet/BqI21X2yZIht1N59gL2IMRkf3dEbdO0zFEj61sCqPv31d8Bu1IQmKC2Cjyb92MdwqS0CI1h24OZqwV1DJA7M4?tdsourcetag=s_macqq_app&tab=BB08J2&c=A1A0A0", ret => {
    console.log('runtime/openDoc===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# openFile

调用第三方程序打开指定的文件(ios可以直接打开)-离线文档

• 参数说明

  参数名	类型	必填	说明
  url	String	是	本地文件的绝对路径或相对路径,相对路径示例： "_downloads/demo.pdf"
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	调用结果

• 示例代码

foxsdk.runtime.openFile("_downloads/demo.pdf", ret => {
    console.log('runtime/openFile===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# openURL

调用第三方程序打开指定的URL，（iOS使用safari打开）

• 参数说明

  参数名	类型	必填	说明
  url	String	是	URL 地址
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	调用结果

• 示例代码

foxsdk.runtime.openURL("https://www.baidu.com", ret => {
    console.log('runtime/openURL===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# openWeb

使用内置Webview窗口打开URL

• 参数说明

  参数名	类型	必填	说明
  url	String	是	web页面URL地址
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	调用结果

• 示例代码

foxsdk.runtime.openWeb("https://www.baidu.com", ret => {
    console.log('runtime/openWeb===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# appFinish

退出app

• 参数说明

  参数名	类型	必填	说明
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	调用结果

• 示例代码

foxsdk.runtime.appFinish(ret => {
    console.log('runtime/appFinish===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# getLauncherPram

获取应用启动来源 （第三方程序调用时传递给程序的参数）

• 参数说明

  参数名	类型	必填	说明
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 0成功, 1：失败
  message	String	调用结果信息
  payload	Object	调用结果

• payload返回参数说明

  参数名	类型	说明
  launcher	String	应用启动来源
  arguments	Object	传入的参数

• 示例代码

foxsdk.runtime.getLauncherPram(ret => {
    console.log('runtime/getLauncherPram===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# dial

拨打电话 （唤起系统的拨号功能）

• 参数说明

  参数名	类型	必填	说明
  data	String	是	电话号码
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• completedCB返回参数说明

  参数名	类型	说明
  status	Number	调用状态码 调用状态码 0成功, 58001未授与电话权限
  message	String	调用结果信息
  payload	Object	调用结果

• 示例代码

foxsdk.device.dial('180xxxxxxxx',ret => {
    console.log('device/dial===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# existApp

是否安装某app

• 参数说明

  参数名	类型	必填	说明
  packageId	String	是	Android 包名
  URLScheme	String	是	iOS App URLScheme
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• 示例代码

foxsdk.runtime.existApp(ret => {
    console.log('device/dial===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});

# sendSMS

发送短信

• 参数说明

  参数名	类型	必填	说明
  phoneNum	String	是	手机号
  message	String	是	短信内容
  completedCB	Function	可选	请求完成回调函数，成功/失败都会触发

• 示例代码

foxsdk.device.sendSMS({phoneNum:'180xxxxxxxx',message:'短信内容'},ret => {
    console.log('device/dial===status: ' + ret.status + ',message: ' + ret.message + ',payload: ' + JSON.stringify(ret.payload));
});