@ray-js/api 1.7.39 → 1.7.41

package/@types/DeviceKit.d.ts

@@ -3,7 +3,160 @@
  *
  * @version 4.13.1
  */
+
+interface WifiInfo {
+  ssid: string;
+  password: string;
+}
+interface NetworkInfo {
+  /* 网络类型, 0:wifi, 1:有线, 2:4G */
+  network: number;
+  ssid: string;
+  /* 信号强度 */
+  signal: number;
+  /* 设备 flags 标识 */
+  flags?: number;
+  /* ssid hash */
+  hashValue: string
+}
+interface NetworkBackupModel {
+  ssid: string;
+  password?: string;
+  /* ssid hash */
+  hashValue?: string;
+}
+interface BackupNetworkContext {
+  /** 是否支持备份网络 */
+  checkBackupNetworkAbility: (params: {
+    success?: (params: {
+      result: boolean
+    }) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /** 获取设备当前的网络信息 */
+  getCurrentNetworkInfo: (params: {
+    success?: (params: {
+      info: NetworkInfo
+    }) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /** 获取设备备份的网络信息 */
+  getBackupNetworkInfos: (params: {
+    success?: (params: {
+      infos: NetworkBackupModel[],
+      NetworkBackupModel: number
+    }) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /*  生成备用网络信息 */
+  generateBackupNetworkInfo: (params: {
+    wifiInfo: WifiInfo,
+    success?: (params: {
+      info: NetworkBackupModel
+    }) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /** 检查是否可以更新备用网络 */
+  checkWhetherCanUpdateBackupNetwork: (params: {
+    info: NetworkInfo,
+    success?: (params: {
+      result: boolean
+    }) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /** 更新备用网络 */
+  updateBackupNetwork: (params: {
+    networks: NetworkBackupModel[],
+    success?: (params: null) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /** 检查是否可以切换备用网络 */
+  checkWhetherCanSwitchBackupNetwork: (params: {
+    info: NetworkInfo,
+    success?: (params: {
+      result: boolean
+    }) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+
+  /** 切换备用网络 */
+  switchBackupNetwork: (params: {
+    /* 使用 ssid hash 进行切换 */
+    hashValue?: string,
+    /* 使用 wifi 信息进行切换 */
+    wifiInfo?: WifiInfo,
+    success?: (params: null) => void,
+    fail?: (params: {
+      /** 错误信息 */
+      errorMsg: string
+      /* 错误码 */
+      errorCode: string
+    }) => void,
+    complete?: (params: null) => void
+  }) => void;
+}
 declare namespace ty.device {
+  /**
+   *@description 创建内部 DeviceNetworkManager 上下文*/
+  export function getDeviceNetworkManager(params: {
+    /** 设备模型 设备id */
+    deviceId: string
+    success?: (params: null) => void
+    fail?: (params: {
+      errorMsg: string
+      errorCode: string | number
+    }) => void
+    complete?: () => void
+  }): BackupNetworkContext
+
   /**
    *@description 注册监听远离beacon设备范围事件*/
   export function unregisterLeaveBeaconFenceEvent(params: {

package/lib/DeviceKit-4.13.1.d.ts

@@ -244,3 +244,4 @@ export declare const subDeviceReplace: typeof ty.device.subDeviceReplace;
 export declare const fetchReplacementOutcomeJobModel: typeof ty.device.fetchReplacementOutcomeJobModel;
 export declare const getMeshDeviceIdHex: typeof ty.device.getMeshDeviceIdHex;
 export declare const onSubDeviceReplaceResult: typeof ty.device.onSubDeviceReplaceResult;
+export declare const getDeviceNetworkManager: typeof ty.device.getDeviceNetworkManager;

package/lib/DeviceKit-4.13.1.js

@@ -755,4 +755,9 @@ export const getMeshDeviceIdHex = factory('getMeshDeviceIdHex', {
 });
 export const onSubDeviceReplaceResult = factory('onSubDeviceReplaceResult', {
   "namespace": "device"
+});
+
+// 4.20.7 新增
+export const getDeviceNetworkManager = factory('getDeviceNetworkManager', {
+  "namespace": "device"
 });

package/lib/cloud/outdoor.d.ts

@@ -82,9 +82,9 @@ type GetVehicleImgUrlResult = string;
  * @param {GetVehicleImgUrlParams} params
  * @returns {Promise<GetVehicleImgUrlResult>}
  */
-export declare const GetVehicleImgUrl: (params: GetVehicleImgUrlParams) => Promise<GetVehicleImgUrlResult>;
+export declare const getVehicleImgUrl: (params: GetVehicleImgUrlParams) => Promise<GetVehicleImgUrlResult>;
 /**
- * 获取车辆详情图片地址参数
+ * 根据活动类型展示位置等获取活动信息参数
  */
 type GetActivityInfoParams = {
     activityTypes: string;
@@ -112,4 +112,48 @@ type GetActivityInfoResult = {
  * @returns {Promise<GetActivityInfoResult[]>}
  */
 export declare const getActivityInfo: (params: GetActivityInfoParams) => Promise<GetActivityInfoResult[]>;
+/**
+ * 根据设备id和code查询设备属性信息参数
+ */
+type GetDeviceBindInfoParams = {
+    deviceId: string;
+    codes: string;
+    coordinate?: string;
+};
+type GetDeviceBindInfoResult = Record<string, any>;
+/**
+ * 根据设备id和code查询设备属性信息
+ * @param {GetDeviceBindInfoParams} params
+ * @returns {Promise<GetDeviceBindInfoResult>}
+ */
+export declare const getDeviceBindInfo: (params: GetDeviceBindInfoParams) => Promise<GetDeviceBindInfoResult>;
+/**
+ * 查询用户正在使用中的出行增值服务能力和导航增值服务能力参数
+ */
+type GetRunningAbilityParams = {
+    devId: string;
+    uuid: string;
+};
+type GetRunningAbilityResult = Record<string, any>;
+/**
+ * 查询用户正在使用中的出行增值服务能力和导航增值服务能力
+ * @param {GetRunningAbilityParams} params
+ * @returns {Promise<GetRunningAbilityResult>}
+ */
+export declare const getRunningAbility: (params: GetRunningAbilityParams) => Promise<GetRunningAbilityResult>;
+/**
+ * 根据设备id更新APP的弹窗状态(只弹窗一次)参数
+ */
+type SetVasPopupParams = {
+    devId: string;
+    uuid: string;
+    hadPopup: boolean;
+};
+type SetVasPopupResult = boolean;
+/**
+ * 根据设备id更新APP的弹窗状态(只弹窗一次)
+ * @param {SetVasPopupParams} params
+ * @returns {Promise<SetVasPopupResult>}
+ */
+export declare const setVasPopup: (params: SetVasPopupParams) => Promise<SetVasPopupResult>;
 export {};

package/lib/cloud/outdoor.js

@@ -102,7 +102,7 @@ export const getVehicleDetail = params => {
  * @param {GetVehicleImgUrlParams} params
  * @returns {Promise<GetVehicleImgUrlResult>}
  */
-export const GetVehicleImgUrl = params => {
+export const getVehicleImgUrl = params => {
   return requestCloud({
     api: `m.outdoors.device.vehicle.pic`,
     version: '1.0',
@@ -111,7 +111,7 @@ export const GetVehicleImgUrl = params => {
 };
 
 /**
- * 获取车辆详情图片地址参数
+ * 根据活动类型展示位置等获取活动信息参数
  */
 
 /**
@@ -129,4 +129,55 @@ export const getActivityInfo = params => {
     version: '1.0',
     data: params
   });
+};
+
+/**
+ * 根据设备id和code查询设备属性信息参数
+ */
+
+/**
+ * 根据设备id和code查询设备属性信息
+ * @param {GetDeviceBindInfoParams} params
+ * @returns {Promise<GetDeviceBindInfoResult>}
+ */
+export const getDeviceBindInfo = params => {
+  return requestCloud({
+    api: `${THING}.m.trip.outdoors.device.bind.info.get`,
+    version: '1.0',
+    data: params
+  });
+};
+
+/**
+ * 查询用户正在使用中的出行增值服务能力和导航增值服务能力参数
+ */
+
+/**
+ * 查询用户正在使用中的出行增值服务能力和导航增值服务能力
+ * @param {GetRunningAbilityParams} params
+ * @returns {Promise<GetRunningAbilityResult>}
+ */
+export const getRunningAbility = params => {
+  return requestCloud({
+    api: `m.outdoors.vas.running.ability.get`,
+    version: '3.0',
+    data: params
+  });
+};
+
+/**
+ * 根据设备id更新APP的弹窗状态(只弹窗一次)参数
+ */
+
+/**
+ * 根据设备id更新APP的弹窗状态(只弹窗一次)
+ * @param {SetVasPopupParams} params
+ * @returns {Promise<SetVasPopupResult>}
+ */
+export const setVasPopup = params => {
+  return requestCloud({
+    api: `m.outdoors.vas.popup.set`,
+    version: '1.0',
+    data: params
+  });
 };

package/lib/panel/devInfo/index.d.ts

@@ -61,7 +61,17 @@ export declare const initDevInfo: (option?: {
     deviceId?: string;
     groupId?: string;
 }) => Promise<DevInfo>;
-export declare const getDevInfo: () => DevInfo;
+/**
+ * @deprecated
+ *
+ * 该方法已废弃，请使用@ray-js/ray 中的 device.getDeviceInfo 异步方法或@ray-js/panel-sdk 中的智能设备模型实例的 getDeviceInfo 同步方法获取。
+ *
+ * 若仍要使用，请确保在 await initDevInfo 方法后调用，此时设备信息已初始化完毕或在返回值为 null 时做好兼容处理。
+ */
+export declare const getDevInfo: () => null | DevInfo;
+/**
+ * @deprecated 该方法已废弃，请勿使用
+ */
 export declare const updateDevInfo: (devInfo: DevInfo) => void;
 /**
  * 绑定当前设备或群组基础事件

package/lib/panel/devInfo/index.js

@@ -96,9 +96,21 @@ export const initDevInfo = option => {
     }
   });
 };
+
+/**
+ * @deprecated
+ *
+ * 该方法已废弃，请使用@ray-js/ray 中的 device.getDeviceInfo 异步方法或@ray-js/panel-sdk 中的智能设备模型实例的 getDeviceInfo 同步方法获取。
+ *
+ * 若仍要使用，请确保在 await initDevInfo 方法后调用，此时设备信息已初始化完毕或在返回值为 null 时做好兼容处理。
+ */
 export const getDevInfo = () => {
   return __deviceInfo;
 };
+
+/**
+ * @deprecated 该方法已废弃，请勿使用
+ */
 export const updateDevInfo = devInfo => {
   __deviceInfo = devInfo;
 };

package/lib/panel/publishDps.d.ts

@@ -2,6 +2,8 @@ import { publishDpsBase } from '../..';
 import { GetTTTAllParams, DpState } from './types';
 type PublishDpsOptions = Omit<GetTTTAllParams<typeof publishDpsBase>, 'deviceId' | 'dps'>;
 /**
+ * @deprecated 该方法已废弃，请使用@ray-js/ray中的 device.publishDps 替代
+ *
  * 下发 DP 点控制设备
  *
  * @param data - 当前要下发的 DP 数据，同时支持 key 为 dp code 或 dp id
@@ -14,7 +16,8 @@ type PublishDpsOptions = Omit<GetTTTAllParams<typeof publishDpsBase>, 'deviceId'
  */
 export declare function sendDps(data: DpState, options?: PublishDpsOptions): Promise<boolean>;
 /**
- * 兼容新旧 publishDps，可以使用原有小程序提供的调用方式，也可以使用 SDK 提供的调用方式。
+ * @deprecated 该方法已废弃，请使用@ray-js/ray中的 device.publishDps 替代
+ *
  * @param data ty.device.publishDps的参数 或 当前要下发的 DP 数据，同时支持 key 为 dp code 或 dp id
  * @param options publishDps 的高阶配置，默认值为 { mode: 2, options: {}, pipelines: [] } * @example
  *

package/lib/panel/publishDps.js

@@ -10,6 +10,8 @@ const DEFAULT_OPTIONS = {
 };
 
 /**
+ * @deprecated 该方法已废弃，请使用@ray-js/ray中的 device.publishDps 替代
+ * 
  * 下发 DP 点控制设备
  *
  * @param data - 当前要下发的 DP 数据，同时支持 key 为 dp code 或 dp id
@@ -47,7 +49,8 @@ export function sendDps(data) {
 }
 
 /**
- * 兼容新旧 publishDps，可以使用原有小程序提供的调用方式，也可以使用 SDK 提供的调用方式。
+ * @deprecated 该方法已废弃，请使用@ray-js/ray中的 device.publishDps 替代
+ *
  * @param data ty.device.publishDps的参数 或 当前要下发的 DP 数据，同时支持 key 为 dp code 或 dp id
  * @param options publishDps 的高阶配置，默认值为 { mode: 2, options: {}, pipelines: [] } * @example
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/api",
-  "version": "1.7.39",
+  "version": "1.7.41",
   "description": "Ray universal api",
   "keywords": [
     "ray"
@@ -29,8 +29,8 @@
     "watch": "ray start --type=component"
   },
   "dependencies": {
-    "@ray-js/framework": "1.7.39",
-    "@ray-js/router": "1.7.39",
+    "@ray-js/framework": "1.7.41",
+    "@ray-js/router": "1.7.41",
     "base64-browser": "^1.0.1",
     "query-string": "^7.1.3"
   },
@@ -38,7 +38,7 @@
     "@ray-js/wechat": "^0.3.13"
   },
   "devDependencies": {
-    "@ray-js/cli": "1.7.39",
+    "@ray-js/cli": "1.7.41",
     "art-template": "^4.13.4",
     "fs-extra": "^10.1.0",
     "miniprogram-api-typings": "^3.12.3",
@@ -48,5 +48,5 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
-  "gitHead": "29022302e7f940eed314d4deb15214fcfe389e2e"
+  "gitHead": "8d87c81bc22eb81e68c5ca8d0d76028cf9867a30"
 }