BluetoothLEAdvertisementPublisherTrigger Klasse

Definition

Namespace:

Windows.ApplicationModel.Background

Stellt einen Trigger dar, der registriert ist, um eine Bluetooth LE-Ankündigung im Hintergrund anzukündigen.

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

Vererbung

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IBackgroundTrigger

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Eine Hintergrundaufgabe wird gestartet, wenn sich die status des Hintergrundherausgebers ändert.

Dieser Trigger funktioniert ähnlich wie die BluetoothAdvertisementPublisher-Klasse, mit der Ausnahme, dass es mehr Einschränkungen gibt, da die App Werbung im Hintergrund verwalten kann. Nach der Registrierung wird der Hintergrundherausgeber bestmöglich bedient. Eine Hintergrundaufgabe wird gestartet, um die App auf dem status des Herausgebers zu benachrichtigen. Direkt nach der Registrierung wird erwartet, dass der status entweder Gestartet oder Warten sein wird (wenn der Trigger derzeit nicht gewartet werden kann). Die App wird auch über Fehler oder Unterbrechungen des Hintergrundherausgebers über die Triggerdetails im Hintergrundaufgabenkontext benachrichtigt. Um die Werbung zu beenden, muss die Registrierung der diesem Trigger zugeordneten Hintergrundaufgabe aufgehoben werden.

Die lokale Werberessource ist auf der Protokollebene begrenzt. Die Verwendung dieser Ressource eignet sich am besten für kontrollierte Szenarien wie Unternehmensanwendungsfälle. Andere Apps können um diese begrenzte Ressource konkurrieren, und die regelmäßige Ausstrahlung von Werbung für einen bestimmten Anwendungsfall kann nicht garantiert werden.

Die folgenden Ankündigungstypen sind zulässig:

• Herstellerspezifische Informationen (0xFF)
• Alle nicht standardmäßigen Typen, die nicht vom System reserviert sind, wie in der folgenden Liste dargestellt. Weitere Informationen zu nicht standardmäßigen Typen finden Sie unter Zugewiesene Nummern und GAP Bluetooth-Spezifikation.

Die folgenden Ankündigungstypen sind systemreservierend und nicht zulässig:

• Flags (0x01)
• Unvollständige Liste der 16-Bit-Dienst-UUIDs (0x02)
• Vollständige Liste der 16-Bit-Dienst-UUIDs (0x03)
• Unvollständige Liste der 32-Bit-Dienst-UUIDs (0x04)
• Vollständige Liste der 32-Bit-Dienst-UUIDs (0x05)
• Unvollständige Liste der 128-Bit-Dienst-UUIDs (0x06)
• Vollständige Liste der 128-Bit-Dienst-UUIDs (0x07)
• Gekürzter lokaler Name (0x08)
• Lokaler Name abschließen (0x09)
• Tx Power Level (0x0A)
• Geräteklasse (0x0D)
• Einfache Kopplung von Hash C192 (0x0E)
• Simple Pairing Randomizer R192 (0x0F)
• Security Manager TK-Werte (0x10)
• Sicherheits-Manager-Out-of-Band-Flags (0x11)
• Peripherieverbindungsintervallbereich (0x12)
• Liste der 16-Bit-Service Solicitation-UUIDs (0x14)
• Liste der 32-Bit-Service Solicitation-UUIDs (0x1F)
• Liste der 128-Bit-Service Solicitation-UUIDs (0x15)
• Dienstdaten 16-Bit-UUID (0x16)
• Dienstdaten 32-Bit-UUID (0x20)
• Dienstdaten 128-Bit-UUID (0x21)
• Öffentliche Zieladresse (0x17)
• Zufällige Zieladresse (0x18)
• Darstellung (0x19)
• Werbeintervall (0x1A)
• LE Bluetooth-Geräteadresse (0x1B)
• LE-Rolle (0x1C)
• Einfache Kopplung von Hash C256 (0x1D)
• Simple Pairing Randomizer R256 (0x1E)
• 3D-Informationsdaten (0x3D)

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
2004	19041	IncludeTransmitPowerLevel
2004	19041	IsAnonymous
2004	19041	PreferredTransmitPowerLevelInDBm
2004	19041	UseExtendedFormat

Konstruktoren

BluetoothLEAdvertisementPublisherTrigger()

Erstellt eine neue instance der BluetoothLEAdvertisementPublisherTrigger-Klasse.

Eigenschaften

Advertisement	Ruft die Bluetooth LE-Ankündigung ab, die im Hintergrund konfiguriert und veröffentlicht werden soll.
IncludeTransmitPowerLevel	Gibt an, ob der Übertragungsleistungsgrad im Ankündigungsheader enthalten ist. Der Standardwert lautet „False“.
IsAnonymous	Gibt an, ob die Geräteadresse im Ankündigungsheader enthalten ist. Standardmäßig ist die Adresse enthalten.
PreferredTransmitPowerLevelInDBm	Wenn angegeben, fordert das Funkgerät die angegebene Sendeleistungsstufe für die Werbung an. Standardwert ist NULL.
UseExtendedFormat	Gibt an, dass der Herausgeber der Werbung das Format für erweiterte Werbung verwenden soll.

Weitere Informationen

• IBackgroundTrigger