openApp

打开手机上其它应用,可以传递参数

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

params

appParam:

  • 类型:JSON 对象
  • 默认值:无
  • 描述:(可选项)传给目标应用的参数。iOS 平台会将 appParam 里面的值拼接到 iosUrl 后面,比如 iosUrl 为 http://www.baidu.com ,appParam为{“keyword”:”APICloud”},则最后传递给第三方应用的url为http://www.baidu.com?keyword=APICloud

iosUrl:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)目标应用的url(iOS平台使用),iOS下必传

androidPkg:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)目标应用的包名或 action(Android平台使用),Android下必传

mimeType:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)指定目标应用的响应数据类型,如:”text/html”(Android平台使用)

uri:

  • 类型:字符串
  • 默认值:无
  • 描述:(可选项)指定目标应用响应的uri(Android平台使用)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:目标应用关闭后的返回值,只支持Android

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:"" //错误描述
  3. }

示例代码

  1. //iOS中的使用方法如下:
  2. api.openApp({
  3. iosUrl: 'weixin://', //打开微信,其中weixin为微信的URL Scheme
  4. appParam: {
  5. appParam: 'app参数'
  6. }
  7. });
  8. api.openApp({
  9. iosUrl: 'app-settings:' //打开应用设置界面,支持iOS 8及以上系统
  10. });
  11. //Android中的使用方法如下:
  12. api.openApp({
  13. androidPkg: 'android.intent.action.VIEW',
  14. mimeType: 'text/html',
  15. uri: 'http://www.baidu.com'
  16. }, function(ret, err) {
  17. if (ret) {
  18. alert(JSON.stringify(ret));
  19. } else {
  20. alert(JSON.stringify(err));
  21. }
  22. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本