# wx.miniapp.shareImageMessage

分享图片到微信

注:

1、该接口需要申请和初始化微信 open 能力,需要客户端进行相关配置

2、该接口不支持在「移动应用助手」中调试,开发者需构建 apk 或者 ipa 安装到手机后才能调试

# 接入前注意事项

# 参数

方便开发者理解,wx.miniapp.shareImageMessage 参数与微信开放平台 opensdk 分享接口参数一致

属性 类型 默认值 必填 说明
imagePath string - 分享图片,支持代码包图片资源路径或者本地临时、缓存、用户文件;不支持网络图片路径
thumbPath string - 分享缩略图,支持代码包图片资源路径或者本地临时、缓存、用户文件;不支持网络图片路径
scene number - 发送的目标场景,0=分享到会话,1=分享到朋友圈,2=分享到收藏
entranceMiniProgramUsername string - 启动小程序username(小程序的原始id,gh_xxx);iOS SDK >=1.3.36;Android SDK >=1.3.26
entranceMiniProgramPath string - 启动小程路径;iOS SDK >=1.3.36;Android SDK >=1.3.26

备注:

  • entranceMiniProgramUsername:表示分享的图片消息是否要带小程序入口,非空则显示;
  • entranceMiniProgramPath:分享的图片消息显示的小程序入口可以跳转的小程序路径;
  • 上述两个参数 scene=0才生效,即分享到会话的场景才生效。

# 调用示例

wx.miniapp.shareImageMessage({
  imagePath: '/pages/share.png',
  thumbPath: '/pages/thumb.png',
  scene: 0, 
  success(res) {
    wx.showToast({
      title: '成功:分享图片',
    })
  },
  fail() {
    wx.showToast({
      title: '失败:分享图片',
    })
  }
})