目录

开发步骤

开发步骤

[h2]链接服务

应用在需要使用DV Engine能力时,首先需要进行初始化连接DV Engine服务,服务初始化结果会通过onConnect回调返回。

当服务断开或异常,会通过onDisconnect回调返回。

在连接成功后调用getKitService来获取VirtualDeviceManager服务实例,用于控制虚拟设备。

当DVEngine服务异常时,onDisconnect回调接口会通知应用,应用此时可以重新进行连接并且清理设备连接状态,或者根据业务需要进行处理。

//获取DV Engine对象并连接DV Engine服务 
DvKit.getInstance().connect(getApplicationContext(), new IDvKitConnectCallback() { 
    //服务连接成功后的回调通知 
    @Override 
    public void onConnect(int result) { 
        addLog("msdp service connect"); 
        mVirtualDeviceManager = (VirtualDeviceManager)        DvKit.getInstance().getKitService(VIRTUAL_DEVICE_CLASS); 
        mVirtualDeviceManager.subscribe(EnumSet.of(VIRTUALDEVICE), observer); 
    } 
    //服务断开后的回调通知 
    @Override 
    public void onDisconnect() { 
        addLog("msdp service disconnect"); 
    } 
});

[h2]设备发现

当DV Engine服务初始化连接成功并且获取到VirtualDeviceManager服务后,应用可以调用VirtualDeviceManager服务的startDiscovery接口用于发现周边可用设备。发现的设备会通过IDiscoveryCallback回调的onFound接口返回。

//开始发现设备 
mVirtualDeviceManager.startDiscovery(new IDiscoveryCallback() { 
    //设备发现时的回调接口 
    @Override 
    public void onFound(VirtualDevice device, int state) { 
        if (device == null) { 
            addLog("onDevice callback but device is null"); 
        } else { 
            HwLog.d(TAG, "onDevice Found: " + Util.hideSensitiveInfo(device.getDeviceId()) + " Name: " 
                + device.getDeviceName() + " Type:" + device.getDeviceType()); 
            if (!mVirtualDeviceMap.containsKey(device.getDeviceId())) { 
                addLog("onDevice Found: " + device.getDeviceId() + " Name: " + device.getDeviceName() + " Type:" 
                    + device.getDeviceType()); 
                mVirtualDeviceMap.put(device.getDeviceId(), device); 
                handler.sendMessage(handler.obtainMessage(DEVICE_ADD, device)); 
            } 
        } 
    } 
    //发现状态变更的回调通知 
    @Override 
    public void onState(int state) { 
    } 
});
  1. 周边设备不能保证一直可用,因此在应用中请不要缓存可用设备列表。每次呈现给用户进行设备选择时,都需要调用startDiscovery接口重新发现周边可用设备。
  2. 发现接口调用后,DV Engine会触发持续1分钟的扫描,在此期间,应用无法通过startDiscovery再次触发扫描发现。如果需要再次进行发现,建议在开始前先调用VirtualDeviceManager服务的cancelDiscovery停止发现,将发现状态置位后,再触发startDiscovery。

[h2]设备能力使用

当发现到虚拟设备后,应用可以调用虚拟设备的getDeviceCapability()接口获取设备支持的能力,并且根据业务需要有选择的使能设备的能力。

应用可以通过调用enableVirtualDevice来使能所需要使能的设备以及能力,如果需要同时使能设备多个能力,可以同时传入多个能力。

应用使能的结果可以通过subscribe接口传入的回调对象获得。

mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(CAMERA), null); 
//调用subscribe时传入的observer对象 
private IVirtualDeviceObserver observer = new IVirtualDeviceObserver() { 
    //虚拟设备状态变化时的回调通知 
    @Override 
    public void onDeviceStateChange(VirtualDevice virtualDevice, int returncode) { 
    } 
    //虚拟设备能力状态变化时的回调通知 
    @Override 
    public void onDeviceCapabilityStateChange(VirtualDevice virtualDevice, Capability capability, int returncode) { 
        if (returncode == EventType.EVENT_DEVICE_CAPABILITY_ENABLE) { 
            //当设备能力使能成功时,应用处理使能成功流程 
            onEnable(virtualDevice, capability); 
        } else if (returncode == EventType.EVENT_DEVICE_CAPABILITY_DISABLE) { 
            //当设备能力去使能成功时,应用处理去使能成功流程 
            onDisable(virtualDevice, capability); 
        } else { 
            //当虚拟设备能力状态异常时,应用应处理异常流程 
            onError(virtualDevice, capability, returncode); 
        } 
    } 
};
  1. 虚拟Display能力。

    使用如下代码即可使能设备的虚拟Display能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(DISPLAY), null);

    虚拟Display能力在应用使能Display能力之后就会生效,即手机屏幕显示的画面会在虚拟设备的屏幕上显示。

    应用也可通过操作虚拟设备的Display对象,将指定内容显示在虚拟设备的屏幕上显示,从而使虚拟屏幕和手机屏幕显示不同的内容。

    //获取DisplayManager 
    DisplayManager displayMgr = getApplicationContext().getSystemService(DisplayManager.class); 
    //使用DisplayManager获取所有display对象 
    displays = displayMgr.getDisplays(); 
    if (displays != null) { 
        for (Display display : displays) { 
            //获取Display对象的ID和name 
            int id = display.getDisplayId(); 
            String name = display.getName(); 
            //虚拟设备的displayId大于默认display对象的id,且名称与虚拟设备名称相同 
            if ((id > Display.DEFAULT_DISPLAY) && (device.getDeviceName().equals(name))) { 
                //获取到虚拟屏幕的display对象,可以使用Android标准接口操作显示 
                ...... 
            } 
        } 
    }
  2. 虚拟Mic能力。

    使用如下代码即可使能设备的虚拟Mic能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(MIC), null);

    虚拟Mic能力在应用使能Mic能力之后就会生效。只要使能了虚拟Mic,使用所有的Andriod音频录音接口采集的声音都会使用虚拟设备的Mic采集。

  3. 虚拟Speaker能力。

    使用如下代码即可使能设备的虚拟Speaker能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(SPEAKER), null);

    虚拟Speaker能力在应用使能Speaker能力之后就会生效。只要使能了虚拟Speaker,使用所有的Andriod音频播放接口播放的声音都会使用虚拟设备的Speaker播放。

  4. 虚拟Camera能力。

    使用如下代码即可使能设备的虚拟Camera能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(CAMERA), null);

    虚拟Camera能力使能后,应用可以通过getData接口获取虚拟设备上虚拟Camera的id。和本地前后置摄像头一样,应用可以通过Android的getCameraCharacteristics接口获取虚拟Camera的属性信息,以及通过Android的openCamera接口打开虚拟Camera。

    //通过虚拟设备的getData接口获取设备虚拟Camera的ID 
    String cameraId = device.getData(Constants.ANDROID_CAMERAID_FRONT); 
    //使用CameraManager的getCameraCharacteristics接口获取虚拟Camera的属性信息 
    CameraManager manager = (CameraManager)getSystemService(Context.CAMERA_SERVICE); 
    CameraCharacteristics characteristics = manager.getCameraCharacteristics(cameraId); 
    //使用CameraManager的openCamera接口打开虚拟Camera 
    manager.openCamera(cameraId, mStateCallback, null);

    当前虚拟Camera仅支持Android Camera2 API预览的基本方法,不支持拍照和录像场景,对于Camera预览中的参数配置,仅支持运行中配置帧率。如果应用有其他场景应用,开发者可发送邮件至devConnect@huawei.com联系我们。

    支持的功能点包括以下:

    CameraManager.getCameraCharacteristics()
    CameraManager.openCamera()
    CameraDevice.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW)
    CameraDevice.createCaptureSession()
    CameraCaptureSession.setRepeatingRequest()
    CameraDevice.close()
    CameraCaptureSession.close()
  5. 虚拟Sensor能力。

    使用如下代码即可使能设备的虚拟Sensor能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(SENSOR), null);

    虚拟Sensor能力在应用使能Sensor能力之后就会生效。只要使能了虚拟Sensor,使用所有的Sensor的能力,当前虚拟Sensor已支持心率计、陀螺仪、加速度计、气压计数据的上报。

    使能虚拟Sensor成功后,可以通过下面的代码获取的Sensor服务。

    SensorAgent kitService = (SensorAgent) DvKit.getInstance().getKitService(VIRTUAL_SENSOR_SERVICE);

    获取到虚拟Sensor服务后,可以查看对应设备的Sensor列表。

    List<VirtualSensor> sensorList = kitService.getSensorList(deviceId, TYPE_HEART_RATE);

    然后根据业务的需要,选择特定的Sensor进行数据订阅。

    private IVirtualSensorDataListener sensorDataListener = new IVirtualSensorDataListener() {
        @Override
        public void onSensorChanged(VirtualSensorData data) {
            Log.d(TAG, "onSensorChanged: " + data);
        }
    };
    SensorAgent kitService = (SensorAgent) DvKit.getInstance().getKitService(VIRTUAL_SENSOR_SERVICE);
    kitService.subscribeSensorDataListener(sensorDataListener, virtualSensor, SensorAgent.SENSOR_DELAY_FAST);

    应用订阅特定的虚拟Sensor数据后, 就可以定期接收到虚拟Sensor的数据。

    1. 当前虚拟Sensor已支持TYPE_HEART_RATE(心率计)、TYPE_ACCELEROMETER(加速度计)、TYPE_GYROSCOPE(陀螺仪)、TYPE_PRESSURE(气压计)类型,上报周期有快速(60ms)、正常(200ms)、缓慢(5s)三档可选。
    2. 使用虚拟Sensor前,调用虚拟Sensor的接口要求该应用必须要具有android.permission.BODY_SENSORS权限和com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE权限。
    3. 使用虚拟Sensor前,调用虚拟Sensor的接口要求该应用必须已经在华为开发者联盟上申请了com.huawei.dv.permission.VIRTUALSENSOR权限。
  6. 虚拟Vibrator能力。

    使用如下代码即可使能设备的虚拟Vibrator能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(VIBRATE), null);

    虚拟Vibrator能力在应用使能Vibrator能力之后就会生效。只要使能了虚拟Vibrator,然后就可以调用对应的虚拟设备上的Vibrator下发震动指令。

    使能虚拟Vibrator成功后,可以通过下面的代码获取的Vibrator服务。

    VibratorService vibratorService = (VibratorService) DvKit.getInstance().getKitService(VIRTUAL_VIBRATE_SERVICE);

    获取到虚拟Vibrator服务后,可以查看对应设备的Vibrator列表。

    vibratorService.getVibrateList(selectedItem.getDeviceId());

    然后根据业务的需要,选择特定的Vibrator下发震动指令。

    vibrator.vibrate(2000); // 马达振动2s
    1. 使用虚拟Vibrator前,调用虚拟Vibrator的接口要求该应用必须要具有android.permission.VIBRATE权限和com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE权限。
    2. 使用虚拟Vibrator前,调用虚拟Vibrator的接口要求该应用必须已经在华为开发者联盟上申请了com.huawei.dv.permission.VIRTUALVIBRATOR权限。
  7. 虚拟Notification能力。

    使用如下代码即可使能设备的虚拟Notification能力。

    mVirtualDeviceManager.enableVirtualDevice(deviceId, EnumSet.of(NOTIFICATION), null);

    虚拟Notification能力在应用使能Notification能力之后就会生效。只要使能了虚拟Notification,则可以使用虚拟Notification的接口给设备发送通知。

    使能虚拟Notification成功后,可以通过下面的代码获取的Notification服务。

    DvNotificationService notificationService = (DvNotificationService) DvKit.getInstance().getKitService(VIRTUAL_NOTIFICATION_SERVICE);

    获取到虚拟Notification服务后,可以调用对应的虚拟设备上的Notification的接口给设备发送通知。

  8. 设备参数配置。

    使能设备能力之后,可以通过VirtualDevice的setData方法对设备下发参数配置,例如:

    使用如下代码即可开启虚拟camera自动旋转。

    Map<String, Object> params = new HashMap<String, Object>();
    params.put(Constants.CAMERA_POSITION, Constants.ANDROID_CAMERAID_BACK);
    params.put(Constants.AUTO_ORIENTATION, Constants.AUTO_ORIENTATION_ENABLE);
    device.setData(Constants.CAMERA_CONFIG, params);

    自动旋转开启后,在设备旋转时,画面将始终保持正向显示。

[h2]马达的使用

  1. 马达列表获取。

    获取选定设备的马达列表,需要申请分布式马达权限“com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE”以及Android马达权限“android.permission.VIBRATE”。

    VibratorService vibratorService = (VibratorService) DvKit.getInstance().getKitService(VIRTUAL_VIBRATE_SERVICE);
    List<VirtualVibrator> vibrateList = vibratorService.getVibrateList(deviceId);
  2. 马达振动。

    发送马达振动指令,需要申请分布式马达权限“com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE”以及Android马达权限“android.permission.VIBRATE”,约束条件《API接口文档》。

    vibrator.vibrate(2000); // 振动2000ms
    vibrator.vibrate(new long[]{2000, 500, 1000, 200}, 0); // 振动2000ms,暂停500ms,振动1000ms,暂停200ms,一直重复
    vibrator.vibrate(new long[]{2000, 500, 1000, 200}, 1); // 振动2000ms,暂停500ms,振动1000ms,暂停200ms,遍历一次
  3. 取消马达振动。

    发送取消马达振动指令,需要申请分布式马达权限“com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE”以及Android马达权限“android.permission.VIBRATE”。

    vibrator.cancel();

[h2]Sensor的使用

  1. Sensor列表获取。

    获取选定设备的Sensor列表,需要申请分布式Sensor权限“com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE”以及申请Android的Sensor权限“android.permission.BODY_SENSORS”。当前可请求的Sensor类型包括心率计、加速度计、陀螺仪、气压计。

    SensorAgent kitService = (SensorAgent) DvKit.getInstance().getKitService(VIRTUAL_SENSOR_SERVICE);
    List<VirtualSensor> sensorList = kitService.getSensorList(selectedItem.getDeviceId(),VirtualSensor. TYPE_HEART_RATE);
  2. 订阅Sensor数据监听。

    订阅Sensor数据监听,需要申请分布式Sensor权限“com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE”以及申请Android的Sensor权限“android.permission.BODY_SENSORS”。订阅数据监听时,上报周期共有快速(60ms)、正常(200ms)、缓慢(5s)三档可选。

    • 订阅Sensor数据时若设置的上报周期小于设备所支持的最小上报周期,会返回设备能力不支持的错误码(ReturnCode.ERROR_CODE_DEVICE_NOT_SUPPORT),请根据情况重新设置。
    private IVirtualSensorDataListener sensorDataListener = new IVirtualSensorDataListener() {
        @Override
        public void onSensorChanged(VirtualSensorData data) { 
        }
    };
    SensorAgent kitService = (SensorAgent) DvKit.getInstance().getKitService(VIRTUAL_SENSOR_SERVICE);
    // 使用数据监听接口,上报周期设为快速(60ms)
    kitService.subscribeSensorDataListener(sensorDataListener, virtualSensor, SensorAgent.SENSOR_DELAY_FAST);
  3. 取消订阅Sensor数据监听。

    取消订阅Sensor数据监听,需要申请分布式sensor权限“com.huawei.permission.DISTRIBUTED_VIRTUALDEVICE”以及申请Android的Sensor权限“android.permission.BODY_SENSORS”。

    SensorAgent kitService = (SensorAgent) DvKit.getInstance().getKitService(VIRTUAL_SENSOR_SERVICE);
    kitService.unSubscribeSensorDataListener(sensorDataListener);

[h2]消息通知的使用

先设置消息内容,然后调用发送消息的接口发送消息到设备。

目前有两种消息模板:

  1. 通用消息模板COMMON_LAYOUT_TEMPLATE、
  2. 导航消息模板GUIDE_LAYOUT_TEMPLATE。

通用消息模板COMMON_LAYOUT_TEMPLATE是预留模板。

当前只支持导航消息模板GUIDE_LAYOUT_TEMPLATE的显示。

对应的需要设置的属性有:KEY_PACKAGE_NAME、KEY_GUIDE_DISTANCE、KEY_DISTANCE_UNIT、KEY_DIRECTION_INDEX、KEY_GUIDE_TEXT以及KEY_VIBRATE,其中KEY_VIBRATE不设置时默认为普通震动提醒NORMAL_VIBRATION。具体请参见《API接口文档》。

  1. 设置消息体的属性。

    消息体通过setNotificationProperty方法进行统一设置,以导航消息为例:先申请一个Map对象,然后设置模板对应的属性值KEY_PACKAGE_NAME、KEY_GUIDE_DISTANCE、KEY_DISTANCE_UNIT、KEY_DIRECTION_INDEX、KEY_GUIDE_TEXT以及KEY_VIBRATE,之后调用setNotificationProperty方法传入模板以及已经设置好的Map对象。最后调用doNotification方法进行消息通知的发送。

    DvNotificationService notificationService =(DvNotificationService)HiWearActivity.mDvKit.getKitService(VIRTUAL_NOTIFICATION_SERVICE);
    DvNotification notification = new DvNotification();
    Map<String, Object> notificaitonProperty = new HashMap<>();
    notificaitonProperty.put(DvNotification.KEY_PACKAGE_NAME, “packageName”); // 设置三方应用的包名,用于区分消息的来源
    notificaitonProperty.put(DvNotification.KEY_GUIDE_DISTANCE, 500); // 设置导航的距离
    notificaitonProperty.put(DvNotification.KEY_DISTANCE_UNIT, “m”); // 设置导航的单位
    notificaitonProperty.put(DvNotification.KEY_DIRECTION_INDEX, 1); // 设置导航图标的索引
    notificaitonProperty.put(DvNotification.KEY_GUIDE_TEXT, “turn left”); // 设置消息导航的文本
    notificaitonProperty.put(DvNotification.KEY_VIBRATE, DvNotificationService.NORMAL_VIBRATION); // 设置消息提醒的震动方式
    notification.setNotificationProperty(DvNotificationService.GUIDE_LAYOUT_TEMPLATE,notificaitonProperty); // 通过该接口设置导航消息的属性
    int res = notificationService.doNotification(deviceId, notificationId, notification, DvNotificationService.ADD_NOTIFY); // 发送消息通知到设备的接口
  2. 获取消息体的属性。

    设置好消息属性,如果需要查看已设置的消息属性,可通过接口getNotificationProperty,传入正确模板类型进行查询。

    String notificationProperty = notification.getNotificationProperty(DvNotificationService.GUIDE_LAYOUT_TEMPLATE); //用于获取已设置的导航类消息属性值,notification定义参考上个步骤

[h2]设备能力去使能

当应用不想使用虚拟设备能力时,可以通过调用disableVirtualDevice接口来去使能虚拟设备能力,释放底层虚拟设备资源。

mVirtualDeviceManager.disableVirtualDevice(deviceId, EnumSet.of(CAMERA));

[h2]服务断连

当应用不再需要使用DVEngine所提供的服务时,可以通过调用disConnect接口来断开和服务的连接,从而释放底层资源。

DvKit.getInstance().disConnect();

异常场景