com.serenegiant.usb

类 USBMonitor

java.lang.Object

com.serenegiant.usb.USBMonitor

public final class USBMonitor
extends java.lang.Object

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	USBMonitor.OnDeviceConnectListener USB機器の状態変更時のコールバックリスナー
static class	USBMonitor.UsbControlBlock control class never reuse the instance when it closed
static class	USBMonitor.UsbDeviceInfo

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ACTION_USB_DEVICE_ATTACHED

构造器概要

构造器

构造器和说明
USBMonitor(android.content.Context context, USBMonitor.OnDeviceConnectListener listener)

方法概要

限定符和类型	方法和说明
void	addDeviceFilter(DeviceFilter filter) デバイスフィルターを追加
void	addDeviceFilter(java.util.List<DeviceFilter> filters) add device filters
void	destroy() Release all related resources, never reuse again
void	dumpDevices() output device list to LogCat
int	getDeviceCount() return the number of connected USB devices that matched device filter
static USBMonitor.UsbDeviceInfo	getDeviceInfo(android.content.Context context, android.hardware.usb.UsbDevice device) ベンダー名・製品名・バージョン・シリアルを取得する #updateDeviceInfo(final UsbManager, final UsbDevice, final UsbDeviceInfo)のヘルパーメソッド
USBMonitor.UsbDeviceInfo	getDeviceInfo(android.hardware.usb.UsbDevice device) ベンダー名・製品名・バージョン・シリアルを取得する
static int	getDeviceKey(android.hardware.usb.UsbDevice device) デバイスキーを整数として取得 getDeviceKeyNameで得られる文字列のhasCodeを取得 ベンダーID, プロダクトID, デバイスクラス, デバイスサブクラス, デバイスプロトコルから生成 同種の製品だと同じデバイスキーになるので注意
static int	getDeviceKey(android.hardware.usb.UsbDevice device, boolean useNewAPI) デバイスキーを整数として取得 getDeviceKeyNameで得られる文字列のhasCodeを取得 useNewAPI=falseで同種の製品だと同じデバイスキーになるので注意
static int	getDeviceKey(android.hardware.usb.UsbDevice device, java.lang.String serial, boolean useNewAPI) デバイスキーを整数として取得 getDeviceKeyNameで得られる文字列のhasCodeを取得 serialがnullでuseNewAPI=falseで同種の製品だと同じデバイスキーになるので注意
static java.lang.String	getDeviceKeyName(android.hardware.usb.UsbDevice device) USB機器毎の設定保存用にデバイスキー名を生成する。
static java.lang.String	getDeviceKeyName(android.hardware.usb.UsbDevice device, boolean useNewAPI) USB機器毎の設定保存用にデバイスキー名を生成する。
static java.lang.String	getDeviceKeyName(android.hardware.usb.UsbDevice device, java.lang.String serial, boolean useNewAPI) USB機器毎の設定保存用にデバイスキー名を生成する。
java.util.List<android.hardware.usb.UsbDevice>	getDeviceList() return device list, return empty list if no device matched
java.util.List<android.hardware.usb.UsbDevice>	getDeviceList(DeviceFilter filter) return device list, return empty list if no device matched
java.util.List<android.hardware.usb.UsbDevice>	getDeviceList(java.util.List<DeviceFilter> filters) return device list, return empty list if no device matched
java.util.Iterator<android.hardware.usb.UsbDevice>	getDevices() get USB device list, without filter
boolean	hasPermission(android.hardware.usb.UsbDevice device) return whether the specific Usb device has permission
boolean	isRegistered()
USBMonitor.UsbControlBlock	openDevice(android.hardware.usb.UsbDevice device) 指定したUsbDeviceをopenする
void	register() register BroadcastReceiver to monitor USB events
void	removeDeviceFilter(DeviceFilter filter) デバイスフィルターを削除
void	removeDeviceFilter(java.util.List<DeviceFilter> filters) remove device filters
boolean	requestPermission(android.hardware.usb.UsbDevice device) request permission to access to USB device
void	setDeviceFilter(DeviceFilter filter) set device filter
void	setDeviceFilter(java.util.List<DeviceFilter> filters) set device filters
void	unregister() unregister BroadcastReceiver
static USBMonitor.UsbDeviceInfo	updateDeviceInfo(android.hardware.usb.UsbManager manager, android.hardware.usb.UsbDevice device, USBMonitor.UsbDeviceInfo _info) ベンダー名・製品名・バージョン・シリアルを取得する

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

ACTION_USB_DEVICE_ATTACHED

public static final java.lang.String ACTION_USB_DEVICE_ATTACHED

另请参阅:

常量字段值

构造器详细资料

USBMonitor

public USBMonitor(android.content.Context context,
                  USBMonitor.OnDeviceConnectListener listener)

方法详细资料

destroy

public void destroy()

Release all related resources, never reuse again

register

public void register()
              throws java.lang.IllegalStateException

register BroadcastReceiver to monitor USB events

抛出:

java.lang.IllegalStateException

unregister

public void unregister()
                throws java.lang.IllegalStateException

unregister BroadcastReceiver

抛出:

java.lang.IllegalStateException

isRegistered

public boolean isRegistered()

setDeviceFilter

public void setDeviceFilter(DeviceFilter filter)
                     throws java.lang.IllegalStateException

set device filter

参数:

filter -

抛出:

java.lang.IllegalStateException

addDeviceFilter

public void addDeviceFilter(DeviceFilter filter)
                     throws java.lang.IllegalStateException

デバイスフィルターを追加

参数:

filter -

抛出:

java.lang.IllegalStateException

removeDeviceFilter

public void removeDeviceFilter(DeviceFilter filter)
                        throws java.lang.IllegalStateException

デバイスフィルターを削除

参数:

filter -

抛出:

java.lang.IllegalStateException

setDeviceFilter

public void setDeviceFilter(java.util.List<DeviceFilter> filters)
                     throws java.lang.IllegalStateException

set device filters

参数:

filters -

抛出:

java.lang.IllegalStateException

addDeviceFilter

public void addDeviceFilter(java.util.List<DeviceFilter> filters)
                     throws java.lang.IllegalStateException

add device filters

参数:

filters -

抛出:

java.lang.IllegalStateException

removeDeviceFilter

public void removeDeviceFilter(java.util.List<DeviceFilter> filters)
                        throws java.lang.IllegalStateException

remove device filters

参数:

filters -

抛出:

java.lang.IllegalStateException

getDeviceCount

public int getDeviceCount()
                   throws java.lang.IllegalStateException

return the number of connected USB devices that matched device filter

返回:

抛出:

java.lang.IllegalStateException

getDeviceList

public java.util.List<android.hardware.usb.UsbDevice> getDeviceList()
                                                             throws java.lang.IllegalStateException

return device list, return empty list if no device matched

返回:

抛出:

java.lang.IllegalStateException

getDeviceList

public java.util.List<android.hardware.usb.UsbDevice> getDeviceList(java.util.List<DeviceFilter> filters)
                                                             throws java.lang.IllegalStateException

return device list, return empty list if no device matched

参数:

filters -

返回:

抛出:

java.lang.IllegalStateException

getDeviceList

public java.util.List<android.hardware.usb.UsbDevice> getDeviceList(DeviceFilter filter)
                                                             throws java.lang.IllegalStateException

return device list, return empty list if no device matched

参数:

filter -

返回:

抛出:

java.lang.IllegalStateException

getDevices

public java.util.Iterator<android.hardware.usb.UsbDevice> getDevices()
                                                              throws java.lang.IllegalStateException

get USB device list, without filter

返回:

抛出:

java.lang.IllegalStateException

dumpDevices

public final void dumpDevices()

output device list to LogCat

hasPermission

public final boolean hasPermission(android.hardware.usb.UsbDevice device)
                            throws java.lang.IllegalStateException

return whether the specific Usb device has permission

参数:

device -

返回:

true: 指定したUsbDeviceにパーミッションがある

抛出:

java.lang.IllegalStateException

requestPermission

public boolean requestPermission(android.hardware.usb.UsbDevice device)

request permission to access to USB device

参数:

device -

返回:

true if fail to request permission

openDevice

public USBMonitor.UsbControlBlock openDevice(android.hardware.usb.UsbDevice device)
                                      throws java.lang.SecurityException

指定したUsbDeviceをopenする

参数:

device -

返回:

抛出:

java.lang.SecurityException - パーミッションがなければSecurityExceptionを投げる

getDeviceKeyName

public static final java.lang.String getDeviceKeyName(android.hardware.usb.UsbDevice device)

USB機器毎の設定保存用にデバイスキー名を生成する。 ベンダーID, プロダクトID, デバイスクラス, デバイスサブクラス, デバイスプロトコルから生成 同種の製品だと同じキー名になるので注意

参数:

device - nullなら空文字列を返す

返回:

getDeviceKeyName

public static final java.lang.String getDeviceKeyName(android.hardware.usb.UsbDevice device,
                                                      boolean useNewAPI)

USB機器毎の設定保存用にデバイスキー名を生成する。 useNewAPI=falseで同種の製品だと同じデバイスキーになるので注意

参数:

device -

useNewAPI -

返回:

getDeviceKeyName

public static final java.lang.String getDeviceKeyName(android.hardware.usb.UsbDevice device,
                                                      java.lang.String serial,
                                                      boolean useNewAPI)

USB機器毎の設定保存用にデバイスキー名を生成する。この機器名をHashMapのキーにする UsbDeviceがopenしている時のみ有効 ベンダーID, プロダクトID, デバイスクラス, デバイスサブクラス, デバイスプロトコルから生成 serialがnullや空文字でなければserialを含めたデバイスキー名を生成する useNewAPI=trueでAPIレベルを満たしていればマニュファクチャ名, バージョン, コンフィギュレーションカウントも使う

参数:

device - nullなら空文字列を返す

serial - UsbDeviceConnection#getSerialで取得したシリアル番号を渡す, nullでuseNewAPI=trueでAPI>=21なら内部で取得

useNewAPI - API>=21またはAPI>=23のみで使用可能なメソッドも使用する(ただし機器によってはnullが返ってくるので有効かどうかは機器による)

返回:

getDeviceKey

public static final int getDeviceKey(android.hardware.usb.UsbDevice device)

デバイスキーを整数として取得 getDeviceKeyNameで得られる文字列のhasCodeを取得 ベンダーID, プロダクトID, デバイスクラス, デバイスサブクラス, デバイスプロトコルから生成 同種の製品だと同じデバイスキーになるので注意

参数:

device - nullなら0を返す

返回:

getDeviceKey

public static final int getDeviceKey(android.hardware.usb.UsbDevice device,
                                     boolean useNewAPI)

デバイスキーを整数として取得 getDeviceKeyNameで得られる文字列のhasCodeを取得 useNewAPI=falseで同種の製品だと同じデバイスキーになるので注意

参数:

device -

useNewAPI -

返回:

getDeviceKey

public static final int getDeviceKey(android.hardware.usb.UsbDevice device,
                                     java.lang.String serial,
                                     boolean useNewAPI)

デバイスキーを整数として取得 getDeviceKeyNameで得られる文字列のhasCodeを取得 serialがnullでuseNewAPI=falseで同種の製品だと同じデバイスキーになるので注意

参数:

device - nullなら0を返す

serial - UsbDeviceConnection#getSerialで取得したシリアル番号を渡す, nullでuseNewAPI=trueでAPI>=21なら内部で取得

useNewAPI - API>=21またはAPI>=23のみで使用可能なメソッドも使用する(ただし機器によってはnullが返ってくるので有効かどうかは機器による)

返回:

getDeviceInfo

public USBMonitor.UsbDeviceInfo getDeviceInfo(android.hardware.usb.UsbDevice device)

ベンダー名・製品名・バージョン・シリアルを取得する

参数:

device -

返回:

getDeviceInfo

public static USBMonitor.UsbDeviceInfo getDeviceInfo(android.content.Context context,
                                                     android.hardware.usb.UsbDevice device)

ベンダー名・製品名・バージョン・シリアルを取得する #updateDeviceInfo(final UsbManager, final UsbDevice, final UsbDeviceInfo)のヘルパーメソッド

参数:

context -

device -

返回:

updateDeviceInfo

public static USBMonitor.UsbDeviceInfo updateDeviceInfo(android.hardware.usb.UsbManager manager,
                                                        android.hardware.usb.UsbDevice device,
                                                        USBMonitor.UsbDeviceInfo _info)

ベンダー名・製品名・バージョン・シリアルを取得する

参数:

manager -

device -

_info -

返回: