信息类别 | 详情说明 |
方法作用 | H5 页面调用并执行 APP 端指定的 JS 脚本文件 |
方法语法 | window.at.runJsFile(file) |
参数详情 | 名称:file类型:String说明:需执行的 APP 端 JS 文件路径或文件名(如 “主脚本.js”) |
返回值 | 无 |
核心功能描述 | 从 H5 端触发,加载并运行 APP 本地的 JS 文件,实现调用 APP 端预设脚本的需求 |
调用示例代码 | // H5中调用APP端的“主脚本.js” window.at.runJsFile('主脚本.js'); |
信息类别 | 详情说明 |
方法作用 | H5 页面调用 APP 原生脚本中定义的指定方法,并传递参数 |
方法语法 | window.at.callFunction(funname, arg) 或 window.at.callFun(funname, arg) |
参数详情 | 1. 名称:funname类型:String说明:APP 端需调用的方法名2. 名称:arg类型:String说明:传递给方法的参数(多参数需用 JSON 字符串封装,如'{"name":"test","value":123}' ) |
返回值 | 无 |
核心功能描述 | 建立 H5 与 APP 原生脚本的方法调用通道,支持 H5 向 APP 传递数据并触发指定逻辑 |
调用示例代码 | // H5调用APP端“main”方法,传递参数“hello” window.at.callFun('main', 'hello'); // 多参数示例(JSON字符串) window.at.callFun('submitData', '{"username":"user1","age":20}'); |
信息类别 | 详情说明 |
方法作用 | H5 页面获取当前 APP 项目的根目录路径,用于后续文件操作(如读写文件) |
方法语法 | window.at.getRootPath() |
参数详情 | 无 |
返回值 | 类型:String说明:返回项目根目录的绝对路径(如 “/storage/emulated/0/APP 名称 /”) |
核心功能描述 | 提供项目根路径基准,方便 H5 拼接文件路径,实现对 APP 本地文件的访问 |
调用示例代码 | // H5获取项目根目录并打印 var rootPath = window.at.getRootPath();console.log('项目根目录:', rootPath); |
信息类别 | 详情说明 |
方法作用 | H5 页面获取当前 APP 项目的资源目录路径,用于访问 APP 预设的资源文件(如配置文件) |
方法语法 | window.at.getResourcesPath() |
参数详情 | 无 |
返回值 | 类型:String说明:返回项目资源目录的绝对路径(如 “/storage/emulated/0/APP 名称 /resources/”) |
核心功能描述 | 定位 APP 资源文件存放路径,便于 H5 读取或写入资源目录下的文件(如配置数据) |
调用示例代码 | // H5获取资源目录并拼接文件路径 var resPath = window.at.getResourcesPath(); var configPath = resPath + 'config.txt'; // 资源目录下的config.txt console.log('配置文件路径:', configPath); |
信息类别 | 详情说明 |
方法作用 | H5 页面将数据存储到 APP 本地指定路径的文件中,实现数据持久化(如保存配置) |
方法语法 | window.at.setConfig(path, arg, value) |
参数详情 | 1. 名称:path类型:String说明:数据存储的文件路径(如 “/sdcard/1.txt” 或资源目录路径)2. 名称:arg类型:String说明:数据存储的参数标识(用于后续读取时定位数据)3. 名称:value类型:String说明:需存储的具体数据内容 |
返回值 | 无 |
核心功能描述 | 支持 H5 向 APP 本地文件写入数据,可指定存储路径和参数标识,便于后续精准读取 |
调用示例代码 | // 1. 存储到SD卡根目录 window.at.setConfig('/sdcard/1.txt', 'a', '1'); // 2. 存储到资源目录(先获取资源路径) var resPath = window.at.getResourcesPath(); window.at.setConfig(resPath + '1.txt', 'userInfo', '{"name":"test"}'); |
信息类别 | 详情说明 |
方法作用 | H5 页面从 APP 本地指定路径的文件中读取数据,获取之前通过 setConfig 存储的内容 |
方法语法 | window.at.getConfig(path, arg, value) |
参数详情 | 1. 名称:path类型:String说明:数据读取的文件路径(需与存储时路径一致)2. 名称:arg类型:String说明:数据读取的参数标识(需与存储时 arg 一致)3. 名称:value类型:String说明:默认值,当文件中无对应数据时返回该值 |
返回值 | 类型:String说明:返回读取到的数据(有数据则返回实际值,无数据则返回默认值) |
核心功能描述 | 配合 setConfig 使用,实现 H5 对 APP 本地存储数据的读取,支持默认值兜底 |
调用示例代码 | // 1. 从SD卡读取数据(默认值为“0”) var data1 = window.at.getConfig('/sdcard/1.txt', 'a', '0');// 2. 从资源目录读取数据(默认值为“{}”) var resPath = window.at.getResourcesPath(); var userInfo = window.at.getConfig(resPath + '1.txt', 'userInfo', '{}'); console.log('用户信息:', userInfo); |
信息类别 | 详情说明 |
方法作用 | H5 页面向 APP 原生端的公共变量中设置键值对,实现 H5 到 APP 的简单数据传递 |
方法语法 | window.at.publicSet(key, value) |
参数详情 | 1. 名称:key类型:String说明:公共变量的键名(用于 APP 端识别数据)2. 名称:value类型:String说明:公共变量的键值(需传递给 APP 的数据) |
返回值 | 无 |
核心功能描述 | 轻量级数据传递方式,无需文件操作,直接通过公共变量实现 H5 与 APP 的数据交互 |
调用示例代码 | // H5向APP公共变量设置“a=1” window.at.publicSet('a', '1'); // APP端对应取值方式:publicData.get('a') |
信息类别 | 详情说明 |
方法作用 | H5 页面从 APP 原生端的公共变量中读取指定键名对应的值,获取 APP 传递的数据 |
方法语法 | window.at.publicGet(key) |
参数详情 | 名称:key类型:String说明:需读取的公共变量键名(需与 APP 端设置的键名一致) |
返回值 | 类型:String说明:返回公共变量中对应键名的 value 值 |
核心功能描述 | 配合 publicSet 使用,实现 APP 到 H5 的轻量级数据传递,无需文件读写操作 |
调用示例代码 | // H5读取APP公共变量中“a”的值 var data = window.at.publicGet('a'); console.log('公共变量a的值:', data); // APP端对应设值方式:publicData.set('a', '1') |
信息类别 | 详情说明 |
方法作用 | APP 端通过 WebView 控件加载指定的 H5 页面(支持本地路径或网络 URL) |
方法语法 | web1.url(url) 或 web1.loadUrl(url) (web1 为 WebView 控件实例) |
参数详情 | 名称:url类型:String说明:H5 页面路径,本地路径如 “/ 代码 /h5.html”,网络路径如 “https://xxx.com/h5 ” |
返回值 | 无 |
核心功能描述 | APP 端初始化 H5 页面的核心方法,建立 WebView 与 H5 页面的关联 |
调用示例代码 | // 1. APP初始化WebView控件 var ac = new activity(); ac.loadXML('<!-- 布局中包含WebView(id为web) -->'); var web1 = ac.findWebViewById('web'); // 2. 加载本地H5页面 web1.url('/代码/h5.html'); // 3. 加载网络H5页面 // web1.url('https://xxx.com/test.html'); |
信息类别 | 详情说明 |
方法作用 | APP 端向 WebView 中的 H5 页面注入并执行 JS 代码,实现 APP 到 H5 的逻辑触发 |
方法语法 | web1.runWebJs(jscode) (web1 为 WebView 控件实例) |
参数详情 | 名称:jscode类型:String说明:需在 H5 中执行的 JS 代码字符串(如 “alert ('123')”) |
返回值 | 类型:String说明:返回 JS 代码执行后的结果(类似 eval 执行结果,即最后一个变量的值) |
核心功能描述 | APP 主动控制 H5 页面逻辑,如触发 H5 弹窗、调用 H5 方法、修改 H5 页面数据 |
调用示例代码 | // 1. APP向H5注入弹窗代码 web1.runWebJs('alert("APP触发H5弹窗")'); // 2. APP调用H5中的test方法 web1.runWebJs('test()'); // 需确保H5中已定义test方法 // 3. APP获取H5执行结果 var result = web1.runWebJs('1 + 2'); // result值为“3” console.log('H5代码执行结果:', result); |
欢迎光临 自动发帖软件 (http://www.fatiegongju.com/) | Powered by Discuz! X3.2 |