Partager via


BluetoothLEAdvertisementPublisher Classe

Définition

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

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.

PrimaryPhy

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

SecondaryPhy

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

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 à

Voir aussi