鸿蒙开发（NEXT/API 12）【跨设备互通开发】远场通信服务

最新推荐文章于 2024-09-30 09:25:50 发布

移动开发技术栈

最新推荐文章于 2024-09-30 09:25:50 发布

阅读量934

点赞数 13

分类专栏：鸿蒙开发文章标签： harmonyos 华为 openharmony 网络鸿蒙信息与通信鸿蒙系统

本文链接：https://blog.csdn.net/m0_70748845/article/details/142442828

版权

鸿蒙开发专栏收录该内容

609 篇文章 16 订阅

订阅专栏

跨设备互通提供跨设备的相机、扫描、图库访问能力，平板或2in1设备可以调用手机的相机、扫描、图库等功能。

场景介绍

您通过此能力实现跨设备交互，可以使用其他设备的相机、扫描和图库功能。

约束与限制

需同时满足以下条件，才能使用该功能：

设备限制
- 本端设备：HarmonyOS版本为HarmonyOS NEXT(4.0)及以上的平板或2in1设备。
- 远端设备：HarmonyOS版本为HarmonyOS NEXT(4.0)及以上、具有相机能力的手机或平板设备。
使用限制
- 双端设备需要登录同一华为账号。
- 双端设备需要打开WLAN和蓝牙开关。
  
  条件允许时，建议双端设备接入同一个局域网，可提升唤醒相机的速度。

接口说明

接口名	描述
[createCollaborationServiceMenuItems]	设备列表选择器，用于获取组网内具有对应相机能力的设备列表。
[CollaborationServiceStateDialog]	弹窗组件，用于提示对端相机拍摄状态。

开发步骤

导入模块。
```
import { createCollaborationServiceMenuItems, CollaborationServiceStateDialog, CollaborationServiceFilter } from '@kit.ServiceCollaborationKit';
```
[createCollaborationServiceMenuItems]是设备列表菜单项模块，传入[CollaborationServiceFilter]的能力枚举值；[CollaborationServiceStateDialog]是状态提示框模块。
在Menu中调用createCollaborationServiceMenuItems添加设备列表选择器，在菜单项内显示设备列表。

说明

在调用[createCollaborationServiceMenuItems]前，需了解：
- 该方法需要在[Menu]组件内调用。
- 该方法是自定义构建函数
传入Array类型的[CollaborationServiceFilter]枚举值即可使用对应能力，目前支持ALL、TAKE_PHOTO、SCAN_DOCUMENT和IMAGE_PICKER。

ALL为预留值，匹配所有业务，功能将在后续拓展，TAKE_PHOTO匹配跨设备拍照能力，SCAN_DOCUMENT匹配跨设备扫描能力，IMAGE_PICKER匹配跨设备图库能力。

如果您对图库回传的图片接收张数有要求，可以在[createCollaborationServiceMenuItems]的第二参数定义可接收的图片上述上限，范围是1到50。

@Builder
MyTestMenu() {
  Menu() {
    createCollaborationServiceMenuItems([CollaborationServiceFilter.ALL], 30) 
  }
}

在build方法中添加弹窗组件[CollaborationServiceStateDialog]，用于提示远端相机拍摄状态和回传数据，需要实现其中的[onState]方法。[CollaborationServiceStateDialog]是全局的提示框，不会对原有布局产生影响。
为弹窗组件绑定和实现[onState]方法，用于接收和处理照片数据。

回调函数的传入参数stateCode是完成状态，buffer是回传的图片数据，可通过状态和图片数据结合自身的业务逻辑实现[onState]方法。

CollaborationServiceStateDialog({
  onState: (stateCode: number, bufferType: string, buffer: ArrayBuffer):void => this.doInsertPicture(stateCode, bufferType, buffer)
})

完整示例

通过以下示例，您可以完成一次调用对端相机拍摄的操作。

import {
  createCollaborationServiceMenuItems,
  CollaborationServiceStateDialog,
  CollaborationServiceFilter
} from '@kit.ServiceCollaborationKit';
import { image } from '@kit.ImageKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

@Entry
@Component
struct Index {
  @State picture: PixelMap | undefined = undefined;

  @Builder
  MyTestMenu() {
    Menu() {
      createCollaborationServiceMenuItems([CollaborationServiceFilter.ALL], 30)
    }
  }

  build() {
    Column({ space: 20 }) {
      CollaborationServiceStateDialog({
        onState: (stateCode: number, bufferType: string, buffer: ArrayBuffer): void => this.doInsertPicture(stateCode, bufferType, buffer)
      })
      Button('使用远端设备进行拍照')
        .type(ButtonType.Normal)
        .borderRadius(10)
        .bindMenu(this.MyTestMenu)

      if (this.picture) {
        Image(this.picture)
          .borderStyle(BorderStyle.Dotted)
          .borderWidth(1)
          .objectFit(ImageFit.Contain)
          .height('80%')
          .onComplete((event) => {
            if (event != undefined) {
              hilog.info(0, "MEMOMOCK", "onComplete " + event.loadingStatus)
            }
          })
      }
    }
    .padding(20)
    .width('100%')
    .alignItems(HorizontalAlign.Center)
  }

  doInsertPicture(stateCode: number, bufferType: string, buffer: ArrayBuffer): void {
    if (stateCode != 0) {
      return
    }
    if (bufferType == "general.image") {
      let imageSource = image.createImageSource(buffer)
      imageSource.createPixelMap().then((pixelMap) => {
        this.picture = pixelMap;
      })
    }
  }
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述