属性:
- appid: 当前应用的APPID
- arguments: 第三方程序调用时传递给程序的参数
- channel: 应用的渠道标识
- launcher: 应用启动来源
- origin: 应用安装来源
- version: 客户端的版本名称
- versionCode: 客户端的版本号
- innerVersion: 客户端5+运行环境的内部版本号
- uniVersion: 客户端uni-app运行环境的版本号
- launchLoadedTime: 获取当前应用首页加载的时间
- processId: 获取当前应用的进程标识
- startupTime: 获取当前应用的启动时间戳
- isRecovery: 应用是否由于内核崩溃自动恢复
方法:
- agreePrivacy: 用户同意隐私政策
- disagreePrivacy: 用户不同意隐私政策
- isAgreePrivacy: 查询用户是否同意隐私政策
- showPrivacyDialog: 显示隐私政策框
- getProperty: 获取指定APPID对应的应用信息
- install: 安装应用
- quit: 退出应用
- restart: 重启当前的应用
- setBadgeNumber: 设置应用图标上显示的角标数字
- openURL: 调用第三方程序打开指定的URL
- openWeb: 使用内置Webview窗口打开URL
- openFile: 调用第三方程序打开指定的文件
- processDirectPage: 处理直达页面链接参数
- launchApplication: 调用第三方程序
- isApplicationExist: 判断第三方程序是否已存在
- isCustomLaunchPath: 判断是否自定义应用启动页面加载地址
对象:
- ApplicationInf: JSON对象,打开第三方程序参数
- BadgeOptions: JSON对象,应用角标显示需要的通知栏消息的参数
- OpenFileOptions: JSON对象,打开文件参数
- PrivacyDialogOptions: JSON对象,显示原生隐私政策提示框参数
- WidgetInfo: JSON对象,应用信息
- WidgetOptions: JSON对象,应用安装参数
回调方法:
- InstallSuccessCallback: 安装应用成功回调函数
- InstallErrorCallback: 安装应用失败回调函数
- GetPropertyCallBack: 获取应用属性成功回调函数
- OpenErrorCallback: 打开本地文件或URL失败回调函数
- LaunchErrorCallback: 调用第三方程序失败回调函数
- Callback: 通用回调函数
权限:
5+功能模块(permissions)
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"Runtime"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span>
<span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"运行环境"</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
</code></span></span>
appid
当前应用的APPID
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">appid</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
当前应用的APPID,字符串类型。注意,如果是在HBuilder真机运行获取的是固定值"HBuilder",需要提交App云端打包后运行才能获取真实的APPID值。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">//当前应用的APPID</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getAppid</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'Current APP:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">appid</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
arguments
第三方程序调用时传递给程序的参数
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">arguments</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
第三方程序传递过来的参数,字符串格式类型数据。 不是由第三方程序调用启动,则返回空字符串。
平台支持:
- Android - 2.2+ (支持) :
如果是第三方APP调用,则把传递过来的参数组合成JSON格式字符串,如“{"name":"XiaoMing","password":"123456"}”; 如果是通过URL Scheme调用则将协议头(前缀)和参数组合成字符串,如“streamapp://name=XiaoMing&password=123456”。
- iOS - 4.3+ (支持) :
把第三方传递过来的参数组合成字符串,如“name=XiaoMing&password=123456”,建议第三方程序传递JSON格式字符串; 注:由于iOS平台原生传递参数与URL Scheme一致,通过URL Scheme启动应用时也没有协议头数据(前缀)。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">//第三方程序调用时传递给程序的参数</span>
<span style="color:#87ceeb">//5+ APP通常在plusredy后调用</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getArguments</span><span style="color:#ffffff">(){</span>
<span style="color:#87ceeb">// 处理第三方传入的参数</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">arguments </span><span style="color:#ffffff">!=</span> <span style="color:#ffa0a0">""</span><span style="color:#ffffff">){</span>
<span style="color:#f0e68c"><strong>try</strong></span><span style="color:#ffffff">{</span>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> aj </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> JSON</span><span style="color:#ffffff">.</span><span style="color:#ffffff">parse</span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">arguments</span><span style="color:#ffffff">);</span>
<span style="color:#87ceeb">// 处理JSON对象aj</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>catch</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// 若传入的参数不是JSON格式字符,需处理异常情况</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
</code></span></span>
channel
应用的渠道标识
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">channel</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
如果应用没有设置渠道标识,则返回空字符串。 以下是流应用环境中使用的特殊渠道标识:
- "qihoo:browser" - 表示360浏览器流应用
- "qihoo:appstore " - 表示360手机助手流应用
- "dcloud:streamapps" - 表示DCloud流应用基座
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 应用的渠道标识</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getChannel</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'Current Channel:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">channel</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
launcher
应用启动来源
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">launcher</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
5+ APP启动类型,可取以下值:
- "default":默认启动方式,通常表示应用列表启动(360手助中搜索启动)
- "scheme":通过urlscheme方式触发启动
- "push":通过点击系统通知方式触发启动
- "stream":通过流应用api(plus.stream.open)启动
- "shortcut":通过快捷方式启动,iOS平台表示通过3D Touch快捷方式,Android平台表示通过桌面快捷方式启动
- "barcode":通过二维码扫描启动
- "myapp":通过流应用"我的"应用列表或历史列表中触发启动
- "favorite":通过流应用的"收藏"应用列表启动
- "browser":通过流应用的内置浏览器导流启动的流应用(地址栏输入url启动应用、点击wap页面链接启动应用)
- "engines":通过流应用的浏览器界面作为搜索引擎启动
- "search":通过流应用的应用搜索启动应用(如iOS平台的T9键盘搜索)
- "speech":通过流应用的语音识别启动应用
- "uniLink":通过通用链接(universal link)启动应用
- "miniProgram":通过微信小程序启动应用
平台支持:
- Android - 2.2+ (支持) :
"shortcut"表示通过桌面快捷方式启动。
- iOS - 5.1+ (支持) :
"shortcut"表示通过3D Touch弹出的快捷方式启动。
origin
应用安装来源
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">origin</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
5+应用安装来源,可取以下值:
- "default":默认安装来源,apk/ipa安装包内置安装
- "stream":通过流应用api(plus.stream.open)安装,仅流应用环境下支持
- "push":通过点击系统通知方式触发安装,仅流应用环境下支持
- "scheme":通过urlscheme方式触发安装,仅流应用环境下支持
- "barcode":通过二维码扫描触发安装,仅流应用环境下支持
- "silent":通过后台静默方式安装,仅流应用环境下支持
- "speech":通过语音识别方式触发安装,仅流应用环境下支持
- "favorite":通过收藏界面启动触发安装,仅流应用环境下支持
version
客户端的版本名称
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">version</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
字符串类型,在编译环境中设置的apk/ipa版本名称。 Android平台对应AndroidManifest.xml中的android:versionName属性值; iOS平台对应Info.plist中的CFBundleShortVersionString字段值。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">//客户端(apk/ipa)的版本名称</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getVersion</span><span style="color:#ffffff">(){</span>
<span style="color:#87ceeb">// 获取apk/ipa版本名称</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'Application(apk/ipa) version:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">version</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
versionCode
客户端的版本号
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">versionCode</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
字符串类型,仅包含数字。 Android平台对应AndroidManifest.xml中的android:versionCode属性值; iOS平台对应Info.plist中CFBundleVersion字段值。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">//客户端(apk/ipa)的版本号</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getVersionCode</span><span style="color:#ffffff">(){</span>
<span style="color:#87ceeb">// 获取apk/ipa版本号</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'Application(apk/ipa) version:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">versionCode</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
innerVersion
客户端5+运行环境的内部版本号
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerVersion</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
5+运行环境内部版本号,格式为:[主版本号].[次版本号].[修订版本号].[编译代号]。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 5+运行环境的内部版本号</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getInnerVersion</span><span style="color:#ffffff">(){</span>
<span style="color:#87ceeb">// 获取5+运行环境的版本号</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'5+ Runtime version:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerVersion</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
uniVersion
客户端uni-app运行环境的版本号
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">uniVersion</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
uni-app运行环境版本号,格式为:[主版本号].[次版本号].[修订版本号]。 注意:仅在uni-app应用中才能获取此版本号,非uni-app应用中返回空字符串。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// uni-app运行环境版本号</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getUniVersion</span><span style="color:#ffffff">(){</span>
<span style="color:#87ceeb">// 获取uni-app运行环境版本号</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'uni-app Runtime version:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">uniVersion</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
launchLoadedTime
获取当前应用首页加载的时间
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">launchLoadedTime</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
Number 类型 只读属性
应用加载首页面的总时间,从开始加载首页面到首页面加载完成,单位为ms。 注意,应用首页为网络地址则包括网络传输时间。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取当前应用首页加载的时间</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'首页加载时间:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">launchLoadedTime </span><span style="color:#ffffff">+</span> <span style="color:#ffa0a0">'ms'</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
processId
获取当前应用的进程标识
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">processId</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
String 类型 只读属性
当前应用所属系统进程标识。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取当前应用的进程标识</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'进程标识:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">processId</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
startupTime
获取当前应用的启动时间戳
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">startupTime</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
Number 类型 只读属性
应用启动时间戳,距1970年1月1日之间的毫秒数。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取当前应用的启动时间戳</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'应用启动时间:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">startupTime</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
isRecovery
应用是否由于内核崩溃自动恢复
<span style="background-color:#333333"><span style="color:#474747"><code><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isRecovery</span><span style="color:#ffffff">;</span>
</code></span></span>
说明:
Boolean 类型 只读属性
如果应用是由于内核(WKWebview)崩溃恢复则返回true,否则返回false。 注意:仅iOS平台使用WKWebview内核时生效。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取当前应用是否由于内核崩溃自动恢复</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> onPlusReady</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'应用由内核崩溃恢复:'</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isRecovery</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
agreePrivacy
用户同意隐私政策
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">agreePrivacy</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
HBuilderX2.5.11+版本支持,参考: Android平台隐私与政策提示框配置方法 - DCloud问答
设置应用状态为用户同意隐私政策,可通过plus.runtime.isAgreePrivacy判断是否已经同意。
参数:
无
返回值:
void : 无
disagreePrivacy
用户不同意隐私政策
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">disagreePrivacy</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
HBuilderX2.5.11+版本支持,参考: Android平台隐私与政策提示框配置方法 - DCloud问答
设置应用状态为用户不同意隐私政策,可通过plus.runtime.isAgreePrivacy判断是否已经同意。
参数:
无
返回值:
void : 无
isAgreePrivacy
查询用户是否同意隐私政策
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">Boolean</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isAgreePrivacy</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
HBuilderX2.5.11+版本支持,参考: Android平台隐私与政策提示框配置方法 - DCloud问答
查询当前用户是否同意隐私政策。
参数:
无
返回值:
Boolean : 已同意返回true,否则返回false
平台支持:
- Android - ALL (支持) :
用户同意了隐私政策返回true,否则返回false。
- iOS - ALL (支持) :
调用plus.runtime.agreePrivacy()将返回false,调用后将返回ture。
showPrivacyDialog
显示隐私政策框
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">Boolean</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isAgreePrivacy</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
HBuilderX3.3.1+版本支持,参考: Android平台隐私与政策提示框配置方法 - DCloud问答
显示原生隐私政策提示框,并重置为用户未同意隐私协议状态。
参数:
- options: ( PrivacyDialogOptions ) 必选 隐私政策框配置项
返回值:
void : 无
平台支持:
- Android - ALL (支持) :
弹出原生隐私政策提示框,如果没有配置原生隐私政策提示框则触发错误回调。
- iOS - ALL (不支持) :
不做任何操作。
getProperty
获取指定APPID对应的应用信息
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getProperty</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> appid</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> getPropertyCB </span><span style="color:#ffffff">);</span>
</code></span></span>
参数:
- appid: ( String ) 必选 应用的Appid
- getPropertyCB: ( GetPropertyCallBack ) 必选 获得应用信息成功回调函数
返回值:
void : 无
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取应用信息</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getAppInfo</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getProperty</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">appid</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> wgtinfo </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span>
<span style="color:#87ceeb">//appid属性</span>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> wgtStr </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">"appid:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">appid</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//version属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>version:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">version</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//name属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>name:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//description属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>description:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">description</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//author属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>author:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">author</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//email属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>email:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">email</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//features 属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>features:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">features</span><span style="color:#ffffff">;</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> wgtStr </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
install
安装应用
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">install</span><span style="color:#ffffff">(</span><span style="color:#ffffff">filePath</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> options</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> installSuccessCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> installErrorCB</span><span style="color:#ffffff">);</span>
</code></span></span>
说明:
支持以下类型安装包: 1. 应用资源安装包(wgt),扩展名为'.wgt'; 2. 应用资源差量升级包(wgtu),扩展名为'.wgtu'; 3. 系统程序安装包(apk),要求使用当前平台支持的安装包格式。 注意:仅支持本地地址,调用此方法前需把安装包从网络地址或其他位置放置到运行时环境可以访问的本地目录。
参数:
- filePath: ( String ) 必选 要安装的文件路径
支持应用资源安装包(wgt)、应用资源差量升级包(wgtu)、系统程序包(apk)。
- options: ( WidgetOptions ) 可选
应用安装设置的参数
- installSuccessCB: ( InstallSuccessCallback ) 可选
正确安装后的回调
- installErrorCB: ( InstallErrorCallback ) 可选
安装失败的回调
返回值:
void : 无
平台支持:
- Android - 2.2+ (支持) :
安装apk需添加以下权限:
- "<uses-permission android:name="android.permission.INSTALL_PACKAGES"/>"
- "<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>"
- iOS - 4.3+ (支持) :
不支持ipa包的安装,需跳转appsotre引导用户手动操作安装。
quit
退出应用
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">quit</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
5+APP:退出应用,返回系统桌面; 流应用:在“流应用”中调用则退出当前流应用,返回进入应用前的界面(如应用列表)。
参数:
无
返回值:
void : 无
平台支持:
- Android - 2.2+ (支持) :
支持
- iOS - 4.3+ (支持) :
5+APP:不支持此功能,调用后无任何作用,只能通过设备的Home键退出应用。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 退出应用</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> quitApp</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">quit</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span>
</code></span></span>
restart
重启当前的应用
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">restart</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
应用热重启,重新启动进入首页。
参数:
无
返回值:
void : 无
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 重启当前的应用</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> restartApp</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">restart</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span>
</code></span></span>
setBadgeNumber
设置应用图标上显示的角标数字
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setBadgeNumber</span><span style="color:#ffffff">(</span><span style="color:#ffffff">number</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> options</span><span style="color:#ffffff">);</span>
</code></span></span>
参数:
- number: ( Number ) 必选
要显示的角标数字值,参数为0则表示清除角标数字。
- options: ( BadgeOptions ) 可选
小米手机显示角标需要在系统消息中心显示一条通知,此参数用于设置通知的标题(title)和内容(content)。
返回值:
void : 无
平台支持:
- Android - 2.2+ (支持) :
目前仅支持小米(MIUI6及以上)和华为设备,其它设备调用后无任何效果;
HBuilderX2.9.9+版本支持VIVO设备。 - iOS - 4.3+ (支持) :
应用需开启“Push Notifications”服务才生效。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 设置数字</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> setBadge</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setBadgeNumber</span><span style="color:#ffffff">(</span><span style="color:#cd5c5c">8</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#87ceeb">// 清除数字</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> clearBadge</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">setBadgeNumber</span><span style="color:#ffffff">(</span><span style="color:#cd5c5c">0</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
openURL
调用第三方程序打开指定的URL
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">openURL</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> url</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> identity </span><span style="color:#ffffff">);</span>
</code></span></span>
参数:
- url: ( String ) 必选 要打开的URL地址
字符串类型,各平台支持的地址类型存在差异,参考平台URL支持表。
- errorCB: ( OpenErrorCallback ) 可选 打开URL地址失败的回调
打开指定URL地址失败时回调,并返回失败信息。
- identity: ( String ) 可选 指定打开URL地址的程序名称
在iOS平台此参数被忽略,在Android平台为程序包名,如果指定的包名不存在,则打开URL地址失败。
返回值:
void : 无
平台支持:
- Android - 2.2+ (支持) :
支持
- iOS - 4.3+ (支持) :
支持,不支持identity参数
openWeb
使用内置Webview窗口打开URL
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">openWeb</span><span style="color:#ffffff">(</span><span style="color:#ffffff">url</span><span style="color:#ffffff">);</span>
</code></span></span>
参数:
- url: ( String ) 必选 要打开的URL地址
字符串类型,仅支持http/https地址。
返回值:
void : 无
openFile
调用第三方程序打开指定的文件
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">openFile</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> filepath</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> options</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB </span><span style="color:#ffffff">);</span>
</code></span></span>
参数:
- filepath: ( String ) 必选 打开文件的路径
字符串类型,文件路径必须是本地路径,否则会导致打开文件失败。
- options: ( OpenFileOptions ) 可选 打开文件参数
- errorCB: ( OpenErrorCallback ) 必选 打开文件失败的回调
打开文件操作失败时回调,返回失败信息。
返回值:
void : 无
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 打开文件操作</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> openFile</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">openFile</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"_doc/a.pdf"</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
processDirectPage
处理直达页面链接参数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">String</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">processDirectPage</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
通过URL Scheme启动时,可以在?后面添加__direct_page参数自定义直达页面地址, 如“streamapp://m3w.cn/s/HelloH5?__direct_page=http%3a%2f%2fm.weibo.cn%2fu%2f3196963860”; 在流应用SDK集成时也可以通过direct_page参数(原生调用Intent)设置。 注意:仅第一次调用此API时返回直达页面链接地址,再次调用将返回空字符串;如果应用重新被带直达页面链接参数的URL Scheme启动/激活时,可再次调用此方法获取。
参数:
无
返回值:
String : 如果启动应用时传入直达页面,则返回直达页面链接地址; 否则返回空字符串。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 处理直达页面</span>
<span style="color:#87ceeb">// 仅流应用支持,在plusready事件中调用</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> processDirectPage</span><span style="color:#ffffff">(){</span>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> url </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">processDirectPage</span><span style="color:#ffffff">();</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">url</span><span style="color:#ffffff">&&</span><span style="color:#ffffff">url</span><span style="color:#ffffff">!==</span><span style="color:#ffa0a0">''</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// 创建新窗口打开并加载</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">webview</span><span style="color:#ffffff">.</span><span style="color:#ffffff">create</span><span style="color:#ffffff">(</span><span style="color:#ffffff">url</span><span style="color:#ffffff">).</span><span style="color:#ffffff">show</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'no direct page url.'</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
</code></span></span>
launchApplication
调用第三方程序
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">launchApplication</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> appInf</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB </span><span style="color:#ffffff">);</span>
</code></span></span>
参数:
- appInf: ( ApplicationInf ) 必选 要启动第三方程序的描述信息
- errorCB: ( LaunchErrorCallback ) 必选 启动第三方程序操作失败的回调函数
启动第三方程序失败时回调,并返回失败信息。
返回值:
void : 无
平台支持:
- Android - 2.2+ (支持) :
支持
- iOS - 4.3+ (支持) :
支持
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 调用第三方程序</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> launchApp</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span>
<span style="color:#f0e68c"><strong>if</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">os</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name </span><span style="color:#ffffff">==</span> <span style="color:#ffa0a0">"Android"</span> <span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">launchApplication</span><span style="color:#ffffff">(</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">pname</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">"com.android.browser"</span>
<span style="color:#ffffff">,</span><span style="color:#ffffff">extra</span><span style="color:#ffffff">:{</span><span style="color:#ffffff">url</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">"http://www.html5plus.org"</span><span style="color:#ffffff">}},</span> <span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> e </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"Open system default browser failed: "</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">message </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#f0e68c"><strong>else</strong></span> <span style="color:#f0e68c"><strong>if</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">os</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name </span><span style="color:#ffffff">==</span> <span style="color:#ffa0a0">"iOS"</span> <span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">launchApplication</span><span style="color:#ffffff">(</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">action</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">"http://www.html5plus.org"</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#ffffff">(</span><span style="color:#ffffff"> e </span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
alert</span><span style="color:#ffffff">(</span> <span style="color:#ffa0a0">"Open system default browser failed: "</span> <span style="color:#ffffff">+</span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">message </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
</code></span></span>
isApplicationExist
判断第三方程序是否已存在
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">Boolean</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isApplicationExist</span><span style="color:#ffffff">(</span><span style="color:#ffffff">appInf</span><span style="color:#ffffff">);</span>
</code></span></span>
说明:
如果第三方程序已安装则返回true,未安装则返回false。
参数:
- appInf: ( ApplicationInf ) 必选 要判断第三方程序的描述信息
Android平台需要通过设置appInf的pname属性(包名)进行查询。 iOS平台需要通过设置appInf的action属性(Scheme)进行查询,在iOS9以后需要添加白名单才可查询,在manifest.json文件plus->distribute->apple->urlschemewhitelist节点下添加(如urlschemewhitelist:["weixin"]).
返回值:
Boolean : 第三方程序已安装则返回true,否则返回false。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 判断第三方程序(微信) 是否安装</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> checkApp</span><span style="color:#ffffff">(){</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isApplicationExist</span><span style="color:#ffffff">({</span><span style="color:#ffffff">pname</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'com.tencent.mm'</span><span style="color:#ffffff">,</span><span style="color:#ffffff">action</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'weixin://'</span><span style="color:#ffffff">})){</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"微信应用已安装"</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"微信应用未安装"</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
</code></span></span>
isCustomLaunchPath
判断是否自定义应用启动页面加载地址
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#98fb98">Boolean</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isCustomLaunchPath</span><span style="color:#ffffff">();</span>
</code></span></span>
说明:
通过URL Scheme启动时,可以在?后面添加__launch_path参数自定义应用启动首页加载的页面地址, 如“streamapp://m3w.cn/s/HelloH5?__launch_path=http%3a%2f%2fm.weibo.cn%2fu%2f3196963860”; 在流SDK集成时也可以通过launch_path参数(原生调用Intent)设置。
参数:
无
返回值:
Boolean : 如果应用自定义页面地址则返回true,否则返回false。
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 判断是否自定义首页地址</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> checkLaunchPath</span><span style="color:#ffffff">(){</span>
<span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isCustomLaunchPath</span><span style="color:#ffffff">(){</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"自定义应用首页地址"</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span><span style="color:#ffffff">{</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"使用应用默认首页地址"</span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
</code></span></span>
ApplicationInf
JSON对象,打开第三方程序参数
属性:
- pname: (String 类型 )第三方程序包名
仅Android平台支持,表示程序的包名,其它平台忽略此属性值。
平台支持
- Android - 2.2+ (支持) :
第三方程序的包名,如“io.dclould.HelloH5”。
- iOS - ALL (不支持) :
忽略此属性值。
- Android - 2.2+ (支持) :
- action: (String 类型 )程序的操作行为
Android平台上与系统的action值一致;iOS平台为要调用程序的URLScheme格式字符串。
平台支持
- Android - 2.2+ (支持) :
第三方程序的操作行为,与系统的action值完全一致。
- iOS - 4.3+ (支持) :
要调用程序的URLScheme格式字符串。
- Android - 2.2+ (支持) :
- newTask: (Boolean 类型 )新任务模式标记
可取值: true-使用新任务模式标记(FLAG_ACTIVITY_NEW_TASK)启动应用; false-不使用新任务模式标记(FLAG_ACTIVITY_NEW_TASK)启动应用。 默认值为true。 注意:由于5+应用配置的launchMode为singleTask,所以另一个5+应用通过plus.runtime.launchApplication启动时如果应用已经在后台运行则不会触发newintent事件,为了避免此问题需要将newTask参数值设置为false。
平台支持
- Android - 2.2+ (支持)
- iOS - ALL (不支持) :
忽略此属性值。
- extra: (JSON 类型 )调用程序的参数
仅Android平台支持,为JSON格式,用于传递给要调用程序的参数,如extra:{url:"http://www.html5plus.org"}。
平台支持
- Android - 2.2+ (支持) :
传递给第三方程序的参数,必须是JSON格式数据,如“{'name':'value','name2':'value2'}”。
- iOS - ALL (不支持) :
忽略此属性值。
- Android - 2.2+ (支持) :
BadgeOptions
JSON对象,应用角标显示需要的通知栏消息的参数
属性:
- title: (String 类型 )消息的标题
默认值为应用的名称。
- content: (String 类型 )消息的内容
默认值为“您有x条未读消息"”,其中x未设置的角标数字值。
OpenFileOptions
JSON对象,打开文件参数
属性:
- pname: (String 类型 )优先使用的程序包名
如果指定包名的程序已经安装,则调用其打开文件,若程序不支持打开文件则触发错误回调。 如果指定包名的程序未安装,则弹出系统支持打开此文件的列表,由用户选择程序打开。
PrivacyDialogOptions
JSON对象,显示原生隐私政策提示框参数
属性:
- success: (Callback 类型 )显示原生隐私政策提示框成功回调
可根据回调参数中的code属性判断用户是否同意了隐私政策,如果res.code值为1表示用户已同意,其它值则表示用户未同意。
- fail: (Callback 类型 )显示原生隐私政策提示框失败回调
回调参数中的code属性表示错误码,如果没有配置原生隐私政策提示框则会触发失败。
WidgetInfo
JSON对象,应用信息
属性:
- appid: (String 类型 )应用的APPID
对应manifest.json中的id字段值。
- version: (String 类型 )应用的版本名称
对应manifest.json中的version->name字段值。
- versionCode: (String 类型 )应用的版本号
对应manifest.json中的version->code字段值。
- name: (String 类型 )应用的名称
对应manifest.json中的name字段值。
- description: (String 类型 )应用描述信息
对应manifest.json中的description字段值。
- author: (String 类型 )应用描述信息
对应manifest.json中的developer->name字段值。
- email: (String 类型 )开发者邮箱地址
对应manifest.json中的developer->email字段值。
- features: (String[] 类型 )应用许可特性列表
对应manifest.json中的permissions字段下所有键名的列表。
WidgetOptions
JSON对象,应用安装参数
说明:
可通过对象设置安装的应用是否进行appid校验、版本号校验等。
属性:
- force: (Boolean 类型 )是否强制安装
true表示强制安装,不进行版本号的校验;false则需要版本号校验,如果将要安装应用的版本号不高于现有应用的版本号则终止安装,并返回安装失败。 仅安装wgt和wgtu时生效,默认值 false。
InstallSuccessCallback
安装应用成功回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onSuccess</span><span style="color:#ffffff">(</span><span style="color:#ffffff">widgetInfo</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// Code here</span>
<span style="color:#ffffff">}</span>
</code></span></span>
参数:
- widgetInfo: ( WidgetInfo ) 必选
应用信息,参见:WidgetInfo
返回值:
void : 无
平台支持:
- Android - 2.2+ (支持) :
支持,如安装文件为APK,则不触发此回调函数
- iOS - 4.3+ (支持) :
支持
InstallErrorCallback
安装应用失败回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onError</span><span style="color:#ffffff">(</span><span style="color:#ffffff">error</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// Handle the error</span>
<span style="color:#ffffff">}</span>
</code></span></span>
参数:
- error: ( Exception ) 必选
安装失败的错误信息
返回值:
void : 无
GetPropertyCallBack
获取应用属性成功回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onGetPropertyCB</span><span style="color:#ffffff">(</span><span style="color:#ffffff">widgetInfo</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// Code here</span>
<span style="color:#ffffff">}</span>
</code></span></span>
参数:
- widgetInfo: ( WidgetInfo ) 必选 应用信息
包括应用名称、标识等属性。
返回值:
void : 无
示例:
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#87ceeb">// 获取应用信息</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> getAppInfo</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">
plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getProperty</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">runtime</span><span style="color:#ffffff">.</span><span style="color:#ffffff">appid</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">//appid属性</span>
<span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> wgtStr </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">"appid:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">appid</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//version属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>version:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">version</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//name属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>name:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//description属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>description:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">description</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//author属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>author:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">author</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//email属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>email:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">email</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//licence属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>license:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">license</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//licensehref属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>licensehref:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">licensehref</span><span style="color:#ffffff">;</span>
<span style="color:#87ceeb">//features 属性</span><span style="color:#ffffff">
wgtStr </span><span style="color:#ffffff">+=</span> <span style="color:#ffa0a0">"<br/>features:"</span><span style="color:#ffffff">+</span><span style="color:#ffffff">wgtinfo</span><span style="color:#ffffff">.</span><span style="color:#ffffff">features</span><span style="color:#ffffff">;</span><span style="color:#ffffff">
console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffffff"> wgtStr </span><span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span> <span style="color:#ffffff">);</span>
<span style="color:#ffffff">}</span>
</code></span></span>
OpenErrorCallback
打开本地文件或URL失败回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onError</span><span style="color:#ffffff">(</span><span style="color:#ffffff">error</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// Handle the error</span>
<span style="color:#ffffff">}</span>
</code></span></span>
参数:
- error: ( Exception ) 必选
打开操作失败的错误信息
返回值:
void : 无
LaunchErrorCallback
调用第三方程序失败回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onError</span><span style="color:#ffffff">(</span><span style="color:#ffffff">error</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// Handle the error</span>
<span style="color:#ffffff">}</span>
</code></span></span>
参数:
- error: ( Exception ) 必选 操作失败的错误信息
可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。
返回值:
void : 无
Callback
通用回调函数
<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onCallback</span><span style="color:#ffffff">(</span><span style="color:#ffffff">res</span><span style="color:#ffffff">){</span>
<span style="color:#87ceeb">// Handle callback</span>
<span style="color:#ffffff">}</span>
</code></span></span>
参数:
- res: ( JSON ) 必选 回调参数
根据业务类型回调参数中的属性不同。
返回值:
void : 无