蓝牙BLE上位机工具开发理论线索梳理_3.WINRT Devices设备相关

1.WINRT关于Devices设备相关的命名空间

        关于WINRT科以参考下面这篇博文学习理解。以下列出Devices设备相关的API命名空间。

理解WinRT - 厚积薄发 - C++博客

2.Windows.Devices.Enumeration 命名空间

        提供用于枚举设备的类。 以下是 Windows.Devices.Enumeration API 的典型用法。

• 生成用于选择要由应用程序使用的设备的用户界面。 例如，语音聊天应用程序可能会提供麦克风或网络摄像头列表供用户选择，或者照片导入应用程序可能提供可移动存储设备的列表，供用户从中导入照片。
• 获取有关连接到系统或可由系统发现的设备的常规信息。
• 设备发现和使用它们的应用的设备相关通知。

3.设备信息（  DeviceInformation ）属性        

          每个设备均有关联的 DeviceInformation 属性；当需要特定信息或生成设备选择器时，可使用这些属性。 高级查询语法 (AQS) 筛选器可用于指定这些属性，并限制具有指定特征的枚举设备。 此外，还可使用这些属性来指示要为每个设备返回的信息。 这样，便可指定返回到应用程序的设备信息。 如下图为蓝牙设备类中的DeviceInformation属性。

        DeviceInformation类如下图：

         其中常用的方法和属性如下，如标识 (DeviceInformation.Id)、种类 (DeviceInformation.Kind) 和属性包 (DeviceInformation.Properties) 。 DeviceInformation 对象的其他所有属性均派生自 Properties 属性包。 例如，Name 派生自 System.ItemNameDisplay。 这意味着，该属性包始终包含用于确定其他属性所需的信息。

        public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind);

        public string Id { get; }
        public DeviceInformationKind Kind { get; }
        public string Name { get; }
        public IReadOnlyDictionary<string, object> Properties { get; }

         在C#中对应的枚举类DeviceInformationKind:可以看到DeviceInformation的种类。

#region 程序集 Windows.Foundation.UniversalApiContract, Version=19.0.0.0, Culture=neutral, PublicKeyToken=null, ContentType=WindowsRuntime
// C:\Users\XXXXXX\.nuget\packages\microsoft.windows.sdk.contracts\10.0.26100.1\ref\netstandard2.0\Windows.Foundation.UniversalApiContract.winmd
#endregion

using Windows.Foundation;
using Windows.Foundation.Metadata;

namespace Windows.Devices.Enumeration
{
    [ContractVersion(typeof(UniversalApiContract), 65536)]
    public enum DeviceInformationKind
    {
        Unknown = 0,
        DeviceInterface = 1,
        DeviceContainer = 2,
        Device = 3,
        DeviceInterfaceClass = 4,
        AssociationEndpoint = 5,
        AssociationEndpointContainer = 6,
        AssociationEndpointService = 7,
        DevicePanel = 8,
        AssociationEndpointProtocol = 9
    }
}

        关于CreateWatcher的用法解释如下：
        public static DeviceWatcher CreateWatcher(string aqsFilter, IEnumerable<string> additionalProperties, DeviceInformationKind kind);
        这个方法的主要作用是根据提供的参数，创建一个设备监视器对象，用于监听和检索满足指定条件的设备信息。具体解释如下：

• aqsFilter：通过这个参数可以指定一个 AQS 过滤条件，例如可以筛选特定类型的设备（如打印机、摄像头等），或者特定属性（如设备名称包含某个关键字）。
• additionalProperties：允许指定额外需要获取的设备属性。如果希望除了默认提供的设备信息外，还需要某些额外的特定信息，可以通过这个参数传递。
• kind：确定要监视的设备信息类型。根据指定的 DeviceInformationKind 类型，可以选择监视基本设备信息、设备容量信息等不同种类的设备信息。

         举例：

        /// <summary>
        /// 搜索蓝牙设备
        /// </summary>
        public void StartBleDeviceWatcher()
        {
            string[] requestedProperties = { "System.Devices.Aep.DeviceAddress", "System.Devices.Aep.IsConnected", "System.Devices.Aep.Bluetooth.Le.IsConnectable" };
            string aqsAllBluetoothLEDevices = "(System.Devices.Aep.ProtocolId:=\"{bb7bb05e-5972-42b5-94fc-76eaa7084d49}\")";

            this.deviceWatcher =
                    DeviceInformation.CreateWatcher(
                        aqsAllBluetoothLEDevices,
                        requestedProperties,
                        DeviceInformationKind.AssociationEndpoint);

            // Register event handlers before starting the watcher.
            this.deviceWatcher.Added += this.DeviceWatcher_Added;
            this.deviceWatcher.Stopped += this.DeviceWatcher_Stopped;
            this.deviceWatcher.Start();
            string msg = "自动发现设备中..";

            this.MessAgeChanged(MsgType.NotifyTxt, msg);

          
        }

4. DeviceInformationKind 枚举 

AssociationEndpointProtocol

对于 AssociationEndpointProtocol 常量，AQS 选择器字符串示例为：

System.Devices.Aep.ProtocolId:="{e0cbf06c-cd8b-4647-bb8a-263b43f0f974}" 适用于蓝牙经典) 的 (或 System.Devices.Aep.ProtocolId:=:"{bb7bb05e-5972-42b5-94fc-76eaa7084d49}" 蓝牙 LE) 的 (。

System.Devices.Aep.ProtocolId 是 propsys 中的协议名称;DEVPKEY_Aep_ProtocolId是 Win32 DEVPKEY。

 下面是枚举协议的代表性示例，以及它如何匹配 AEP 属性， (方括号内带有注释) 。

> pairtool /enum-protocols
...
Protocol ID:                Bluetooth [DEVPKEY_Aep_ProviderName]
Protocol Provider Name:     Bluetooth
Protocol Name:              Bluetooth Classic
Universal Protocol ID:      {e0cbf06c-cd8b-4647-bb8a-263b43f0f974} [DEVPKEY_Aep_ProtocolId // <propertyDescription name="System.Devices.Aep.ProtocolId" formatID="{3B2CE006-5E61-4FDE-BAB8-9B8AAC9B26DF}" propID="5">]
Protocol Provider Class ID: {4aa383d6-337a-43d3-a3fa-c14b26004130}

Protocol ID:                BluetoothLE [DEVPKEY_Aep_ProviderName]
Protocol Provider Name:     BluetoothLE
Protocol Name:              Bluetooth Low Energy
Universal Protocol ID:      {bb7bb05e-5972-42b5-94fc-76eaa7084d49} [DEVPKEY_Aep_ProtocolId]
Protocol Provider Class ID: {0829c308-d361-49f4-828b-506d552029ef} 
...
> pairtool /enum-endpoints

BluetoothLE#BluetoothLEdc:46:28:6a:16:01-20:4c:03:45:07:ca
  1)DEVPKEY_Aep_ContainerId [SYS] (null) DEVPROP_TYPE_GUID 16 {72888bff-567a-54f9-861a-73a3f2df469c} 
...
  30)DEVPKEY_Aep_ProviderName [SYS] (null) DEVPROP_TYPE_STRING 24 "BluetoothLE"
  33)DEVPKEY_Aep_ProtocolId [SYS] (null) DEVPROP_TYPE_GUID 16 {bb7bb05e-5972-42b5-94fc-76eaa7084d49}