跨设备互通NDK特性概述
============

跨设备互通提供相机、扫描以及图库（图片和视频）的跨设备调用能力，TV、Tablet或PC/2in1设备可以调用Phone的相机、扫描、图库等功能。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/de/v3/tYDVkorZTDSMhCT-AG-k8Q/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=1FB230B349F5BC58BE58E4506CFDE00A0EC5B478DA41A4F1D136349DE3EBF9C2)

本章节以拍照为例展开介绍，扫描、图库功能的使用与拍照类似。

用户在TV、Tablet或PC/2in1设备上使用富文本类编辑应用（如：备忘录、邮件、笔记等）时，想要拍摄一些照片作为素材，但是当前设备拍摄不太方便。通过跨设备互通-拍照，用户可以在当前设备的应用中指定Tablet或Phone设备，并打开Tablet或Phone的相机来拍摄所需的素材。通过Phone或者Tablet设备拍摄，移动更便利、取景更灵巧、相机能力也更强大。拍摄的照片将实现快速回传到TV、Tablet或PC/2in1设备的应用中，帮助用户高效完成图文并茂的文档设计。

如果同一组网下有多台Phone或Tablet设备，用户可以选择不同的设备进行拍摄。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/82/v3/kBp1OSKxQl2xGhbGIuShFw/zh-cn_image_0000002633849214.gif?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=F106A97D563DDF5CE0DCBA71589F8384BA1475B8F562532FE7FD0BDC93D678DE)

#### 运作机制

基于分布式协同框架面向跨设备拍照的业务场景，为您提供了 [HMS\_ServiceCollaboration\_GetCollaborationDeviceInfos](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_getcollaborationdeviceinfos)（设备列表接口）、[HMS\_ServiceCollaboration\_StartCollaboration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_startcollaboration)（跨端拍照、扫描、拉起图库选择图片）或[HMS\_ServiceCollaboration\_StartCollaborationV2](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_startcollaborationv2)（跨端拍照、扫描、拉起图库选择图片和视频）和 [HMS\_ServiceCollaboration\_StopCollaboration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_stopcollaboration)（终止跨设备互通）四个接口。只需要调用这四个接口，即可完成跨设备互通，无需关注分布式场景下数据传输、指令控制等具体细节。

1.  **系统分布式协同框架跨设备自动建链**
    
    a. 通过系统的分布式协同框架，同账号下的本端设备（PC/2in1设备/Tablet）与远端设备（Phone/Tablet）自动建立连接。系统将自动完成设备的发现、连接、认证等流程，通过[HMS\_ServiceCollaboration\_GetCollaborationDeviceInfos](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_getcollaborationdeviceinfos)接口提供可用的具有相机、扫描和图库能力的远端设备信息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/56/v3/S6pdFVANQr2YQzRehg7xIg/zh-cn_image_0000002634009122.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=ED2AF1A295AD4B84D90539602593DA3E02E73888F14C3A17CD3229829AC14DBB)
    
    b. 通过[HMS\_ServiceCollaboration\_StartCollaboration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_startcollaboration)或者[HMS\_ServiceCollaboration\_StartCollaborationV2](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_startcollaborationv2)拉起对应跨设备互通能力，通过[HMS\_ServiceCollaboration\_StopCollaboration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#hms_servicecollaboration_stopcollaboration)终止跨设备互通能力。分布式协同框架会将远端拍摄状态信息实时回传到应用侧，应用侧会根据错误码做相关提示。
    
    拍摄状态可能为：对端设备拍摄中、图片导入中、协同失败、本端WLAN未开启、双端WLAN或者蓝牙未开启。具体拍摄状态提示可由应用选择绘制，对应提示信息参考[ServiceCollaborationEventCode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-capi-module#servicecollaborationeventcode-1)。
    
    | 对端设备拍摄中 | 图片导入中 | 协同失败 | 本端WLAN未开启 | 双端WLAN或者蓝牙未开启 |
    | :-- | :-- | :-- | :-- | :-- |
    | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ad/v3/EJxJeOF9Tqy12UtlSY7CjA/zh-cn_image_0000002664208271.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=A672B7874B7E7AB213E3D8AD2EBA810CCCAE12F1689CE1CE7E0051F9B4E1636C) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6f/v3/q-qq_s_CTLuKMYMDPWN2Hg/zh-cn_image_0000002664328331.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=3601C7A224EED746E67C4D0C272D06304DF43FD82B36BBDD1BC4C7483DF4C2CD) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/59/v3/H8XpQDgESR6z2bNOjEKw2w/zh-cn_image_0000002633849220.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=9420162A3758E8CE3135EF516A240AB32531A681EF77EE071DCC1CF659D73B7E) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c8/v3/fYixYRnhRoaUcKzG59SaFA/zh-cn_image_0000002634009124.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=FD7AA6046FBBC12E6A0C3277A6330A8E10E3A7095558364D162C7794EEF91B9D) | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c9/v3/H6WEZ8-WTX2N5L1tNlktcg/zh-cn_image_0000002664208273.png?HW-CC-KV=V1&HW-CC-Date=20260709T132441Z&HW-CC-Expire=86400&HW-CC-Sign=755622527E019B8B354A521CA9443EBE16B450124D9F13ECC46BA688A14F8149) |
    
2.  **用户使用远端设备拍照**
    
    1.  用户使用远端设备完成拍照并确认，照片将回传到本端设备的应用，完成整个流程。
    2.  远端设备将自动退出相机界面，回到初始状态。