BluetoothLEAdvertisementPublisher Klasse

Definition

Ein Objekt zum Senden von Bluetooth Low Energy (LE)-Ankündigungen.

public ref class BluetoothLEAdvertisementPublisher sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory, 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 BluetoothLEAdvertisementPublisher 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(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisher final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory), 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 BluetoothLEAdvertisementPublisher
[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(typeof(Windows.Devices.Bluetooth.Advertisement.IBluetoothLEAdvertisementPublisherFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisher
function BluetoothLEAdvertisementPublisher(advertisement)
Public NotInheritable Class BluetoothLEAdvertisementPublisher
Vererbung
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen
bluetooth

Hinweise

Die BluetoothLEAdvertisementPublisher-Klasse ermöglicht die Konfiguration und Werbung eines Bluetooth LE-Ankündigungspakets. Die Werbeanfrage wird nach bestem Aufwand bedient, und die Werbeparameter werden durch eine Werberichtlinie definiert.

Die Nutzlast der Ankündigung wird konfiguriert, wenn bluetoothLEAdvertisementPublisher erstellt wird. Die Nutzlast kann von der Advertisement-Eigenschaft des BluetoothLEAdvertisementPublisher abgerufen werden. Die BluetoothLEAdvertisement-Klasse muss vom Aufrufer verwaltet werden, wenn sie auf diese Weise verwendet wird. Es wird beispielsweise nicht empfohlen, ein BluetoothLEAdvertisement , das von einem BluetoothLEAdvertisementReceivedEventArgs abgerufen wurde, direkt wiederzuverwenden, da es eine Duplizierung der tatsächlichen Nutzlast enthält, um den Zugriff auf allgemeine Datenabschnitte zu erleichtern. Wenn ein empfangenes BluetoothLEAdvertisement dupliziert werden muss, sollte nur die DataSections-Eigenschaft kopiert werden, da sie die Ankündigungsdatenabschnitte in ihrer unformatierten Form darstellen.

Die lokale Ankündigungsressource ist auf Protokollebene beschränkt. 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 Übertragung 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 in der Spezifikation Zugewiesene Nummern und GAP Bluetooth.

Die folgenden Ankündigungstypen sind systemseitig reserviert 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)
  • Verkürzter lokaler Name (0x08)
  • Lokaler Name abschließen (0x09)
  • Tx Power Level (0x0A)
  • Geräteklasse (0x0D)
  • Simple Pairing Hash C192 (0x0E)
  • Simple Pairing Randomizer R192 (0x0F)
  • Security Manager TK-Werte (0x10)
  • Security Manager-Out-of-Band-Flags (0x11)
  • Peripherieverbindungsintervallbereich (0x12)
  • Liste der 16-Bit-UUIDs für Service Solicitation (0x14)
  • Liste der 32-Bit Service Solicitation UUIDs (0x1F)
  • Liste der 128-Bit-UUIDs für Service Solicitation (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)
  • Simple Pairing Hash C256 (0x1D)
  • Simple Pairing Randomizer R256 (0x1E)
  • 3D-Informationsdaten (0x3D)

Versionsverlauf

Windows-Version SDK-Version Mehrwert
2004 19041 IncludeTransmitPowerLevel
2004 19041 IsAnonymous
2004 19041 PreferredTransmitPowerLevelInDBm
2004 19041 UseExtendedAdvertisement

Konstruktoren

BluetoothLEAdvertisementPublisher()

Erstellt ein neues BluetoothLEAdvertisementPublisher-Objekt .

BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)

Erstellt ein neues BluetoothLEAdvertisementPublisher-Objekt mit der Bluetooth LE-Ankündigung, die veröffentlicht werden soll.

Eigenschaften

Advertisement

Ruft eine Kopie der zu veröffentlichenden Bluetooth LE-Ankündigung ab.

Beim Konfigurieren des Herausgeberobjekts können Sie keine eingeschränkten Abschnittstypen (BluetoothLEAdvertisementPublisher.Advertisement.Flags und BluetoothLEAdvertisementPublisher.Advertisement.LocalName) hinzufügen. Der Versuch, diese Eigenschaftswerte festzulegen, führt zu einer Laufzeit-Ausnahme. Sie können weiterhin den Abschnitt "Herstellerdaten" oder andere Abschnitte festlegen, die nicht durch die Liste der Einschränkungen definiert sind.

IncludeTransmitPowerLevel

Gibt an, ob die Übertragungsleistung 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. Der Standardwert ist Null.

PrimaryPhy

Ein Objekt zum Senden von Bluetooth Low Energy (LE)-Ankündigungen.

SecondaryPhy

Ein Objekt zum Senden von Bluetooth Low Energy (LE)-Ankündigungen.

Status

Ruft den aktuellen status von BluetoothLEAdvertisementPublisher ab.

UseExtendedAdvertisement

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

Methoden

Start()

Beginnen Sie mit der Ankündigung einer Bluetooth LE-Ankündigungsnutzlast.

Stop()

Beenden Sie den Herausgeber, und beenden Sie die Ankündigung einer Bluetooth LE-Ankündigungsnutzlast.

Ereignisse

StatusChanged

Benachrichtigung, dass sich die status des BluetoothLEAdvertisementPublishers geändert hat.

Gilt für:

Weitere Informationen