BluetoothLEAdvertisementPublisherTrigger 类

定义

表示注册以在后台播发蓝牙 LE 播发的触发器。

public ref class BluetoothLEAdvertisementPublisherTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BluetoothLEAdvertisementPublisherTrigger final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisherTrigger final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BluetoothLEAdvertisementPublisherTrigger
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisherTrigger
function BluetoothLEAdvertisementPublisherTrigger()
Public NotInheritable Class BluetoothLEAdvertisementPublisherTrigger
继承
Object IInspectable BluetoothLEAdvertisementPublisherTrigger
属性
实现

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

注解

后台发布服务器的状态发生更改时,将启动后台任务。

此触发器的工作方式类似于 BluetoothAdvertisementPublisher 类,但例外是它具有更多限制,因为它允许应用在后台维护广告。 注册后,后台发布者会尽最大努力地提供服务。 将启动后台任务,以通知应用发布者的状态。 注册后,如果触发器目前无法) ,则状态应为“已启动”或“正在等待” (。 该应用还通过后台任务上下文中提供的触发器详细信息通知后台发布者失败或中断。 若要停止播发,必须取消注册与此触发器关联的后台任务。

本地播发资源在协议层受到限制。 此资源的用法最适合于受控方案,例如企业用例。 其他应用可能会争夺此有限的资源,并且无法保证任何特定用例的定期播发。

允许以下播发类型:

  • 制造商特定信息 (0xFF)
  • 系统不保留的任何非标准类型,如下面的列表所示。 有关非标准类型的详细信息,请参阅 分配的数字和 GAP 蓝牙规范。

以下播发类型是系统保留的,不允许:

  • 标志 (0x01)
  • 16 位服务 UUID (0x02) 不完整列表
  • 16 位服务 UUID 的完整列表 (0x03)
  • 32 位服务 UUID (0x04) 不完整的列表
  • 32 位服务 UUID 的完整列表 (0x05)
  • 128 位服务 UUID (0x06) 不完整列表
  • 128 位服务 UUID 的完整列表 (0x07)
  • 缩短的本地名称 (0x08)
  • 完整本地名称 (0x09)
  • Tx 电源级别 (0x0A)
  • 设备 (0x0D) 类
  • 简单配对哈希 C192 (0x0E)
  • 简单配对随机器 R192 (0x0F)
  • 安全管理器 TK 值 (0x10)
  • 安全管理器带外标志 (0x11)
  • 外围连接间隔范围 (0x12)
  • 16 位服务请求 UUID 列表 (0x14)
  • 32 位服务请求 UUID 列表 (0x1F)
  • 128 位服务请求 UUID 列表 (0x15)
  • 服务数据 16 位 UUID (0x16)
  • 服务数据 32 位 UUID (0x20)
  • 服务数据 128 位 UUID (0x21)
  • 公共目标地址 (0x17)
  • 随机目标地址 (0x18)
  • 外观 (0x19)
  • 广告间隔 (0x1A)
  • LE 蓝牙设备地址 (0x1B)
  • LE 角色 (0x1C)
  • 简单配对哈希 C256 (0x1D)
  • 简单配对随机器 R256 (0x1E)
  • 三维信息数据 (0x3D)

版本历史记录

Windows 版本 SDK 版本 已添加值
2004 19041 IncludeTransmitPowerLevel
2004 19041 IsAnonymous
2004 19041 PreferredTransmitPowerLevelInDBm
2004 19041 UseExtendedFormat

构造函数

BluetoothLEAdvertisementPublisherTrigger()

创建 BluetoothLEAdvertisementPublisherTrigger 类的新实例。

属性

Advertisement

获取在后台配置和发布的蓝牙 LE 播发。

IncludeTransmitPowerLevel

指定传输电源级别是否包含在播发标头中。 默认为 False。

IsAnonymous

指定是否在播发标头中包含设备地址。 默认情况下,将包含该地址。

PreferredTransmitPowerLevelInDBm

如果指定,则请求无线电使用广告的指示传输功率级别。 默认值为 Null。

UseExtendedFormat

指定广告发布者应使用扩展广告格式。

适用于

另请参阅