BluetoothLEAdvertisementPublisherTrigger 类

定义

命名空间:

Windows.ApplicationModel.Background

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

public ref class BluetoothLEAdvertisementPublisherTrigger sealed

/// [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.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 Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

实现

IBackgroundTrigger

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)
• 3D 信息数据 (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	指定广告发布者应使用扩展广告格式。

另请参阅

• IBackgroundTrigger