目录

社交通讯全场景协同

概述

在办公、创作和社区交友等应用中,内容发布和浏览分享是用户互动与交流的核心。它允许用户创作并分享包含图片、视频、文字等多媒体信息,从而增强用户间的连接与互动。随着手机、平板、电脑等电子设备的普及,用户对跨设备处理图片/视频/文字及接续编辑内容、在不同设备间无缝切换及快速便捷分享内容的需求日益增长。本文介绍如何通过跨端迁移和多端协同功能,实现不同设备间的快速无缝切换,提升内容发布和浏览分享的便利性。

本文主要包含以下几个方面内容:

用户体验

[h2]体验

特性

体验视频

跨设备互通

跨设备拖拽

跨设备剪贴

跨设备应用接续

碰一碰插入图片

碰一碰分享页面

隔空传送分享页面

[h2]使用限制

限制\场景

跨设备互通

跨设备拖拽

跨设备剪贴

跨设备应用接续

碰一碰分享

隔空传送分享

HarmonyOS NEXT及以上版本的设备

√

√

√

√

√

√

登录同一个华为账号

√

√

√

√

  • 手机与手机碰一碰分享不需要。
  • 手机与电脑碰一碰分享需要。

NA

打开Wi-Fi和蓝牙开关

√

√

√

√

NA

NA

设备需解锁、亮屏

NA

NA

√

NA

√

√

设备类型(垂域常见设备手机、平板、电脑)

  • 本端设备:平板或电脑设备。
  • 远端设备:具有相机能力的手机或平板设备。

必须有电脑设备接入,或者部分支持电脑模式的平板设备接入。

手机、平板、电脑

手机、平板、电脑

  • 本端设备:手机设备。
  • 对端设备:手机、平板(6.1.0(23)版本开始)、电脑设备。仅支持直板手机或折叠手机直板态与电脑屏幕碰一碰分享。

手机、平板、电脑

在"设置>多设备协同"中开启相应功能

√

开启键鼠共享开关。

开启跨设备剪贴板开关。

开启接续开关。

NA

NA

其他

支持根据特定调用策略调用设备,详见“约束与限制>使用限制”中的调用策略部分。

需接入同一个局域网且应用本身预置的资源文件(即应用在安装前的HAP包中已经存在的资源文件)不支持跨设备拖拽。

NA

双端设备都需要安装该应用。

已开启华为分享服务(系统默认开启)。手机与电脑碰一碰交互约束详见使用约束的轻碰屏幕交互约束部分。

需打开设备侧隔空传送开关。

跨设备互通

[h2]场景描述

用户在平板或电脑上使用文本编辑应用(如备忘录、邮件、笔记等)时,若当前设备不便拍摄,可利用跨设备互通功能,直接调用手机或平板的相机完成拍摄,也可从其图库中选择图片或视频。手机和平板设备在拍摄灵活性、取景便利性及相机性能上更具优势。所选素材将快速传输至原设备的应用中,帮助用户高效完成图文编辑任务。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:跨设备互通开发指导中的约束与限制章节。

[h2]实现原理

场景分析

  1. 用户在本端(平板或电脑)应用界面操作,选择使用远端设备的拍照、扫描或图库功能,向远端发起请求。
  2. 系统将自动唤醒远端设备上的相机、图库或扫描,进入相应的界面。
  3. 使用远端设备完成拍照或选择图片/视频并确认,远端拍摄状态信息实时回传到本端,并将数据插入到本端设备的应用中。

关键技术

跨设备互通的核心在于使用HarmonyOS的分布式协同框架:

  1. 设备发现:通过createCollaborationServiceMenuItems组件获取组网内具有对应能力的设备列表。
  2. 远端唤醒:系统自动唤醒远端设备上的相机、图库或扫描功能。
  3. 状态回传:通过CollaborationServiceStateDialog组件实时回传远端拍摄状态信息。
  4. 数据接收:在onState()回调中处理接收到的数据。

在分布式协同框架下,针对跨设备互通图片/视频信息的业务场景,应用只需要调用createCollaborationServiceMenuItems(相机设备列表组件)和CollaborationServiceStateDialog(远端相机状态弹窗组件)两个组件,即可实现跨端拍照、扫描、图库访问功能,开发者无需关注分布式场景下的数据传输和指令控制等细节,具体运作机制可参考:跨设备互通特性简介中的运作机制章节。

[h2]实现方案

跨设备拖拽图片/文字

[h2]场景描述

当用户拥有多台设备时,开启键鼠共享功能,可以实现键鼠在不同设备间的自由移动。通过跨设备拖拽,用户可以轻松地将本端上的素材拖拽到远端,快速完成内容创作,享受高效的跨设备协同工作体验。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:跨设备拖拽中的约束与限制章节。

[h2]实现原理

场景分析

  1. 用户通过长按鼠标触发拖拽事件,可以从本端编辑页面将图片或文字拖拽到远端的编辑页面。
  2. 在此过程中,系统自动处理跨设备的数据传输,开发者无需介入。
  3. 当用户释放鼠标时,触发拖拽松手事件,远端应用处理接收到的拖拽数据,并将其写入远端编辑页面。

关键技术

在开发跨设备拖拽功能时,系统会自动处理鼠标的跨设备操作及数据传递。应用可以根据实际需求,实现组件的拖入或拖出,完成拖拽事件的开发。具体运作机制可参考:跨设备拖拽中的运作机制章节。

[h2]实现方案

跨设备剪贴图片/视频/文字

[h2]场景描述

当用户拥有多台设备时,可以利用跨设备剪贴板的功能,在本端的应用中复制文本、图片或视频,并在远端的应用中粘贴,实现高效的内容共享。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:跨设备剪贴板中的约束与限制章节。

[h2]实现原理

场景分析

1. 用户在本端复制数据,写入到系统剪贴板服务。

2. 系统剪贴板服务处理数据并完成同步,此过程开发者不感知。

3. 用户在远端读取系统剪贴板内容,粘贴来自本端的数据。

关键技术

在开发跨设备剪贴板功能时,系统会自动处理设备间的数据传输,应用程序可根据实际需求接入跨设备剪贴板,实现跨设备间的数据共享。具体运作机制可参考:跨设备剪贴板中的运作机制章节。

[h2]实现方案

跨设备应用接续

[h2]场景描述

在用户使用过程中,使用场景发生了变化,之前使用的设备不再适合继续当前任务,或者周围有更合适的设备,此时用户可以选择使用新的设备来继续当前的任务。接续完成后,之前设备的应用可退出或保留,用户可以将注意力集中在被拉起的设备上,继续执行任务。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:应用接续概述中的约束限制章节。

[h2]实现原理

场景分析

  1. 输入数据:用户在本端设备的编辑页面上选择照片/视频、输入标题和正文等文字信息。
  2. 用户点击远端设备Dock栏图标后,本端设备发起接续,数据进行传输。
  3. 远端设备接收接续数据并显示。

场景核心在于应用接续的过程中如何传递数据。对于文字信息可使用分布式数据对象保存,对于图片/视频可以拷贝到分布式文件目录下,使用分布式数据资产作为分布式数据对象的根属性保存。

关键技术

将发起接续的设备称为本端设备,接收数据的设备称为远端设备,接续过程底层依赖分布式框架和软总线,开发者只需要启用接续、保存数据和恢复数据,具体运作机制可参考:应用接续概述中的运作机制章节。

[h2]实现方案

碰一碰插入图片

[h2]场景描述

在多设备协同场景中,用户可以通过碰一碰将手机端的图片快速传输到电脑端。例如在手机端浏览图库中的图片,然后碰一碰将图片插入到电脑端的应用中。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:手机与电脑碰一碰分享概述中的使用约束章节。

[h2]实现原理

场景分析

  1. 用户在手机设备上浏览图库中的图片,选中想插入的图片。
  2. 基于图库的碰一碰分享功能,手机顶端轻触电脑屏幕拉起碰一碰分享界面后分享图片。
  3. 电脑端接收到分享的图片后,插入到应用页面中。

具体流程可参考:手机与电脑碰一碰分享概述中业务流程章节的“电脑设备作为数据接收端”部分。

关键技术

电脑端接收碰一碰插入图片的核心在于使用harmonyShare的数据接收功能:

  1. 注册数据接收监听:通过harmonyShare.on('dataReceive')注册数据接收监听。
  2. 设置接收能力:定义支持的数据类型和最大数量。
  3. 处理接收数据:在onDataReceived()回调中处理接收到的文件数据。
  4. 转换为PixelMap:将接收到的图片数据转换为PixelMap用于显示。

[h2]实现方案

  1. 注册数据接收监听:在电脑端应用注册on('dataReceive')监听,接收手机端发送的数据。
    /**
     * Add dataReceive listening in 2in1 device type.
     */
    public dataReceiveListeningPC(uiContext: UIContext) {
      if (!canIUse('SystemCapability.Collaboration.HarmonyShare')) {
        return;
      }
      window.getLastWindow(this.context).then(((data) => {
        try {
          let mainWindowID: number = data.getWindowProperties().id;
          harmonyShare.on('dataReceive', {
            windowId: mainWindowID, capabilities: [
              {
                'utd': uniformTypeDescriptor.UniformDataType.MEDIA,
                'maxSupportedCount': 5
              },
              {
                'utd': uniformTypeDescriptor.UniformDataType.FILE,
                'maxSupportedCount': 5
              }
            ]
          },
            (receiveTarget: harmonyShare.ReceivableTarget) => {
              if (!this.context) {
                return;
              }
    
              // Process the received file data.
              receiveTarget.receive(fileUri.getUriFromPath(this.context.filesDir), {
                onDataReceived: (shareData: systemShare.SharedData) => {
                  // ...
                },
                onResult(resultCode: harmonyShare.ShareResultCode) {
                  if (resultCode === harmonyShare.ShareResultCode.SHARE_SUCCESS) {
                    hilog.info(DOMAIN, TAG, FORMAT, 'receive file success');
                  } else {
                    hilog.error(DOMAIN, TAG, FORMAT, 'receive failed ' + resultCode);
                  }
                }
              });
            });
        } catch (error) {
          hilog.error(DOMAIN, TAG, FORMAT, `getWindowProperties error ${error.code} ${error.message}`);
        }
      })).catch((error: BusinessError) => {
        hilog.error(DOMAIN, TAG, FORMAT, `failed to obtain the window. cause ${error.code} ${error.message}`);
      });
    }
  2. 处理接收到的图片数据:自定义实现ReceiveCallback()回调函数,在该回调函数中处理接收的数据。例如此处将接收到的图片数据转换为PixelMap,用于在应用中显示。
    let shareRecords = shareData.getRecords();
    let mediaUriArray = AppStorage.get('mediaUriArray') as Array<MediaInfo>;
    shareRecords.forEach(async (record: systemShare.SharedRecord) => {
      if (!record.uri) {
        return;
      }
      let fileName = record.uri.split('/').pop()?.split('.')[0];
      if (record.uri.endsWith('png') || record.uri.endsWith('jpg') || record.uri.endsWith('jpeg')) {
        let imageUri = record.uri;
        let file = fileIo.openSync(imageUri, fileIo.OpenMode.READ_ONLY);
        let imageSourceApi: image.ImageSource | undefined = undefined;
        try {
          imageSourceApi = image.createImageSource(file.fd);
        } catch (err) {
          hilog.error(DOMAIN, TAG, FORMAT,
            `CreateImageSource error: ${(err as BusinessError).code} ${(err as BusinessError).message}`);
        } finally {
          fileIo.closeSync(file.fd);
        }
        const imagePackApi = image.createImagePacker();
        let packOpts: image.PackingOption = { format: 'image/png', quality: 100 };
        imagePackApi.packToData(imageSourceApi!, packOpts).then(async readBuffer => {
          let imageSource: image.ImageSource = image.createImageSource(readBuffer as ArrayBuffer);
          let option: image.InitializationOptions = {
            pixelFormat: 3,
            size: {
              width: 100,
              height: 100
            }
          };
          imageSource.createPixelMap(option).then((pixelMap: PixelMap) => {
            if (mediaUriArray.length < CommonConstants.MAX_ADD_MEDIA_NUM) {
              mediaUriArray.push({
                imagePixelMap: pixelMap,
                mediaName: fileName,
                mediaType: MediaType.MEDIA_IMAGE
              });
            } else {
              try {
                uiContext.getPromptAction().showToast({ message: $r('app.string.add_picture_prompt') });
              } catch (err) {
                hilog.error(DOMAIN, TAG, FORMAT,
                  `ShowToast failed. Cause code: ${(err as BusinessError).code}, message: ${(err as BusinessError).message}`);
              }
            }
            imageSource.release();
            imageSource = undefined;
            imageSourceApi?.release();
            imageSourceApi = undefined;
          });
        }).catch((err: BusinessError) => {
          hilog.error(DOMAIN, TAG, FORMAT,
            `PackToData failed. Cause code: ${err.code}, message: ${err.message}`);
        });
      }
    });
  3. 取消数据接收监听:离开可分享页面(包括应用退至后台等场景)时,取消隔空传送分享监听事件,释放资源。
    /**
     *  Remove dataReceive listening.
     */
    public dataReceiveDisableListeningPC() {
      if (!canIUse('SystemCapability.Collaboration.HarmonyShare')) {
        return;
      }
      window.getLastWindow(this.context).then(((data) => {
        try {
          let mainWindowID: number = data.getWindowProperties().id;
          harmonyShare.off('dataReceive', {
            windowId: mainWindowID, capabilities: [
              {
                'utd': uniformTypeDescriptor.UniformDataType.MEDIA,
                'maxSupportedCount': 5
              },
              {
                'utd': uniformTypeDescriptor.UniformDataType.FILE,
                'maxSupportedCount': 5
              }
            ]
          });
        } catch (error) {
          hilog.error(DOMAIN, TAG, FORMAT, `getWindowProperties error ${error.code} ${error.message}`);
        }
      })).catch((error: BusinessError) => {
        hilog.error(DOMAIN, TAG, FORMAT, `failed to obtain the window. cause ${error.code} ${error.message}`);
      });
    }

碰一碰分享页面

[h2]场景描述

在多设备协同场景中,用户可以通过碰一碰将当前页面分享到另一台设备。例如在手机端浏览到感兴趣的内容页面,然后碰一碰将页面分享到附近的设备打开。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:

[h2]实现原理

场景分析

1. 用户在本端打开应用,点进待分享的浏览详情页。

2. 将本端设备与远端设备进行碰一碰操作。本端设备触发碰一碰分享面板,上滑分享。

3.远端设备弹出接收面板,点击接收可以直达应用分享页面。若点击拒绝,则本端设备上会显示分享被拒绝的提示弹框。

关键技术

碰一碰分享页面的核心在于支持通过碰一碰跨端分享链接。详情可参考碰一碰链接分享。

[h2]实现方案

1. 配置App Linking服务。为了通过碰一碰分享实现直达应用的功能,应用需集成App Linking,以确保端到端体验的完整性。具体配置方式可参考配置App Linking服务章节。

{
  "module": {
    // ...
    "abilities": [
      {
        "name": "EntryAbility",
        // ...
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home",
              // entities must contain "entity.system.browsable"
              "entity.system.browsable"
            ],
            "actions": [
              "action.system.home",
              // Actions must contain "ohos.want.action.viewData"
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                // The scheme must be configured as https
                "scheme": "https",
                // The host must be configured as the associated domain name
                "host": "www.example.com",
                "path": ""
              }
            ],
            // domainVerify must be set to true
            "domainVerify": true
          }
        ],
        // ...
      }
    ],
    // ...
  }
}

2. 注册碰一碰事件的监听on('knockShare')和取消监听off('knockShare')。

/**
 *  Add knock listening.
 */
public immersiveListening() {
  if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
    harmonyShare.on('knockShare', (target: harmonyShare.SharableTarget) => {
      this.immersiveCallback(target);
    });
  }
}

/**
 *  Add knock listening in 2in1 device type.
 */
public immersiveListeningPC() {
  if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
    window.getLastWindow(this.context).then((data) => {
      try {
        let mainWindowID: number = data.getWindowProperties().id;
        harmonyShare.on('knockShare', { windowId: mainWindowID }, (target: harmonyShare.SharableTarget) => {
          this.immersiveCallback(target);
        });
      } catch (err) {
        hilog.error(DOMAIN, TAG, FORMAT,
          `GetWindowProperties error: ${(err as BusinessError).code} ${(err as BusinessError).message}`);
      }
    }).catch((error: BusinessError) => {
      hilog.error(DOMAIN, TAG, FORMAT, `GetLastWindow failed. Error: ${error.code} ${error.message}`);
    });
  }
}

/**
 *  remove knock listening.
 */
public immersiveDisableListening() {
  if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
    harmonyShare.off('knockShare');
  }
}

/**
 *  remove knock listening.
 */
public immersiveDisableListeningPC() {
  if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
    window.getLastWindow(this.context).then((data) => {
      try {
        let mainWindowID: number = data.getWindowProperties().id;
        harmonyShare.off('knockShare', { windowId: mainWindowID });
      } catch (err) {
        hilog.error(DOMAIN, TAG, FORMAT,
          `GetWindowProperties error ${(err as BusinessError).code} ${(err as BusinessError).message}`);
      }
    }).catch((error: BusinessError) => {
      hilog.error(DOMAIN, TAG, FORMAT, `GetLastWindow failed. Error: ${error.code} ${error.message}`);
    });
  }
}

3. 本端构建分享数据并发起分享。构造分享数据记录ShareRecord,并设置其utd属性为uniformTypeDescriptor.UniformDataType.HYPERLINK(属性含义可参考UniformDataType),content属性则设置为对应的页面链接。构造完成后,调用sharableTarget的share()方法发起分享。

/**
 * Knock listening callback.
 *
 * @param target After the Huawei Share event is triggered,
 * you can call back the parameters and share them across devices.
 */
public immersiveCallback(target: harmonyShare.SharableTarget) {
  let shareData: systemShare.SharedData = this.getLinkShareData();
  target.share(shareData);
}

/**
 * Get link share data.
 * @returns systemShare.SharedData.
 */
getLinkShareData(): systemShare.SharedData {
  let encodedParams = encodeURIComponent(JSON.stringify(this.pageParamsData));
  let title: string = CommonConstants.STRING_DEFAULT_VALUE;
  try {
    title = this.context!.resourceManager.getStringSync(this.pageParamsData?.userName.id);
  } catch (err) {
    hilog.error(DOMAIN, TAG, FORMAT,
      `resourceManager getStringSync error: ${(err as BusinessError).code} ${(err as BusinessError).message}`);
  }
  // share app linking.
  let shareData: systemShare.SharedData = new systemShare.SharedData({
    // Set the shared data type to Link.
    utd: uniformTypeDescriptor.UniformDataType.HYPERLINK,
    // title
    title: title,
    // description
    description: this.pageParamsData?.title,
    // The shared App Linking link is replaced with the real address here.
    content: `${CommonConstants.SHARE_URL_SCHEME}://www.example.com?pageUrl=${this.pageUrl}&pageParams=${encodedParams}&sharingMechanism=knockShare`,
  });
  return shareData;
}

4.(对端已安装应用)对端在onCreate()与onNewWant()生命周期中获取链接中目标页面及传参等信息,供后续跳转使用。

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // ...

  let pageUrl = getValueFromWant(want, 'pageUrl');
  let pageParams = getValueFromWant(want, 'pageParams');
  let shareMechanism = getValueFromWant(want, 'sharingMechanism');
  if (pageUrl !== '') {
    if (shareMechanism === 'gesturesShare') {
      // ...
    } else if (shareMechanism === 'knockShare') {
      AppStorage.setOrCreate(CommonConstants.KNOCK_SHARE_SHARE_PAGE_URL, pageUrl);
      AppStorage.setOrCreate(CommonConstants.KNOCK_SHARE_SHARE_PAGE_PARAMS, pageParams);
      AppStorage.setOrCreate(CommonConstants.KNOCK_SHARE_IS_SHARE_LINK, true);
    }
  }
  hilog.info(DOMAIN, TAG, FORMAT, `onCreate() pageUrl: ${pageUrl} pageParams:${pageParams}`);
}

onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // ...
  let pageUrl = getValueFromWant(want, 'pageUrl');
  let pageParams = getValueFromWant(want, 'pageParams');
  let shareMechanism = getValueFromWant(want, 'sharingMechanism');
  if (pageUrl !== '') {
    if (shareMechanism === 'gesturesShare') {
      // ...
    } else if (shareMechanism === 'knockShare') {
      AppStorage.setOrCreate(CommonConstants.KNOCK_SHARE_SHARE_PAGE_URL, pageUrl);
      AppStorage.setOrCreate(CommonConstants.KNOCK_SHARE_SHARE_PAGE_PARAMS, pageParams);
      AppStorage.setOrCreate(CommonConstants.KNOCK_SHARE_IS_SHARE_LINK, true);
    }
  }
  hilog.info(DOMAIN, TAG, FORMAT, `onNewWant() pageUrl: ${pageUrl} pageParams:${pageParams}`);
}

可以将解析逻辑统一封装到工具方法,方便后续调用。

export function getValueFromWant(want: Want, key: string): string {
  let value: string = '';
  try {
    let uri = want?.uri;
    if (!uri) {
      hilog.error(DOMAIN, TAG, FORMAT, `Failed to getValueFromWant, uri is undefined.`);
      return value;
    }
    // Parse the parameters to obtain the app linking
    let urlObject = url.URL.parseURL(want?.uri);
    if (key !== 'pageParams') {
      value = urlObject.params.get(key) as string;
      return value;
    }
    let encodedData = urlObject.params.get(key);
    if (encodedData) {
      value = decodeURIComponent(encodedData);
    }
    return value;
  } catch (err) {
    let error = err as BusinessError;
    hilog.error(DOMAIN, TAG, FORMAT, `Failed to getValueFromWant, error: ${error.code} ${error.message}`);
  }
  return value;
}

隔空传送分享页面

[h2]场景描述

在多设备协同场景中,用户可以通过隔空手势将当前页面分享到另一台设备。例如在手机端浏览内容,通过“一抓一放”手势将页面分享到附近的设备。

该功能的使用需满足设备限制和使用限制,具体约束与限制可参考:使用限制。

[h2]实现原理

场景分析

1. 用户在本端打开应用,点进待分享的浏览详情页。

2. 在本端设备执行隔空传送“抓”手势后,在远端设备执行隔空传送“放”手势。

3. 远端设备识别成功后,可以直达应用分享页面。

关键技术

隔空传送基于分享服务,应用通过监听harmonyShare.on('gesturesShare')事件,支持用户通过简单的“一抓一放”手势实现跨端分享。详情可参考关键技术。

[h2]实现方案

1.配置App Linking服务。为了通过隔空传送分享实现直达应用的功能,应用需集成App Linking,以确保端到端体验的完整性。具体配置方式可参考配置App Linking服务章节。

{
  "module": {
    // ...
    "abilities": [
      {
        "name": "EntryAbility",
        // ...
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home",
              // entities must contain "entity.system.browsable"
              "entity.system.browsable"
            ],
            "actions": [
              "action.system.home",
              // Actions must contain "ohos.want.action.viewData"
              "ohos.want.action.viewData"
            ],
            "uris": [
              {
                // The scheme must be configured as https
                "scheme": "https",
                // The host must be configured as the associated domain name
                "host": "www.example.com",
                "path": ""
              }
            ],
            // domainVerify must be set to true
            "domainVerify": true
          }
        ],
        // ...
      }
    ],
    // ...
  }
}

2.注册隔空传送事件的监听on('gesturesShare')和取消监听off('gesturesShare')。

/**
 *  Add gesturesShare listening.
 */
public immersiveListening(shareType: ShareType) {
  if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
    window.getLastWindow(this.context).then((data) => {
      try {
        let mainWindowID: number = data.getWindowProperties().id;
        harmonyShare.on('gesturesShare', { windowId: mainWindowID }, (target: harmonyShare.SharableTarget) => {
          this.immersiveCallback(target, shareType);
        });
      } catch (err) {
        let error = err as BusinessError;
        hilog.error(DOMAIN, TAG, FORMAT, `getWindowProperties error ${error.code} ${error.message}`);
      }
    }).catch((error: BusinessError) => {
      hilog.error(DOMAIN, TAG, FORMAT, `immersiveListening error ${error.code} ${error.message}`);
    })
  }
}

/**
 *  Remove gesturesShare listening.
 */
public immersiveDisableListening() {
  if (canIUse('SystemCapability.Collaboration.HarmonyShare')) {
    window.getLastWindow(this.context).then((data) => {
      try {
        let mainWindowID: number = data.getWindowProperties().id;
        harmonyShare.off('gesturesShare', { windowId: mainWindowID });
      } catch (error) {
        let err = error as BusinessError;
        hilog.error(DOMAIN, TAG, FORMAT, `getWindowProperties error ${err.code} ${err.message}`);
      }
    }).catch((error: BusinessError) => {
      hilog.error(DOMAIN, TAG, FORMAT, `immersiveDisableListening error ${error.code} ${error.message}`);
    })
  }
}

3.本端构建分享数据并发起分享。构造分享数据记录ShareRecord,并设置其utd属性为uniformTypeDescriptor.UniformDataType.HYPERLINK,content属性则设置为对应的页面链接。构造完成后,调用sharableTarget的share()方法发起分享。

public immersiveCallback(target: harmonyShare.SharableTarget, shareType: ShareType) {
  if (shareType === ShareType.LINK_SHARE) {
    let shareData: systemShare.SharedData = this.getLinkShareData();
    target.share(shareData);
  }
}


/**
 * Get link share data.
 * @returns systemShare.SharedData.
 */
getLinkShareData(): systemShare.SharedData {
  let encodedParams = encodeURIComponent(JSON.stringify(this.pageParamsData));
  let title: string = CommonConstants.STRING_DEFAULT_VALUE;
  try {
    title = this.context!.resourceManager.getStringSync(this.pageParamsData?.userName.id);
  } catch (err) {
    hilog.error(DOMAIN, TAG, FORMAT,
      `resourceManager getStringSync error: ${(err as BusinessError).code} ${(err as BusinessError).message}`);
  }
  // share app linking.
  let shareData: systemShare.SharedData = new systemShare.SharedData({
    // Set the shared data type to Link.
    utd: uniformTypeDescriptor.UniformDataType.HYPERLINK,
    // title
    title: title,
    // description
    description: this.pageParamsData?.title,
    // The shared App Linking link is replaced with the real address here.
    content: `${CommonConstants.SHARE_URL_SCHEME}://www.example.com?pageUrl=${this.pageUrl}&pageParams=${encodedParams}&sharingMechanism=gesturesShare`,
  });
  return shareData;
}

4.(对端已安装应用)对端在onCreate()与onNewWant()生命周期中获取链接中目标页面及传参等信息,供后续跳转使用。

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // ...

  let pageUrl = getValueFromWant(want, 'pageUrl');
  let pageParams = getValueFromWant(want, 'pageParams');
  let shareMechanism = getValueFromWant(want, 'sharingMechanism');
  if (pageUrl !== '') {
    if (shareMechanism === 'gesturesShare') {
      AppStorage.setOrCreate(CommonConstants.GESTURES_SHARE_SHARE_PAGE_URL, pageUrl);
      AppStorage.setOrCreate(CommonConstants.GESTURES_SHARE_SHARE_PAGE_PARAMS, pageParams);
      AppStorage.setOrCreate(CommonConstants.GESTURES_SHARE_IS_SHARE_LINK, true);
    } else if (shareMechanism === 'knockShare') {
      // ...
    }
  }
  hilog.info(DOMAIN, TAG, FORMAT, `onCreate() pageUrl: ${pageUrl} pageParams:${pageParams}`);
}

onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {
  // ...
  let pageUrl = getValueFromWant(want, 'pageUrl');
  let pageParams = getValueFromWant(want, 'pageParams');
  let shareMechanism = getValueFromWant(want, 'sharingMechanism');
  if (pageUrl !== '') {
    if (shareMechanism === 'gesturesShare') {
      AppStorage.setOrCreate(CommonConstants.GESTURES_SHARE_SHARE_PAGE_URL, pageUrl);
      AppStorage.setOrCreate(CommonConstants.GESTURES_SHARE_SHARE_PAGE_PARAMS, pageParams);
      AppStorage.setOrCreate(CommonConstants.GESTURES_SHARE_IS_SHARE_LINK, true);
    } else if (shareMechanism === 'knockShare') {
      // ...
    }
  }
  hilog.info(DOMAIN, TAG, FORMAT, `onNewWant() pageUrl: ${pageUrl} pageParams:${pageParams}`);
}

可以将解析逻辑统一封装到工具方法,方便后续调用。

export function getValueFromWant(want: Want, key: string): string {
  let value: string = '';
  try {
    let uri = want?.uri;
    if (!uri) {
      hilog.error(DOMAIN, TAG, FORMAT, `Failed to getValueFromWant, uri is undefined.`);
      return value;
    }
    // Parse the parameters to obtain the app linking
    let urlObject = url.URL.parseURL(want?.uri);
    if (key !== 'pageParams') {
      value = urlObject.params.get(key) as string;
      return value;
    }
    let encodedData = urlObject.params.get(key);
    if (encodedData) {
      value = decodeURIComponent(encodedData);
    }
    return value;
  } catch (err) {
    let error = err as BusinessError;
    hilog.error(DOMAIN, TAG, FORMAT, `Failed to getValueFromWant, error: ${error.code} ${error.message}`);
  }
  return value;
}

示例代码