UVCCamera工程中的测试用例，需要扫描USB设备并以列表的方式展示出来，这里以usbCameraTest中的MainActivity为例说明，其他示例也类似。

进入Activity一般都是黑屏，在左上角有一个按钮，这个按钮点击后会打开一个dialog样式的对话框，用来选择自己需要操作的USB设备，一般选择依据是通过设备的pid，vid来选择，前提是这个设备需要是支持UVC协议的摄像头，否则即使选了也不能预览摄像头画面。

|------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 | private final OnClickListener mOnClickListener = new OnClickListener() { @Override public void onClick(final View view) { synchronized (mSync) { if (mUVCCamera == null) { CameraDialog.showDialog(MainActivity.this); } else { releaseCamera(); } } } }; |

上述代码中，CameraDialog.showDialog(MainActivity.this);这一行就是展开对话框显示当前所有过滤的设备。

在CameraDialog的onResume方法中有updateDevices();

|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 | public void updateDevices() { // mUSBMonitor.dumpDevices(); final List<DeviceFilter> filter = DeviceFilter.getDeviceFilters(getActivity(), R.xml.device_filter); mDeviceListAdapter = new DeviceListAdapter(getActivity(), mUSBMonitor.getDeviceList(filter.get(0))); mSpinner.setAdapter(mDeviceListAdapter); } |

第一行便是调用getDeviceFilters进行xml的解析，这里解析的是res下的xml中device_filter.xml文件，将解析的内容放进list中：

|------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 | /** * 指定したxmlリソースからDeviceFilterリストを生成する * @param context * @param deviceFilterXmlId * @return */ public static List<DeviceFilter> getDeviceFilters(final Context context, final int deviceFilterXmlId) { final XmlPullParser parser = context.getResources().getXml(deviceFilterXmlId); final List<DeviceFilter> deviceFilters = new ArrayList<DeviceFilter>(); try { int eventType = parser.getEventType(); while (eventType != XmlPullParser.END_DOCUMENT) { if (eventType == XmlPullParser.START_TAG) { final DeviceFilter deviceFilter = readEntryOne(context, parser); if (deviceFilter != null) { deviceFilters.add(deviceFilter); } } eventType = parser.next(); } } catch (final XmlPullParserException e) { Log.d(TAG, "XmlPullParserException", e); } catch (final IOException e) { Log.d(TAG, "IOException", e); } return Collections.unmodifiableList(deviceFilters); } |

其中readEntryOne表示读取其中一项内容，代码如下：

|------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | public static DeviceFilter readEntryOne(final Context context, final XmlPullParser parser) throws XmlPullParserException, IOException { int vendorId = -1; int productId = -1; int deviceClass = -1; int deviceSubclass = -1; int deviceProtocol = -1; boolean exclude = false; String manufacturerName = null; String productName = null; String serialNumber = null; boolean hasValue = false; String tag; int eventType = parser.getEventType(); while (eventType != XmlPullParser.END_DOCUMENT) { tag = parser.getName(); if (!TextUtils.isEmpty(tag) && (tag.equalsIgnoreCase("usb-device"))) { if (eventType == XmlPullParser.START_TAG) { hasValue = true; vendorId = getAttributeInteger(context, parser, null, "vendor-id", -1); if (vendorId == -1) { vendorId = getAttributeInteger(context, parser, null, "vendorId", -1); if (vendorId == -1) vendorId = getAttributeInteger(context, parser, null, "venderId", -1); } productId = getAttributeInteger(context, parser, null, "product-id", -1); if (productId == -1) productId = getAttributeInteger(context, parser, null, "productId", -1); deviceClass = getAttributeInteger(context, parser, null, "class", -1); deviceSubclass = getAttributeInteger(context, parser, null, "subclass", -1); deviceProtocol = getAttributeInteger(context, parser, null, "protocol", -1); manufacturerName = getAttributeString(context, parser, null, "manufacturer-name", null); if (TextUtils.isEmpty(manufacturerName)) manufacturerName = getAttributeString(context, parser, null, "manufacture", null); productName = getAttributeString(context, parser, null, "product-name", null); if (TextUtils.isEmpty(productName)) productName = getAttributeString(context, parser, null, "product", null); serialNumber = getAttributeString(context, parser, null, "serial-number", null); if (TextUtils.isEmpty(serialNumber)) serialNumber = getAttributeString(context, parser, null, "serial", null); exclude = getAttributeBoolean(context, parser, null, "exclude", false); } else if (eventType == XmlPullParser.END_TAG) { if (hasValue) { return new DeviceFilter(vendorId, productId, deviceClass, deviceSubclass, deviceProtocol, manufacturerName, productName, serialNumber, exclude); } } } eventType = parser.next(); } return null; } |

这个解析是主要解析过程，后面会用到，这里要明白这个解析出来的规则后面会用来进行设备过滤，符合规则的设备就进行显示，不符合规则的设备就不显示。

这里解析主要解析了vendorId，productId，class，subclass，protocol，manufacture，serial，exclude等字段，也就是说这些字段其实都可以配置在xml中，如果xml中定义了这些内容，则会被解析到，如果没有定义，则返回结果为-1。
exclude字段是排除的意思，也就是如果定义了这个字段，则这一项xml为排除项，如果匹配上则要把这个device排除掉，这是一个反向过滤标志。

在读到xml的末尾标签，则会创建DeviceFilter对象：

|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 | } else if (eventType == XmlPullParser.END_TAG) { if (hasValue) { return new DeviceFilter(vendorId, productId, deviceClass, deviceSubclass, deviceProtocol, manufacturerName, productName, serialNumber, exclude); } } |

在之前的上一层会循环解析这个xml文件，将所有解析到的DeviceFilter放在list里面，用于之后的设备匹配。

在updateDevices的第二行可以看到：

|-----------|--------------------------------------------------------------------------------------------------------------| | 1 | mDeviceListAdapter = new DeviceListAdapter(getActivity(), mUSBMonitor.getDeviceList(filter.get(0))); |

这里有个点需要注意，代码写的是：
mUSBMonitor.getDeviceList(filter.get(0))，如果想用filter解析出来的xml项都进行匹配，则直接传入filter即可，不用filter.get(0)选择第一个，如果写了filter.get(0)，则xml中的内容次序就会有关系，也就是说只会使用第一个进行匹配，其他的会忽略。
如果写filter.get(0)，又想多匹配设备，则xml可以写成如下：

|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 | <?xml version="1.0" encoding="utf-8"?> <resources>  <usb-device class="239" subclass="2" />   </resources> |

这里便进行了过滤匹配：

|---------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | /** * return device list, return empty list if no device matched * @param filter * @return * @throws IllegalStateException */ public List<UsbDevice> getDeviceList(final DeviceFilter filter) throws IllegalStateException { if (destroyed) throw new IllegalStateException("already destroyed"); final HashMap<String, UsbDevice> deviceList = mUsbManager.getDeviceList(); final List<UsbDevice> result = new ArrayList<UsbDevice>(); if (deviceList != null) { for (final UsbDevice device: deviceList.values() ) { if ((filter == null) || (filter.matches(device) && !filter.isExclude)) { result.add(device); } } } return result; } |

对于mUsbManager获取到的每个Device，如果设备的pid，vid和filter中的匹配上，也就是相等，并且exclude为false(上面已经对该字段进行了说明)，则把这个Device加入list，并赋值给Adapter进行展示。当然前提是需要有filter，没有的话可以创建任意一个即可。

那么现在逻辑就清楚了，如果要想展示自己想要展示的设备，可以编辑xml文件，加入自己的设备的pid，vid即可，也可以以class，subclass等来进行过滤，这样很多设备可能都会满足条件。