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