全部产品
云市场
云游戏

基础 Base

更新时间:2019-01-14 16:37:39

Base.checkWindVaneSDK

仅限 WindVane iOS

判断指定版本号与当前 WindVaneSDK 版本号的大小关系。

输入参数

  • [string] v - 要判断的版本号,例如 '5.3.0'

回调参数

回调参数将会在回调方法中传递,如果成功比较版本号,则进入 success 回调,否则进入 failure 回调。

  • [string] isHigher - 指定版本号与当前 WindVaneSDK 版本号的大小关系,可能的值为:
    • '1' - 指定版本号高于当前 WindVaneSDK 版本号。
    • '0' - 指定版本号与当前 WindVaneSDK 版本号相同。
    • '-1' - 指定版本号低于当前 WindVaneSDK 版本号。
  1. var params = {
  2. // 要判断的版本号
  3. v: '5.3.0'
  4. };
  5. window.WindVane.call('Base', 'checkWindVaneSDK', params, function(e) {
  6. alert('success: ' + JSON.stringify(e));
  7. }, function(e) {
  8. alert('failure: ' + JSON.stringify(e));
  9. });

Base.copyToClipboard

将指定的文本复制到剪贴板。

输入参数

  • [string] text - 要复制到剪贴板中的文本。

回调参数

无回调参数,如果成功复制到剪贴板,则进入 success 回调,否则进入 failure 回调。

  1. var params = {
  2. text: "text to copy"
  3. };
  4. window.WindVane.call('Base', 'copyToClipboard', params, function(e) {
  5. alert('success' + JSON.stringify(e));
  6. }, function(e) {
  7. alert('failure' + JSON.stringify(e));
  8. });

Base.isInstall

判断是否已安装指定的应用程序。

注意:在 iOS9 或更高版本系统中,只有在 info.plistLSApplicationQueriesSchemes 中配置过的 scheme,才能够正确判断引用是否安装。

输入参数

  • [string] ios - iOS 平台的应用程序标记,使用的是 schema,例如 'taobao://'
  • [string] android - Android 平台的应用程序标记,使用的是包名,例如 'com.taobao.taobao'

回调参数

无回调参数,如果已安装指定应用程序,则进入 success 回调,否则进入 failure 回调。

  1. var params = {
  2. // iOS 平台的应用程序标记
  3. ios: 'taobao://',
  4. // Android 平台的应用程序标记
  5. android: 'com.taobao.taobao'
  6. };
  7. window.WindVane.call('Base', 'isInstall', params, function(e) {
  8. alert('success');
  9. }, function(e) {
  10. alert('failure');
  11. });

Base.isAppsInstalled

判断是否已安装指定的多个应用程序。

注意在 iOS9 或更高版本系统中,只有在 info.plistLSApplicationQueriesSchemes 中配置过的 scheme,才能够正确判断引用是否安装。

输入参数

  • [object] appName - 要判断是否安装的 App,其值是一个对象,包含以下属性:
    • [string] ios - iOS 平台的应用程序标记,使用的是 schema,例如 'taobao://'
    • [string] android - Android 平台的应用程序标记,使用的是包名,例如 'com.taobao.taobao'

回调参数

回调参数将会在回调方法中传递,如果成功检测应用程序是否安装,则进入 success 回调,否则进入 failure 回调。

  • [boolean] appName - 之前传递的 App 是否安装。
  1. var params = {
  2. taobao: {
  3. ios: 'taobao://',
  4. android: 'com.taobao.taobao'
  5. },
  6. tmall: {
  7. ios: 'tmall://',
  8. android: 'com.tmall.tmall'
  9. }
  10. };
  11. window.WindVane.call('Base', 'isAppsInstalled', params, function(e) {
  12. alert('success: ' + JSON.stringify(e));
  13. }, function(e) {
  14. alert('failure: ' + JSON.stringify(e));
  15. });

Base.isWindVaneSDK

用于获取当前 WindVaneSDK 的版本,该参数的替代方法是自己从 UA 中获取到 WindVane 的 SDK 版本号。

输入参数

无输入参数。

回调参数

回调参数将会在回调方法中传递,如果成功获取 WindVaneSDK 的版本,则进入 success 回调,否则进入 failure 回调。

  • [string] os - 平台类型('ios'/'android')。
  • [string] version - WindVaneSDK 的版本号。
  • [string] env - 客户端环境('release'/'pre'/'daily'VER.WindVane iOS 8.1.0 或更高
  • [string] container - 容器类型('WVWebView'/'WVWKWebView'/'WVUCWebView'/'Weex'VER.WindVane 8.1.0 或更高
  1. window.WindVane.call('Base', 'isWindVaneSDK', {}, function(e) {
  2. alert('success: ' + JSON.stringify(e));
  3. }, function(e) {
  4. alert('failure: ' + JSON.stringify(e));
  5. });

Base.notify

仅限 WindVane iOS

document 引发指定名称和参数的事件。

输入参数

  • [string] event - 要引发的事件名称。
  • [object] param - 要引发的事件参数。

回调参数

无回调参数,也不会进入 successfailure 回调。

监听事件

event 指定的事件,事件参数为 param 指定的对象。

  1. document.addEventListener('MyNotifyName', function(e) {
  2. alert(JSON.stringify(e.param));
  3. }, false);
  4. var params = {
  5. // 要引发的事件名称
  6. event: 'MyNotifyName',
  7. // 要引发的事件参数
  8. param: { MyEventParam: 'paramValue' }
  9. };
  10. window.WindVane.call('Base', 'notify', params);

Base.openBrowser

仅限 WindVane iOS

打开指定 URL 的 Safari 新窗口。

输入参数

  • [string] url - 要在 Safari 中显示的 URL。

注意:仅需要确保在 Safari 中打开的 URL,才使用此 JSBridge。其它情况都请直接使用 <a> 链接、设置 location.href 或者 iframe 的方式进行跳转。

回调参数

无回调参数,如果成功打开了指定 URL,则进入 success 回调,否则进入 failure 回调。

  1. var params = {
  2. // 要在浏览器中显示的 URL
  3. url: 'http://www.baidu.com'
  4. };
  5. window.WindVane.call('Base', 'openBrowser', params, function(e) {
  6. }, function(e) {
  7. alert('failure: ' + JSON.stringify(e));
  8. });

Base.setBackgroundColor

仅限 WindVane iOS

设置 WebView 的背景颜色。

输入参数

  • [string] color - WebView 背景颜色的十六进制颜色值,支持 0X# 前缀。
  • [number] alpha - [可选]WebView 背景不透明度,有效范围为 [0, 1]

回调参数

无回调参数,如果成功设置背景透明度,则进入 success 回调,否则进入 failure 回调。

  1. var params = {
  2. color: 'FF0000',
  3. alpha: 0.3
  4. };
  5. window.WindVane.call('Base', 'setBackgroundColor', params, function(e) {
  6. alert('success: ' + JSON.stringify(e));
  7. }, function(e) {
  8. alert('failure: ' + JSON.stringify(e));
  9. });