BluetoothLEAdvertisementPublisher Classe

Référence

Définition

Espace de noms:: Windows.Devices.Bluetooth.Advertisement

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Objet pour envoyer des publicités Bluetooth Low Energy (LE).

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

Héritage: Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher

Attributs: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	bluetooth

Remarques

La classe BluetoothLEAdvertisementPublisher permet la configuration et la publicité d’un paquet de publicité Bluetooth LE. La demande de publicité est prise en compte dans le meilleur des efforts et les paramètres publicitaires sont définis par une politique publicitaire.

La charge utile de la publication est configurée lorsque BluetoothLEAdvertisementPublisher est construit. La charge utile peut être récupérée par la propriété Advertisement de BluetoothLEAdvertisementPublisher. La classe BluetoothLEAdvertisement doit être gérée par l’appelant si elle est utilisée de cette façon. Par exemple, il n’est pas recommandé de réutiliser directement un BluetoothLEAdvertisement obtenu à partir d’un BluetoothLEAdvertisementReceivedEventArgs , car il contient la duplication de la charge utile réelle afin de faciliter l’accès aux sections de données courantes. Si un BluetoothLEAdvertisement reçu doit être dupliqué, seule la propriété DataSections doit être copiée, car elles représentent les sections de données de publication dans leur forme brute.

La ressource de publicité locale est limitée au niveau de la couche de protocole. L’utilisation de cette ressource est mieux adaptée aux scénarios contrôlés tels que les cas d’usage d’entreprise. D’autres applications peuvent concurrencer pour cette ressource limitée et la diffusion régulière de publicités pour n’importe quel cas d’usage spécifique ne peut pas être garantie.

Les types de publicité suivants sont autorisés :

Informations spécifiques au fabricant (0xFF)
Tout type non standard non réservé par le système, comme indiqué dans la liste ci-dessous. Pour plus d’informations sur les types non standard, consultez Numéros attribués et spécification Bluetooth GAP .

Les types de publicité suivants sont réservés par le système et ne sont pas autorisés :

Indicateurs (0x01)
Liste incomplète des UUID de service 16 bits (0x02)
Liste complète des UUID de service 16 bits (0x03)
Liste incomplète des UUID de service 32 bits (0x04)
Liste complète des UUID de service 32 bits (0x05)
Liste incomplète des UUID de service 128 bits (0x06)
Liste complète des UUID de service 128 bits (0x07)
Nom local abrégé (0x08)
Nom local complet (0x09)
Tx Power Level (0x0A)
Classe d’appareil (0x0D)
Hachage de couplage simple C192 (0x0E)
Randomr de couplage simple R192 (0x0F)
Valeurs TK de Security Manager (0x10)
Indicateurs hors bande de Security Manager (0x11)
Plage d’intervalles de connexion périphérique (0x12)
Liste des UUID de sollicitation de service 16 bits (0x14)
Liste des UUID de sollicitation de service 32 bits (0x1F)
Liste des UUID de sollicitation de service 128 bits (0x15)
Service Data UUID 16 bits (0x16)
Service Data UUID 32 bits (0x20)
UUID (0x21) des données de service 128 bits
Adresse cible publique (0x17)
Adresse cible aléatoire (0x18)
Apparence (0x19)
Intervalle publicitaire (0x1A)
Adresse de l’appareil Bluetooth LE (0x1B)
Rôle LE (0x1C)
Hachage de couplage simple C256 (0x1D)
Randomr de jumelage simple R256 (0x1E)
Données d’information 3D (0x3D)

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
2004	19041	IncludeTransmitPowerLevel
2004	19041	IsAnonymous
2004	19041	PreferredTransmitPowerLevelInDBm
2004	19041	UseExtendedAdvertisement

Constructeurs

BluetoothLEAdvertisementPublisher()	Crée un objet BluetoothLEAdvertisementPublisher .
BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)	Crée un objet BluetoothLEAdvertisementPublisher avec la publicité Bluetooth LE à publier.

Propriétés

Advertisement	Obtient une copie de la publicité Bluetooth LE à publier. Lors de la configuration de l’objet publisher, vous ne pouvez pas ajouter de types de section restreints (BluetoothLEAdvertisementPublisher.Advertisement.Flags et BluetoothLEAdvertisementPublisher.Advertisement.LocalName). La tentative de définition de ces valeurs de propriété entraîne une exception de runtime. Vous pouvez toujours définir la section des données du fabricant ou toute autre section non définie par la liste des restrictions.
IncludeTransmitPowerLevel	Spécifie si le niveau d’alimentation de transmission est inclus dans l’en-tête de la publicité. Valeur par défaut False.
IsAnonymous	Spécifie si l’adresse de l’appareil est incluse ou non dans l’en-tête de la publicité. Par défaut, l’adresse est incluse.
PreferredTransmitPowerLevelInDBm	Si spécifié, demande à la radio d’utiliser le niveau de puissance de transmission indiqué pour la publicité. La valeur par défaut est Null.
Status	Obtient la status actuelle de BluetoothLEAdvertisementPublisher.
UseExtendedAdvertisement	Spécifie que l’éditeur de publicité doit utiliser le format Publicité étendue.

Méthodes

Start()	Commencez à publier une charge utile de publicité Bluetooth LE.
Stop()	Arrêtez l’éditeur et arrêtez la publicité d’une charge utile de publicité Bluetooth LE.

Événements

StatusChanged

Notification indiquant que le status du BluetoothLEAdvertisementPublisher a changé.

S’applique à

Partager via