一碰即传,重构跨设备文件分享体验

用户在分享图片、文件或热点时,需经历复杂的操作流程(如打开应用、选择文件、搜索设备、确认传输等),步骤繁琐且耗时;或者需要用户打断当前操作(如暂停视频播放、退出游戏界面),导致体验不连贯。

HarmonyOS SDK 分享服务(Share Kit)推出了"碰一碰分享"能力,支持用户通过碰一碰发起跨端分享,可实现传输图片、共享WI-FI等。只需轻轻触碰两台设备,即可完成内容的传递。

功能场景

  • 宿主应用进入一个可以分享的界面,比如打开或者选中的一个文件、一条备忘录、一个联系人详情,或个人热点/WIFI等。

  • 宿主应用可以分享多个内容,如选中的多张图片等。

简单触碰:当您想要分享某些内容时,只需将两台设备在亮屏、解锁的状态下并且都已开启华为分享服务(系统默认开启),设备顶部轻碰即可触发。

即时反馈:一旦设备接触成功,"碰一碰分享"会立即给出反馈,告知用户分享是否已经开始以及进度情况,用户可以清楚地知道分享的状态,避免不确定性带来的困扰。

无缝切换:分享完成后,用户可以直接返回到之前的活动或者选择查看已发送/接收的内容。

除了便捷的操作流程外,"碰一碰分享"还支持多种类型的内容分享,涵盖了日常生活中大多需要共享的信息形式,比如文本材料、图片视频和音频文件等。

开发步骤

配置开发环境

支持的设备类型:当前仅支持手机碰手机。

支持的手机系统:双端需HarmonyOS NEXT 5.0.0.102 SP6及以上版本,可使用canIUse进行判断。

复制代码
if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
  // 支持一碰分享的能力.
}

集成开发环境:DevEco Studio NEXT Beta1及以上版本。

开发流程

开发示例

以分享App Linking直达应用为例,展示如何通过碰一碰分享实现直达应用,应用需接入App Linking以确保端到端完整的体验。操作步骤请参考:使用App Linking实现应用间跳转。

  1. 导入相关模块

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

  2. 定义碰一碰分享事件监听/取消监听方法(收到碰一碰分享事件回调后,需尽快调用sharableTarget.share()方法发起分享,超过3秒可能会失败)。

    private immersiveCallback(sharableTarget: harmonyShare.SharableTarget) {
    const contextFaker: Context = getContext(this);
    let filePath = contextFaker.filesDir + '/exampleKnock1.jpg';
    let shareData: systemShare.SharedData = new systemShare.SharedData({
    utd: utd.UniformDataType.HYPERLINK,
    content: 'https://sharekitdemo.drcn.agconnect.link/ZB3p',
    // 根据title,description,thumbnailUri会生成不同的卡片模板,具体可参考配套卡片模板章节。
    thumbnailUri: fileUri.getUriFromPath(filePath),
    title: '碰一碰分享卡片标题',
    description: '碰一碰分享卡片描述'
    });
    sharableTarget.share(shareData);
    }

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

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

  3. 进入可分享页面时,注册碰一碰分享监听事件;离开可分享页面(包括应用退至后台等场景)时,取消碰一碰分享监听事件。

    // Entry Component 代码片段
    onPageHide(): void {
    let context = getContext(this);
    context.eventHub.emit('onBackGround');
    }

    aboutToAppear(): void {
    this.immersiveListening();
    let context = getContext(this);
    context.eventHub.on('onBackGround', this.onBackGround);
    }

    aboutToDisappear(): void {
    this.immersiveDisablingListening();
    let context = getContext(this);
    context.eventHub.on('onBackGround', this.onBackGround);
    }

    private onBackGround() {
    this.immersiveDisablingListening();
    }

完整示例代码请参见:碰一碰分享示例代码。

了解更多详情>>

访问分享服务官网

获取碰一碰分享开发指导文档

相关推荐
kymjs张涛22 分钟前
零一开源|前沿技术周刊 #13
ios·harmonyos·apple
缘澄3 小时前
组件基础-List&Tabs
harmonyos
爱笑的眼睛1118 小时前
HarmonyOS TextArea 组件:文本输入区域的简单使用指南
华为·harmonyos
前端世界18 小时前
鸿蒙异步处理从入门到实战:Promise、async/await、并发池、超时重试全套攻略
华为·harmonyos
祥睿夫子19 小时前
鸿蒙ArkTS开发:Number、Boolean、String三种核心基本数据类型详解(附实战案例)
harmonyos·arkts
小喷友20 小时前
第5章 高级UI与动画
前端·app·harmonyos
whysqwhw20 小时前
鸿蒙ArkTS 与 Native 交互场景分类总结与关键实现
harmonyos
爱笑的眼睛1120 小时前
HarmonyOS 递归实战:文件夹文件统计案例解析
华为·harmonyos
鸿蒙小白龙21 小时前
openharmony之启动恢复子系统详解
harmonyos·鸿蒙·鸿蒙系统
GeniuswongAir1 天前
交叉编译.so到鸿蒙使用
华为·harmonyos