适配说明

1. 运行 npm run build
2. 将 dist/main.js 复制到应用目录，并在 index.html 进行引用
3. 监听环境变化

// 监听加载情况，切换环境
// 建议变更全局状态
if (window.UniBridgeReady) {
  appInfo.switchClient("UniApp");
} else {
  document.addEventListener("UniBridgeReady", function () {
    appInfo.switchClient("UniApp");
  });
}

4. 根据环境变量适配，具体适配参考 example 下的 Vue3 示例

应用导航

• 默认情况下应用需要自行设置网页 document.title 以适配导航显示标题
• 目前 App 不支持自定义导航栏，应用内导航需要通过环境判断隐藏
• 应用内的返回由 App 控制
• 安全区适配

@supports (bottom: constant(safe-area-inset-bottom)) or
  (bottom: env(safe-area-inset-bottom)) {
  .safe-area {
    height: constant(safe-area-inset-bottom);
    height: env(safe-area-inset-bottom);
  }
}

目前提供的 APIs

UniBridge.getLocation(Object): Promise

获取当前的地理位置、速度。

Object 参数说明

参数名	类型	必填	说明
type	String	否	默认为 wgs84 返回 gps 坐标，gcj02 返回国测局坐标，可用于 UniBridge.openLocation
altitude	Boolean	否	传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度
geocode	Boolean	否	是否解析地址信息，安卓需指定 type 为 gcj02，默认 false
highAccuracyExpireTime	Number	否	高精度定位超时时间(ms)，指定时间内返回最高精度，该值 3000ms 以上高精度定位才有效果
isHighAccuracy	Boolean	否	开启高精度定位

返回参数说明

参数	类型	说明
code	Number	0：调用接口失败（可能是权限、参数等错误，具体看 message）； 1：调用成功；
message	String	根据 code 进行返回
payload	Object	详见下方

payload 参数说明

参数	说明
latitude	纬度，浮点数，范围为-90~90，负数表示南纬
longitude	经度，浮点数，范围为-180~180，负数表示西经
speed	速度，浮点数，单位 m/s
accuracy	位置的精确度
altitude	高度，单位 m
verticalAccuracy	垂直精度，单位 m（Android 无法获取，返回 0）
horizontalAccuracy	水平精度，单位 m
address	地址信息（需配置 geocode 为 true）

address 地址信息说明

属性	类型	描述	说明
country	String	国家	如“中国”，如果无法获取此信息则返回 undefined
province	String	省份名称	如“北京市”，如果无法获取此信息则返回 undefined
city	String	城市名称	如“北京市”，如果无法获取此信息则返回 undefined
district	String	区（县）名称	如“朝阳区”，如果无法获取此信息则返回 undefined
street	String	街道信息	如“酒仙桥路”，如果无法获取此信息则返回 undefined
streetNum	String	获取街道门牌号信息	如“3 号”，如果无法获取此信息则返回 undefined
poiName	String	POI 信息	如“电子城．国际电子总部”，如果无法获取此信息则返回 undefined
postalCode	String	邮政编码	如“100016”，如果无法获取此信息则返回 undefined
cityCode	String	城市代码	如“010”，如果无法获取此信息则返回 undefined

示例

async function() {
    try {
        const { code, message, payload } = await UniBridge.getLocation({ type: 'wgs84' })
        console.log('当前位置的经度：' + payload.longitude);
		console.log('当前位置的纬度：' + payload.latitude);
    } catch (e) {
       // 有可能UniBridge对象注入失败或者不在应用内打开
       console.error('请在UniBridge中运行应用！');
       // 或者有可能是接口不支持
       console.error('当前UniBridge不支持该接口，请尝试更新到最新版再试！');
    } finally {

    }
}

UniBridge.chooseLocation(Object): Promise

打开地图选择位置。

Object 参数说明

参数名	类型	必填	说明
latitude	Number	否	目标地纬度
longitude	Number	否	目标地经度
keyword	String	否	搜索关键字

返回参数说明

参数	类型	说明
code	Number	0：调用接口失败（可能是权限、参数等错误，具体看 message）； 1：调用成功；
message	String	根据 code 进行返回
payload	Object	详见下方

payload 参数说明

参数	说明
name	位置名称
address	详细地址
latitude	纬度，浮点数，范围为-90~90，负数表示南纬，使用 gcj02 国测局坐标系。
longitude	经度，浮点数，范围为-180~180，负数表示西经，使用 gcj02 国测局坐标系。

示例

async function() {
    try {
        const { code, message, payload } = await UniBridge.chooseLocation()
        console.log('位置名称：' + payload.name);
		console.log('详细地址：' + payload.address);
		console.log('纬度：' + payload.latitude);
		console.log('经度：' + payload.longitude);
    } catch (e) {
       // 有可能UniBridge对象注入失败或者不在应用内打开
       console.error('请在UniBridge中运行应用！');
       // 或者有可能是接口不支持
       console.error('当前UniBridge不支持该接口，请尝试更新到最新版再试！');
    } finally {

    }
}

UniBridge.scanCode(Object): Promise

调起客户端扫码界面，扫码成功后返回对应的结果。

Object 参数说明

| 参数名 | 类型 | 必填 | 说明 | | :---------------- | :------ | :--- | :--------------------------------------: | ---------------------------------------------------- | | onlyFromCamera | Boolean | 否 | 是否只能从相机扫码，不允许从相册选择图片 | 字节跳动小程序、百度小程序、支付宝小程序不支持此参数 | | scanType | Array | 否 | 扫码类型，参考下方scanType的合法值 | 字节跳动小程序不支持此参数 | | autoDecodeCharset | Boolean | 否 | 是否启用自动识别字符编码功能，默认为否 | App | | autoZoom | Boolean | 否 | 是否启用自动放大，默认启用 | 仅 App-Android (3.5.4+) 支持 |

scanType 的合法值

值	说明
barCode	一维码
qrCode	二维码
datamatrix	Data Matrix 码
pdf417	PDF417 条码

返回参数说明

参数	类型	说明
code	Number	0：调用接口失败（可能是权限、参数等错误，具体看 message）； 1：调用成功；
message	String	根据 code 进行返回
payload	Object	详见下方

payload 参数说明

参数	说明
result	所扫码的内容
scanType	所扫码的类型
charSet	所扫码的字符集

示例

// 只允许通过相机扫码
async function() {
    try {
      const { code, message, payload } = await UniBridge.scanCode({ onlyFromCamera: true })
    	console.log('条码类型：' + payload.scanType);
	  	console.log('条码内容：' + payload.result);
    } catch (e) {
       // 有可能UniBridge对象注入失败或者不在应用内打开
       console.error('请在UniBridge中运行应用！');
       // 或者有可能是接口不支持
       console.error('当前UniBridge不支持该接口，请尝试更新到最新版再试！');
    } finally {

    }
}