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

跨设备互通提供跨设备的相机、扫描、图库访问能力，平板或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;@BuilderMyTestMenu() {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、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述