輸入設(shè)備

輸入設(shè)備管理模塊，用于監(jiān)聽輸入設(shè)備連接、斷開和變化，并查看輸入設(shè)備相關(guān)信息。比如監(jiān)聽鼠標(biāo)插拔，并獲取鼠標(biāo)的id、name和指針移動(dòng)速度等信息。

說明 ： 開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import inputDevice from '@ohos.multimodalInput.inputDevice';

inputDevice.on9+

on(type: “change”, listener: Callback): void

監(jiān)聽輸入設(shè)備的熱插拔事件。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

示例 ：

let isPhysicalKeyboardExist = true;
inputDevice.on("change", (data) = > {
    console.log("type: " + data.type + ", deviceId: " + data.deviceId);
    inputDevice.getKeyboardType(data.deviceId, (err, ret) = > {
        console.log("The keyboard type of the device is: " + ret);
        if (ret == inputDevice.KeyboardType.ALPHABETIC_KEYBOARD && data.type == 'add') {
            // 監(jiān)聽物理鍵盤已連接。
            isPhysicalKeyboardExist = true;
        } else if (ret == inputDevice.KeyboardType.ALPHABETIC_KEYBOARD && data.type == 'remove') {
            // 監(jiān)聽物理鍵盤已斷開。
            isPhysicalKeyboardExist = false;
        }
    });
});
// 根據(jù)isPhysicalKeyboardExist的值決定軟鍵盤是否彈出。

inputDevice.off9+

off(type: “change”, listener?: Callback): void

取消監(jiān)聽輸入設(shè)備的熱插拔事件。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

示例 ：

function listener(data) {
    console.log("type: " + data.type + ", deviceId: " + data.deviceId);
}

// 單獨(dú)取消listener的監(jiān)聽。
inputDevice.off("change", listener);

// 取消所有監(jiān)聽。
inputDevice.off("change");
// 取消監(jiān)聽后，軟鍵盤默認(rèn)都彈出。

inputDevice.getDeviceIds

getDeviceIds(callback: AsyncCallback>): void

獲取所有輸入設(shè)備的id列表，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

示例 ：

inputDevice.getDeviceIds((ids)= >{
    console.log("The device ID list is: " + ids);
});

inputDevice.getDeviceIds

getDeviceIds(): Promise>

獲取所有輸入設(shè)備的id列表，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

返回值 ：

示例 ：

inputDevice.getDeviceIds().then((ids)= >{
    console.log("The device ID list is: " + ids);
});

inputDevice.getDevice

getDevice(deviceId: number, callback: AsyncCallback): void

獲取輸入設(shè)備的描述信息，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

示例 ：

// 示例獲取設(shè)備id為1的設(shè)備name信息。
inputDevice.getDevice(1, (inputDevice)= >{
    console.log("The device name is: " + inputDevice.name);
});

inputDevice.getDevice

getDevice(deviceId: number): Promise

獲取輸入設(shè)備的描述信息，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

返回值 ：

示例 ：

// 示例獲取設(shè)備id為1的設(shè)備name信息。
inputDevice.getDevice(1).then((inputDevice)= >{
    console.log("The device name is: " + inputDevice.name);
});

inputDevice.supportKeys9+

supportKeys(deviceId: number, keys: Array, callback: Callback>): void

獲取輸入設(shè)備支持的鍵碼值，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

示例 ：

// 示例查詢id為1的設(shè)備對(duì)于17、22和2055按鍵的支持情況。
inputDevice.supportKeys(1, [17, 22, 2055], (ret)= >{
    console.log("The query result is as follows: " + ret);
});

inputDevice.supportKeys9+

supportKeys(deviceId: number, keys: Array): Promise>

獲取輸入設(shè)備支持的鍵碼值，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

返回值 ：

示例 ：

// 示例查詢id為1的設(shè)備對(duì)于17、22和2055按鍵的支持情況。
inputDevice.supportKeys(1, [17, 22, 2055]).then((ret)= >{
    console.log("The query result is as follows: " + ret);
})

inputDevice.getKeyboardType9+

getKeyboardType(deviceId: number, callback: AsyncCallback): void

查詢輸入設(shè)備的鍵盤類型，使用callback方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

參數(shù) ：

示例 ：

// 示例查詢設(shè)備id為1的設(shè)備鍵盤類型。
inputDevice.getKeyboardType(1, (ret)= >{
    console.log("The keyboard type of the device is: " + ret);
});

inputDevice.getKeyboardType9+

getKeyboardType(deviceId: number): Promise

查詢輸入設(shè)備的鍵盤類型，使用Promise方式作為異步方法。

系統(tǒng)能力 ：SystemCapability.MultimodalInput.Input.InputDevice

返回值 ：

示例 ：

// 示例查詢設(shè)備id為1的設(shè)備鍵盤類型。
inputDevice.getKeyboardType(1).then((ret)= >{
    console.log("The keyboard type of the device is: " + ret);
})

DeviceListener9+

輸入設(shè)備的描述信息。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

InputDeviceData

輸入設(shè)備的描述信息。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

AxisType9+

輸入設(shè)備的軸類型。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

AxisRange

輸入設(shè)備的軸信息。

系統(tǒng)能力 ： 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

SourceType

定義這個(gè)軸的輸入源類型。比如鼠標(biāo)設(shè)備可上報(bào)x軸事件，則x軸的源就是鼠標(biāo)。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

ChangedType

定義監(jiān)聽設(shè)備熱插拔事件。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

KeyboardType9+

定義鍵盤輸入設(shè)備的類型。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.MultimodalInput.Input.InputDevice

審核編輯 黃宇