# CollaborationDevicePicker (流转控件)

> phone 5.0.0(12)+ | 2in1 5.0.1(13)+ | tablet 5.0.0(12)+ | tv 5.1.1(19)+

该模块提供流转入口组件，点击流转入口组件后，会拉起设备选择面板。

与devicePicker.[createDevicePickerController](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-devicepicker#createdevicepickercontroller)配合使用，通过创建的controller可以与设备选择面板进行交互。

**起始版本：** 4.0.0(10)

## 导入模块

> phone | 2in1 | tablet | tv

```typescript
import { CollaborationDevicePicker } from '@kit.ServiceCollaborationKit';
```

## CollaborationDevicePicker

> phone 5.0.0(12)+ | 2in1 5.0.1(13)+ | tablet 5.0.0(12)+ | tv 5.1.1(19)+

流转控件对象，用于创建控件对象实例。

**模型约束：** 此模块的接口仅可在Stage模型下使用。

**装饰器类型：** @Component

**系统能力：** SystemCapability.Collaboration.DevicePicker

**起始版本：** 4.0.0(10)

|名称|类型|只读|可选|说明|
|:---------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------|:-|:-|:-----------------------------------------------------|
|controller|devicePicker.[DevicePickerController](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-devicepicker#devicepickercontroller)|否|否|设备选择控制器，通过该控制器与设备选择界面进行交互。|
|attribute|devicePicker.[DevicePickerAttribute](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/servicecollaboration-devicepicker#devicepickerattribute)|否|否|设备选择属性，指定设备选择界面的应用描述信息，如果不指定，默认使用调用者所属ability配置文件中的信息。|

### build

> phone 5.0.0(12)+ | 2in1 5.0.1(13)+ | tablet 5.0.0(12)+ | tv 5.1.1(19)+

build(): void

struct的默认构造函数，开发者无法直接调用此方法。

**模型约束：** 此模块的接口仅可在Stage模型下使用。

**系统能力：** SystemCapability.Collaboration.DevicePicker

**起始版本：** 4.0.0(10)

**示例：**

```typescript
import { devicePicker, CollaborationDevicePicker } from '@kit.ServiceCollaborationKit';

@Entry
@Component
struct Index {
  controller: devicePicker.DevicePickerController = devicePicker.createDevicePickerController();

  build() {
    Column() {
      // 流转控件，应用流转的入口
      CollaborationDevicePicker({
        controller: this.controller, attribute: {
          abilityName: '流转测试',
          abilityDesc: '这是一个流转测试的控件',
          abilityIcon: $r('sys.media.ohos_app_icon'),
          businessDesc: '流转到'
        }
      })
    }.width('100%').alignItems(HorizontalAlign.Center)
  }
}
```

|**图1** 设备选择界面的应用描述信息效果图|**图2** 点击流转入口组件后，拉起设备选择面板效果图|**图3** 设备流转成功后效果图|**图4** 流转失败效果图|
|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|设备选择界面最上方为应用描述部分，包括应用图标、应用名称、应用描述信息![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/83/v3/amewoqYMRH2v-BncKR6Yvw/zh-cn_image_0000002768023220.png?HW-CC-KV=V1&HW-CC-Date=20261019T062647Z&HW-CC-Expire=31536000000&HW-CC-Sign=FCCD7E4721279CCDE3EB57A9412243620052EBBCA11148301D21D1138D3961A9)|页面右上角为流转图标，点击后会从设备底部弹出设备选择面板![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/63/v3/0L3kwAd7QveCL2DFTqMBlA/zh-cn_image_0000002797303169.png?HW-CC-KV=V1&HW-CC-Date=20261019T062647Z&HW-CC-Expire=31536000000&HW-CC-Sign=D646737DDF81D4FF725FB9FF48BDF24D2503BA13E073C1ED8B757988C400D438)|流转图标和设备信息会变蓝色![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c4/v3/FX-EUCklQhCsJGq8-PQPcA/zh-cn_image_0000002767863236.png?HW-CC-KV=V1&HW-CC-Date=20261019T062647Z&HW-CC-Expire=31536000000&HW-CC-Sign=4DD139DB278FACAE3A74BF232A7C5F9D79DFAD6AE3642763CAB610D8A3AF488E)|流转失败效果图![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/15/v3/UC1ciXWWRiGWoKov2q50Eg/zh-cn_image_0000002797183199.png?HW-CC-KV=V1&HW-CC-Date=20261019T062647Z&HW-CC-Expire=31536000000&HW-CC-Sign=846219B58C5096EEDA63AF30CA2F24BDBDAA8722D84BF26EB0FCCB007A3FAA11)|