qsh-webview-sdk 2.4.5 → 2.4.6

package/README.md

@@ -197,8 +197,8 @@ console.log('是否在 App 基座中:', env.isUniApp);
 |------|------|------|
 | `getLocation` | 获取当前位置 | `{ type?: string; altitude?: boolean; success?: Function; fail?: Function }` |
 | `getLocationAsync` | 获取位置（Promise 版） | `{ type?: string; altitude?: boolean }` |
-| `openLocation` | 查看位置（打开地图） | `{ latitude: number; longitude: number; name?: string; address?: string; scale?: number; success?: Function; fail?: Function }` |
-| `openLocationAsync` | 查看位置（Promise 版） | `{ latitude: number; longitude: number; name?: string; address?: string; scale?: number }` |
+| `openLocation` | 查看位置（打开地图） | `{ latitude: number; longitude: number; type?: 'wgs84' \| 'gcj02'; name?: string; address?: string; scale?: number; success?: Function; fail?: Function }` |
+| `openLocationAsync` | 查看位置（Promise 版） | `{ latitude: number; longitude: number; type?: 'wgs84' \| 'gcj02'; name?: string; address?: string; scale?: number }` |
 | `startLocationUpdate` | 开启前台持续定位（仅 APP） | `{ type?: string; needFullAccuracy?: boolean; success?: Function; fail?: Function }` |
 | `stopLocationUpdate` | 停止前台持续定位（仅 APP） | `{ success?: Function; fail?: Function }` |
 | `onLocationChange` | 监听实时位置变化（仅 APP） | `callback: Function` |
@@ -466,7 +466,7 @@ qsh.scanCode({
 ```javascript
 // 回调方式
 qsh.getLocation({
-  type: 'wgs84',  // 坐标类型：wgs84（GPS) 目前仅支持wgs84
+  type: 'wgs84',  // 坐标类型：wgs84（GPS)
   altitude: false, // 是否返回高度信息
   success: (res) => {
     console.log('纬度:', res.latitude);
@@ -497,9 +497,11 @@ try {
 
 ```javascript
 // 打开地图查看指定位置
+// type 默认 wgs84；小程序会转成 gcj02 后调用 wx.openLocation，App 会直接使用 wgs84 坐标
 qsh.openLocation({
-  latitude: 39.908823, // 需传入wgs84坐标
-  longitude: 116.397470, // 需传入wgs84坐标
+  latitude: 39.908823,
+  longitude: 116.397470,
+  type: 'wgs84',
   name: '天安门',
   address: '北京市东城区东长安街',
   scale: 15,  // 缩放级别 1-28
@@ -510,14 +512,15 @@ qsh.openLocation({
 
 // Promise 版本
 await qsh.openLocationAsync({
-  latitude: 39.908823, // 需传入wgs84坐标
-  longitude: 116.397470, // 需传入wgs84坐标
+  latitude: 39.908823,
+  longitude: 116.397470,
+  type: 'wgs84',
   name: '天安门'
 });
 ```
 
 #### 坐标类型
-目前定位相关接口仅支持wgs84
+目前定位相关接口 App 端建议统一使用 wgs84 坐标。`openLocation` 支持 `wgs84` / `gcj02`，SDK 会按环境自动转换坐标。
 | 类型 | 说明 | 常量 |
 |------|------|------|
 | `wgs84` | GPS 坐标 | `qsh.CoordinateTypes.WGS84` |
@@ -631,6 +634,26 @@ qsh.printPdf({
 });
 ```
 
+### 文件预览
+
+```javascript
+qsh.filePreview({
+  url: 'https://example.com/files/demo.pdf', // 文件地址
+  showMenu: true, // 是否显示右上角菜单，默认 false
+  success: (res) => console.log('文件预览请求成功', res),
+  fail: (err) => console.error('文件预览失败:', err)
+});
+
+// Promise 用法
+await qsh.filePreviewAsync({
+  url: 'https://example.com/files/demo.pdf',
+  showMenu: false
+});
+```
+
+> 仅支持以下文件格式：`doc`、`xls`、`ppt`、`pdf`、`docx`、`xlsx`、`pptx`。
+> 微信小程序 `web-view` 下，SDK 会通过 `wx.miniProgram.postMessage` 把预览请求投递给宿主，再调用 `wx.miniProgram.navigateBack` 返回基座；APP 端通过 `callApiInWebView` 调用基座能力。
+
 ### 跳转其他微信小程序
 
 ```javascript

package/dist/index.d.ts

@@ -48,6 +48,25 @@ declare namespace UniWebView {
     complete?: () => void;
   }
 
+  interface FilePreviewResult {
+    /** errMsg */
+    errMsg?: string;
+    [key: string]: any;
+  }
+
+  interface FilePreviewOptions {
+    /** file url */
+    url: string;
+    /** whether to show the top-right menu */
+    showMenu?: boolean;
+    /** success callback */
+    success?: (res: FilePreviewResult) => void;
+    /** fail callback */
+    fail?: (error: any) => void;
+    /** complete callback */
+    complete?: () => void;
+  }
+
   /**
    * 环境信息
    */
@@ -206,6 +225,83 @@ declare namespace UniWebView {
     };
   }
 
+  type OpenLocationCoordinateType = "wgs84" | "gcj02";
+  type LocationCoordinateType = OpenLocationCoordinateType | "bd09";
+
+  interface LocationResult {
+    /** 纬度 */
+    latitude: number;
+    /** 经度 */
+    longitude: number;
+    /** 位置精度 */
+    accuracy?: number;
+    /** 高度 */
+    altitude?: number;
+    /** 错误信息 */
+    errMsg?: string;
+    [key: string]: any;
+  }
+
+  interface GetLocationOptions {
+    /** 坐标类型，默认 wgs84 */
+    type?: LocationCoordinateType;
+    /** 是否返回高度信息 */
+    altitude?: boolean;
+    /** 成功回调 */
+    success?: (res: LocationResult) => void;
+    /** 失败回调 */
+    fail?: (error: any) => void;
+    /** 完成回调（无论成功失败） */
+    complete?: () => void;
+  }
+
+  interface OpenLocationOptions {
+    /** 纬度（必填） */
+    latitude: number;
+    /** 经度（必填） */
+    longitude: number;
+    /** 坐标类型，默认 wgs84 */
+    type?: OpenLocationCoordinateType;
+    /** 位置名称 */
+    name?: string;
+    /** 详细地址 */
+    address?: string;
+    /** 缩放级别 */
+    scale?: number;
+    /** 底部链接 */
+    infoUrl?: string;
+    /** 成功回调 */
+    success?: (res: any) => void;
+    /** 失败回调 */
+    fail?: (error: any) => void;
+    /** 完成回调（无论成功失败） */
+    complete?: () => void;
+  }
+
+  interface CoordinateTypesEnum {
+    readonly WGS84: "wgs84";
+    readonly GCJ02: "gcj02";
+    readonly BD09: "bd09";
+  }
+
+  interface LocationCapabilities {
+    /** 是否支持定位功能 */
+    supported: boolean;
+    /** 当前环境类型 */
+    environment: string;
+    /** 底层实现类型 */
+    implementation: string;
+    /** 功能特性 */
+    features: {
+      getLocation: boolean;
+      openLocation: boolean;
+      coordinateTypes: boolean;
+      altitudeSupport: boolean;
+      asyncSupport: boolean;
+      onLocationChange: boolean;
+    };
+  }
+
   /**
    * 环境对象
    */
@@ -411,6 +507,8 @@ declare namespace UniWebView {
   interface QshConfigOptions {
     clientId: string;
     isProd?: boolean;
+    debug?: boolean;
+    url?: string;
   }
 
   /**
@@ -462,6 +560,7 @@ declare namespace UniWebView {
     reLaunch(options: NavigateOptions): void;
     redirectTo(options: NavigateOptions): void;
     navigateToMiniProgram(options: MiniProgramNavigateOptions): void;
+    filePreview(options: FilePreviewOptions): void;
     postMessage(options?: PostMessageOptions): void;
     getEnv(callback: (info: EnvironmentInfo) => void): void;
     chooseImage(options?: ChooseImageOptions): void;
@@ -482,6 +581,8 @@ declare namespace UniWebView {
 
     navigateToMiniProgram(options: MiniProgramNavigateOptions): Promise<MiniProgramNavigateResult> | void;
     navigateToMiniProgramAsync(options: Omit<MiniProgramNavigateOptions, "success" | "fail" | "complete">): Promise<MiniProgramNavigateResult>;
+    filePreview(options: FilePreviewOptions): Promise<FilePreviewResult> | void;
+    filePreviewAsync(options: Omit<FilePreviewOptions, "success" | "fail" | "complete">): Promise<FilePreviewResult>;
 
     weixin: WeixinNamespace;
 
@@ -495,6 +596,19 @@ declare namespace UniWebView {
     /** 获取位置选择功能能力信息 */
     getChooseLocationCapabilities(): ChooseLocationCapabilities;
 
+    /** 获取当前位置 */
+    getLocation(options?: GetLocationOptions): void;
+    /** 获取位置（Promise版本） */
+    getLocationAsync(options?: Omit<GetLocationOptions, "success" | "fail" | "complete">): Promise<LocationResult>;
+    /** 查看位置 */
+    openLocation(options: OpenLocationOptions): void;
+    /** 查看位置（Promise版本） */
+    openLocationAsync(options: Omit<OpenLocationOptions, "success" | "fail" | "complete">): Promise<any>;
+    /** 位置相关常量 */
+    CoordinateTypes: CoordinateTypesEnum;
+    /** 获取位置功能能力信息 */
+    getLocationCapabilities(): LocationCapabilities;
+
     /** 图片来源类型枚举 */
     ImageSourceTypes: ImageSourceTypesEnum;
     /** 图片大小类型枚举 */