BluetoothLEAdvertisementPublisher Klasse

Referenz

Definition

Namespace:: Windows.Devices.Bluetooth.Advertisement

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.
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:

Freigeben über