[原创]五指一抓一放，即可实现探屏“取”物、隔空传送-HarmonyOS-看雪安全社区

[原创]五指一抓一放，即可实现探屏“取”物、隔空传送

发表于: 2026-4-7 15:35 11290

[原创]五指一抓一放，即可实现探屏“取”物、隔空传送

HarmonyOS SDK 活跃值

2026-4-7 15:35

11290

跨端分享是应用常备的基础能力，从有线USB到无线WIFI传输，跨端传输能力在不断发展，然而，传统传输场景受到配对条件、网络速度、文件大小等因素影响，已经无法满足用户在工作、游戏以及生活等场景中的高频传输需求。

为此，HarmonyOS SDK 分享服务（Share Kit）新推出了隔空传送分享功能，支持用户使用“一抓一放”的简单手势，通过精准的界面反馈，给予用户强使用感知，并引导用户的每一步操作，从而实现人机交互形式的近距离快速跨端传输。
 
 ![](upload/attach/202604/930821_ZTSNEN8P38R2C27.webp)

隔空传送照片使用场景

通过该能力，跨端传输方式实现了无需配对、无需网络的端到端无感传输，即使在弱网环境仍可稳定传输，让跨设备文件流转从“能用”变成“好用”。

![](upload/attach/202604/930821_3JKHRTX9WQNVVGS.webp)
隔空传送流程图

### 那么，隔空传送能力要如何实现呢？

一、在设备侧打开开关。

首先，使用隔空传送功能前，我们需要在设备侧打开“隔空传送”开关，开启路径为：设置 > 系统 > 快捷启动和手势 > 隔空传送。

二、分享App Linking直达应用

若要实现通过隔空传送分享实现直达应用，应用需要先接入App Linking，使用App Linking实现应用间跳转，以确保端到端完整的体验。

然后，我们导入相关模块。

``` 
import { uniformTypeDescriptor as utd } from '@kit.ArkData';
import { systemShare, harmonyShare } from '@kit.ShareKit';
import { fileUri } from '@kit.CoreFileKit';
```

同时定义隔空传送分享事件监听/取消监听方法，需要注意的是，收到隔空传送分享事件回调后，建议3秒内调用sharableTarget.share()方法发起分享，否则可能导致超时失败。

```
private immersiveCallback = (sharableTarget: harmonyShare.SharableTarget) => {
  let uiContext: UIContext = this.getUIContext();
  let contextFaker: Context = uiContext.getHostContext() as Context;
  let filePath = contextFaker.filesDir + '/exampleKnock1.jpg'; // 仅为示例 请替换正确的文件路径
  let shareData: systemShare.SharedData = new systemShare.SharedData({
    utd: utd.UniformDataType.HYPERLINK,
    content: 'https://sharekitdemo.drcn.agconnect.link/ZB3p',
    thumbnailUri: fileUri.getUriFromPath(filePath),
    title: '隔空传送分享卡片标题',
    description: '隔空传送分享卡片描述'
  });
  sharableTarget.share(shareData);
}

private immersiveListening() {
  harmonyShare.on('gesturesShare', this.immersiveCallback);
}

private immersiveDisablingListening() {
  harmonyShare.off('gesturesShare', this.immersiveCallback);
}
```

当用户进入可分享页面时，使用harmonyShare.on('gesturesShare')方法注册隔空传送分享监听事件；当用户离开可分享页面（包括应用退至后台等场景）时，使用harmonyShare.off('gesturesShare')方法取消隔空传送分享监听事件。

```
// Entry Component 代码片段
onPageHide(): void {
  let uiContext: UIContext = this.getUIContext();
  let context: Context = uiContext.getHostContext() as Context;
  context.eventHub.emit('onBackGround');
}
aboutToAppear(): void {
  this.immersiveListening();
  let uiContext: UIContext = this.getUIContext();
  let context: Context = uiContext.getHostContext() as Context;
  context.eventHub.on('onBackGround', this.onBackGround);
}

aboutToDisappear(): void {
  this.immersiveDisablingListening();
  let uiContext: UIContext = this.getUIContext();
  let context: Context = uiContext.getHostContext() as Context;
  context.eventHub.off('onBackGround', this.onBackGround);
}

private onBackGround = () => {
  this.immersiveDisablingListening();
}
```

随着跨端协同技术的持续演进，传统的文件传输工具可依靠隔空传送能力，进化为全场景服务流转基础设施，期待更多开发者加入共建。

**了解更多详情>>**

访问<a href="elink@705K9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1k6%4g2A6k6r3g2K6i4K6u0r3M7$3S2S2M7X3g2Q4x3X3c8A6L8Y4c8J5L8$3c8#2j5%4c8A6L8$3&6Q4x3@1k6Z5j5g2)9#2k6Y4y4G2N6i4u0U0k6g2)9K6c8r3S2E0M7K6p5`.">分享服务联盟官网</a>

获取<a href="elink@407K9s2c8@1M7s2y4Q4x3@1q4Q4x3V1k6Q4x3V1k6V1k6i4k6W2L8r3!0H3k6i4u0Q4x3X3g2Z5N6h3q4%4k6h3W2Q4x3X3g2U0L8$3#2Q4x3V1k6U0L8$3&6K6N6h3#2W2M7W2)9J5c8X3y4F1i4K6u0r3k6r3!0U0i4K6u0r3K9r3q4J5L8h3!0F1P5h3!0K6i4K6u0V1k6%4g2A6k6r3g2K6i4K6u0r3k6$3g2K6N6s2g2J5k6i4y4Q4x3X3c8K6K9r3q4J5k6g2)9J5k6r3!0$3k6i4u0$3K9h3g2%4i4K6y4r3K9r3q4Q4y4h3k6K6L8%4g2J5j5$3g2Q4x3@1c8Z5L8i4x3I4">隔空传送开发指导文档</a>

冰与火的战歌：Windows内核攻防实战高级班！从零到实战，融合AI与Windows内核攻防全技术栈，打造具备自动化能力的内核开发高手。

收藏・0

点赞・0

打赏

最新回复 (2)
mb_eekvgidg 雪币： 249 活跃值： (175) 能力值： ( LV2，RANK：10 ) 在线值：发帖 0 回帖 28 粉丝 0 关注私信	mb_eekvgidg 2 楼很有内涵，能联系我吗137334010（企鹅 2026-4-7 18:59 0
mb_eekvgidg 雪币： 249 活跃值： (175) 能力值： ( LV2，RANK：10 ) 在线值：发帖 0 回帖 28 粉丝 0 关注私信	mb_eekvgidg 3 楼大神，有问题请教，请联系19153616868 2026-4-9 15:20 0
	游客登录 \| 注册方可回帖回帖表情雪币赚取及消费高级回复

HarmonyOS SDK

258

发帖

190

回帖

RANK

关注

私信

他的文章

关于我们

联系我们

企业服务

看雪公众号

专注于PC、移动、智能设备安全研究及逆向工程的开发者社区

最新回复 (2)
mb_eekvgidg 雪币： 249 活跃值： (175) 能力值： ( LV2，RANK：10 ) 在线值：发帖 0 回帖 28 粉丝 0 关注私信	mb_eekvgidg 2 楼很有内涵，能联系我吗137334010（企鹅 2026-4-7 18:59 0
mb_eekvgidg 雪币： 249 活跃值： (175) 能力值： ( LV2，RANK：10 ) 在线值：发帖 0 回帖 28 粉丝 0 关注私信	mb_eekvgidg 3 楼大神，有问题请教，请联系19153616868 2026-4-9 15:20 0
	游客登录 \| 注册方可回帖回帖表情雪币赚取及消费高级回复