Skip to main content

接口使用介绍（必读）

概述​

JavaScript 接口的产生有两个原因：

  1. 新版多媒体程序中通过 Android 原生应用提供的接口并不完全兼容老版多媒体程序，为此通过 JavaScript 接口来提供兼容性接口。
  2. Android 原生应用提供的接口不能使用函数作为参数，为此通过 JavaScript 接口来提供支持函数作为参数的接口。

使用方法​

从多媒体版本 280 开始，Android 原生应用内置了 JavaScript 接口相关的 SDK 文件，使用时只需要在 HTML 文件中引入即可。确保引入的代码位于 <head> 标签内，并且在其他 JavaScript 代码之前引入，避免出现不可预知的错误。

<head>
  <meta charset="UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Shine</title>
  <script>
   var code = NativeFile.readFile("/sdcard/shine/sdk.js");
   var script = document.createElement("script");
   script.type = "text/javascript";
   try {
    script.appendChild(document.createTextNode(code));
   } catch (ex) {
    script.text = code;
   }
   document.head.appendChild(script);
  </script>
 </head>

由于 sdk.js 路径硬编码问题，导致一些主板加载不到该文件，从多媒体版本 400 开始，可以使用以下方式引入：

<head>
  <meta charset="UTF-8" />
  <meta http-equiv="X-UA-Compatible" content="IE=edge" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Shine</title>
  <script>
   var code = Native.getSDKCode();
   var script = document.createElement("script");
   script.type = "text/javascript";
   try {
    script.appendChild(document.createTextNode(code));
   } catch (ex) {
    script.text = code;
   }
   document.head.appendChild(script);
  </script>
 </head>

如果需要调试 JavaScript 接口，可以单独下载 sdk.js 文件，然后在 HTML 文件中引入即可。