该模块提供流转入口组件,点击流转入口组件后,会拉起设备选择面板。
与devicePicker.createDevicePickerController配合使用,通过创建的controller可以与设备选择面板进行交互。
起始版本: 4.0.0(10)
流转控件对象,用于创建控件对象实例。
模型约束: 此模块的接口仅可在Stage模型下使用。
装饰器类型: @Component
系统能力: SystemCapability.Collaboration.DevicePicker
起始版本: 4.0.0(10)
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| controller | devicePicker.DevicePickerController | 否 | 否 | 设备选择控制器,通过该控制器与设备选择界面进行交互。 |
| attribute | devicePicker.DevicePickerAttribute | 否 | 否 | 设备选择属性,指定设备选择界面的应用描述信息,如果不指定,默认使用调用者所属ability配置文件中的信息。 |
build(): void
struct的默认构造函数,开发者无法直接调用此方法。
模型约束: 此模块的接口仅可在Stage模型下使用。
系统能力: SystemCapability.Collaboration.DevicePicker
起始版本: 4.0.0(10)
示例:
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 流转失败效果图 |
|---|---|---|---|
设备选择界面最上方为应用描述部分,包括应用图标、应用名称、应用描述信息![]() | 页面右上角为流转图标,点击后会从设备底部弹出设备选择面板![]() | 流转图标和设备信息会变蓝色![]() | 流转失败效果图![]() |