更新记录

1.0.0（2026-01-28） 下载此版本

• 初始版本发布
• 支持 HarmonyOS 隔空传送分享功能
• 支持图片分享
• 支持注册和注销监听

平台兼容性

uni-app(4.81)

jack-gestures-share

隔空传送分享插件，支持 HarmonyOS 平台的隔空传送功能。

功能说明

本插件封装了 HarmonyOS 的隔空传送（Gestures Share）功能，允许用户通过手势操作将图片分享到附近的设备。

平台支持

• ✅ HarmonyOS (app-harmony)
• ❌ Android
• ❌ iOS
• ❌ Web
• ❌ 小程序

使用方法

1. 导入插件

// #ifdef APP-HARMONY
import "@/uni_modules/jack-gestures-share"
// #endif

2. 注册隔空传送分享

uni.registerGesturesShare({
  imagePath: '/path/to/image.jpg',
  success: (res) => {
    console.log('注册成功:', res)
    uni.showToast({
      title: '请使用隔空传送手势分享',
      icon: 'none'
    })
  },
  fail: (err) => {
    console.error('注册失败:', err)
    uni.showToast({
      title: '隔空传送功能不可用',
      icon: 'none'
    })
  }
})

3. 注销隔空传送分享

// 在页面隐藏或组件销毁时注销
uni.unregisterGesturesShare()

完整示例

<template>
  <view>
    <button @click="shareImage">生成并分享</button>
  </view>
</template>

<script>
// #ifdef APP-HARMONY
import "@/uni_modules/jack-gestures-share"
// #endif

export default {
  data() {
    return {
      isSharing: false
    }
  },

  onHide() {
    // 页面隐藏时注销
    // #ifdef APP-HARMONY
    if (this.isSharing) {
      uni.unregisterGesturesShare()
      this.isSharing = false
    }
    // #endif
  },

  methods: {
    async shareImage() {
      // 生成图片
      const imagePath = await this.generateImage()

      // #ifdef APP-HARMONY
      uni.registerGesturesShare({
        imagePath: imagePath,
        success: (res) => {
          this.isSharing = true
          uni.showToast({
            title: '请使用隔空传送手势分享',
            icon: 'none',
            duration: 3000
          })
        },
        fail: (err) => {
          console.error('注册失败:', err)
          uni.showToast({
            title: '隔空传送功能不可用',
            icon: 'none'
          })
        }
      })
      // #endif
    },

    async generateImage() {
      // 生成图片的逻辑
      return '/path/to/generated/image.jpg'
    }
  }
}
</script>

API 说明

uni.registerGesturesShare(options)

注册隔空传送分享监听。

参数说明：

success 返回参数：

fail 返回参数：

uni.unregisterGesturesShare()

注销隔空传送分享监听。

注意事项：

1. 必须在页面隐藏或组件销毁时调用此方法注销监听
2. 避免内存泄漏和重复注册

注意事项

1. 窗口焦点：隔空传送功能需要应用窗口获得焦点才能触发
2. 超时控制：从触发事件到调用分享需在 3 秒内完成
3. 生命周期管理：确保页面隐藏或退至后台时取消监听
4. 图片路径：必须使用本地临时文件路径，不支持网络图片
5. 设备支持：需要 HarmonyOS 设备支持隔空传送功能

更新日志

1.0.0 (2024-01-23)

• 初始版本
• 支持图片隔空传送分享
• 支持注册和注销监听