# API 支持列表

API 的支持情况在原子接口环境与原子组件环境下有所不同，以下从新增 API 和原有 API 两个维度分别列出所有支持的 API。

## 新增 API

小程序 AI 开发模式下新增的 API 都在 `wx.modelContext` 命名空间下。

**原子接口支持的如下：**

1. 创建 Skill：`wx.modelContext.createSkill(skillPath: string)`
    - 注册原子接口：`skill.registerAPI('name', handler)`
    - 注册中间件：`skill.use(Middleware)`
1. 获取会话 ID：`wx.modelContext.getSessionId()`
1. 设置所有组件过期：`wx.modelContext.expireAllCards({ componentPaths, match })`

**原子组件支持的如下：**

1. 关联小程序页面：`wx.modelContext.getViewContext(this).setRelatedPage({ path, query })`
1. 上行消息：`wx.modelContext.getContext().sendFollowUpMessage()`
1. 更新卡片状态并同步给模型：`wx.modelContext.getViewContext(this).updateModelContext({content: [{type: 'text', text: '用户选择了xxx'}]})`
1. 半屏页面：
    - 打开半屏页面：`wx.modelContext.getViewContext(this).openDetailPage({ url })`
    - 预加载半屏页面：`wx.modelContext.getViewContext(this).preloadDetailPage({ url })`
    - 半屏页面更新卡片：`wx.modelContext.getContext().reapplyApiCall({ arguments })`
1. 原子组件过期态：
   - 设置所有组件过期：`wx.modelContext.expireAllCards({ componentPaths, match })`
   - 设置之前的组件过期：`wx.modelContext.getViewContext(this).expirePreviousCards({ componentPaths, match })`
1. 原子组件接收事件：`wx.modelContext.getViewContext(this).on(NotificationType, calback)`
    - 原子接口入参：`wx.modelContext.NotificationType.Input`
    - 原子接口出参：`wx.modelContext.NotificationType.Result`
    - 内容溢出事件：`wx.modelContext.NotificationType.Overflow`
    - 过期事件：`wx.modelContext.NotificationType.Expire`

## 原有 API

小程序原有部分 API 支持在小程序 AI 开发模式下调用，但原子接口与原子组件可调用的接口有所不同，支持情况如下表：

> 若某个分类下的 API 都支持，细分 API 则不会全部列出，请跳转到接口文档查看
> 
> 原则上，不会再提供原有的已标为废弃版本的 API

```json
[
  {
    "分类": "[基础](/miniprogram/dev/api/base/wx.env.md)",
    "API": "wx.env",
    "原子接口": "支持",
    "原子组件": "支持"
  },
  {
    "分类": "[登录](/miniprogram/dev/api/open-api/login/wx.login.md)",
    "API": "wx.login",
    "原子接口": "支持",
    "原子组件": "不支持（需声明 scope.dynamic）"
  },
  {
    "分类": "wx.checkSession",
    "API": "支持",
    "原子接口": "不支持（需声明 scope.dynamic）",
    "原子组件": ""
  },
  {
    "分类": "[发起请求](/miniprogram/dev/api/network/request/wx.request.md)",
    "API": "wx.request",
    "原子接口": "支持",
    "原子组件": "不支持（需声明 scope.dynamic）"
  },
  {
    "分类": "[网络](/miniprogram/dev/api/device/network/wx.onNetworkWeakChange.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[云开发](/miniprogram/dev/wxcloudservice/wxcloud/basis/getting-started.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[位置](/miniprogram/dev/api/location/wx.openLocation.md)",
    "API": "wx.getLocation",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "wx.getFuzzyLocation",
    "API": "支持",
    "原子接口": "不支持",
    "原子组件": ""
  },
  {
    "分类": "wx.openLocation",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.chooseLocation",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "[加密](/miniprogram/dev/api/base/crypto/wx.getUserCryptoManager.md)",
    "API": "wx.getUserCryptoManager",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[系统](/miniprogram/dev/api/base/system/wx.getDeviceInfo.md)",
    "API": "wx.getDeviceInfo",
    "原子接口": "支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.getAppBaseInfo",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.getWindowInfo",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "[数据缓存](/miniprogram/dev/api/storage/wx.setStorageSync.md)",
    "API": "wx.getStorage",
    "原子接口": "支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.setStorage",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.batchGetStorage",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.batchSetStorage",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.getStorageInfo",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.removeStorage",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.clearStorage",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.getStorage",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.setStorageSync",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.getStorageSync",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "分享",
    "API": "wx.shareAppMessage",
    "原子接口": "不支持",
    "原子组件": "支持（需在 tap 事件回调中调用）"
  },
  {
    "分类": "手机号",
    "API": "wx.getPhoneNumber",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "wx.getRealtimePhoneNumber",
    "API": "支持",
    "原子接口": "不支持",
    "原子组件": ""
  },
  {
    "分类": "[图片视频](/miniprogram/dev/api/media/video/wx.chooseMedia.md)",
    "API": "wx.chooseMedia",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.chooseMessageFile",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.previewMedia",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.saveImageToPhotosAlbum",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.getImageInfo",
    "API": "支持",
    "原子接口": "不支持",
    "原子组件": ""
  },
  {
    "分类": "人脸核身",
    "API": "wx.startFacialRecognitionVerify",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "wx.startFacialRecognitionVerifyAndUploadVideo",
    "API": "支持",
    "原子接口": "不支持",
    "原子组件": ""
  },
  {
    "分类": "[支付](/miniprogram/dev/api/payment/wx.requestPayment.md)",
    "API": "wx.requestPayment",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.requestVirtualPayment",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.verifyPaymentPassword",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.requestJointPayment",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.openPublicServicePayment",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.openBusinessView businessType=openPublicServicePayment",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.openBusinessView businessType=trafficInvestList",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "wx.openBusinessView businessType=wxpayPapayIndex",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "微信支付分",
    "API": "wx.openBusinessView businessType=wxpayScoreUse",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.openBusinessView businessType=wxpayScoreEnable",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "[订阅消息](/miniprogram/dev/api/open-api/subscribe-message/wx.requestSubscribeMessage.md)",
    "API": "wx.requestSubscribeMessage",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "授权",
    "API": "wx.authorize",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[电话](/miniprogram/dev/api/device/phone/wx.makePhoneCall.md)",
    "API": "wx.makePhoneCall",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[扫码](/miniprogram/dev/api/device/scan/wx.scanCode.md)",
    "API": "wx.scanCode",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[交互](/miniprogram/dev/api/ui/interaction/wx.showToast.md)",
    "API": "wx.showToast",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.hideToast",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "城市服务",
    "API": "wx.openBusinessView businessType=wxCityWxpayAuth",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[收货地址](/miniprogram/dev/api/open-api/address/wx.chooseAddress.md)",
    "API": "wx.chooseAddress",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[设置](/miniprogram/dev/api/open-api/setting/wx.openSetting.md)",
    "API": "wx.openSetting",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.getSetting",
    "API": "支持",
    "原子接口": "不支持",
    "原子组件": ""
  },
  {
    "分类": "[WiFi](/miniprogram/dev/api/device/wifi/wx.stopWifi.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[蓝牙-通用](/miniprogram/dev/api/device/bluetooth/wx.stopBluetoothDevicesDiscovery.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[蓝牙-低功耗中心设备](/miniprogram/dev/api/device/bluetooth-ble/wx.writeBLECharacteristicValue.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[蓝牙-低功耗外围设备](/miniprogram/dev/api/device/bluetooth-peripheral/wx.onBLEPeripheralConnectionStateChanged.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[WebSocket](/miniprogram/dev/api/network/websocket/wx.connectSocket.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[mDNS](/miniprogram/dev/api/network/mdns/wx.startLocalServiceDiscovery.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[加速计](/miniprogram/dev/api/device/accelerometer/wx.startAccelerometer.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[罗盘](/miniprogram/dev/api/device/compass/wx.startCompass.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[设备方向](/miniprogram/dev/api/device/motion/wx.startDeviceMotionListening.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[陀螺仪](/miniprogram/dev/api/device/gyroscope/wx.startGyroscope.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[TCP 通信](/miniprogram/dev/api/network/tcp/wx.createTCPSocket.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[UDP 通信](/miniprogram/dev/api/network/udp/wx.createUDPSocket.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[上传](/miniprogram/dev/api/network/upload/wx.uploadFile.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[下载](/miniprogram/dev/api/network/download/wx.downloadFile.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "支持"
  },
  {
    "分类": "[文件](/miniprogram/dev/api/file/wx.openDocument.md)",
    "API": "wx.openDocument",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[地图](/miniprogram/dev/api/media/map/MapContext.md)",
    "API": "全部，除了 MapContext.openMapApp",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[微信运动](/miniprogram/dev/api/open-api/werun/wx.getWeRunData.md)",
    "API": "wx.getWeRunData",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[发票](/miniprogram/dev/api/open-api/invoice/wx.chooseInvoiceTitle.md)",
    "API": "wx.chooseInvoiceTitle",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.chooseInvoice",
    "API": "不支持",
    "原子接口": "支持",
    "原子组件": ""
  },
  {
    "分类": "[账号信息](/miniprogram/dev/api/open-api/account-info/wx.getAccountInfoSync.md)",
    "API": "wx.getAccountInfoSync",
    "原子接口": "支持",
    "原子组件": "支持"
  },
  {
    "分类": "[人脸检测](/miniprogram/dev/api/open-api/face/wx.requestFacialVerify.md)",
    "API": "全部",
    "原子接口": "支持",
    "原子组件": "不支持"
  },
  {
    "分类": "[振动](/miniprogram/dev/api/device/vibrate/wx.vibrateShort.md)",
    "API": "全部",
    "原子接口": "不支持",
    "原子组件": "支持"
  },
  {
    "分类": "[隐私信息授权](/miniprogram/dev/api/open-api/privacy/wx.openPrivacyContract.md)",
    "API": "wx.getPrivacySetting",
    "原子接口": "支持",
    "原子组件": "支持"
  },
  {
    "分类": "wx.openPrivacyContract",
    "API": "支持",
    "原子接口": "支持",
    "原子组件": ""
  }
]
```

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2026 年 06 月 29 日添加viewContext.updateModelContext的使用描述
