BluetoothLEAdvertisementPublisherTrigger Klasse

Definition

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.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
Vererbung
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger
Attribute
Implementiert

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.

PrimaryPhy

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

SecondaryPhy

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

UseExtendedFormat

Gibt an, dass der Herausgeber der Werbung das Format für erweiterte Werbung verwenden soll.

Gilt für:

Weitere Informationen