BluetoothLEAdvertisementPublisher Classe

Definizione

Spazio dei nomi:

Windows.Devices.Bluetooth.Advertisement

Oggetto per l'invio di annunci Bluetooth Low Energy (LE).

public ref class BluetoothLEAdvertisementPublisher sealed

/// [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.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

Ereditarietà

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	bluetooth

Commenti

La classe BluetoothLEAdvertisementPublisher consente la configurazione e la pubblicità di un pacchetto pubblicitario Bluetooth LE. La richiesta pubblicitaria viene fornita in base al miglior sforzo e i parametri pubblicitari sono definiti da un criterio pubblicitario.

Il payload dell'annuncio viene configurato quando viene costruito BluetoothLEAdvertisementPublisher. Il payload può essere recuperato dalla proprietà Advertisement di BluetoothLEAdvertisementPublisher. La classe BluetoothLEAdvertisement deve essere gestita dal chiamante se usato in questo modo. Ad esempio, non è consigliabile riutilizzare direttamente un BluetoothLEAdvertisement ottenuto da bluetoothLEAdvertisementReceivedEventArgs perché contiene la duplicazione del payload effettivo per facilitare l'accesso alle sezioni di dati comuni. Se è necessario duplicare un BluetoothLEAdvertisement ricevuto, è necessario copiare solo la proprietà DataSections , perché rappresentano le sezioni dei dati dell'annuncio nel formato non elaborato.

La risorsa annuncio locale è limitata a livello di protocollo. L'utilizzo di questa risorsa è più adatto per scenari controllati, ad esempio casi d'uso aziendali. Altre app possono competere per questa risorsa limitata e la trasmissione regolare di annunci per qualsiasi caso d'uso specifico non può essere garantita.

Sono consentiti i seguenti tipi di annunci:

• Informazioni specifiche del produttore (0xFF)
• Qualsiasi tipo non standard non riservato dal sistema, come illustrato nell'elenco seguente. Per altre informazioni sui tipi non standard, vedere la specifica Gap Bluetooth e Numeri assegnati .

I tipi di annunci seguenti sono riservati dal sistema e non sono consentiti:

• Flag (0x01)
• Elenco incompleto degli UUID del servizio a 16 bit (0x02)
• Elenco completo degli UUID del servizio a 16 bit (0x03)
• Elenco incompleto di UUID del servizio a 32 bit (0x04)
• Elenco completo degli UUID del servizio a 32 bit (0x05)
• Elenco incompleto di UUID del servizio a 128 bit (0x06)
• Elenco completo degli UUID del servizio a 128 bit (0x07)
• Nome locale abbreviato (0x08)
• Nome locale completo (0x09)
• Tx Power Level (0x0A)
• Classe di dispositivo (0x0D)
• Hash di associazione semplice C192 (0x0E)
• Simple Pairing Randomizer R192 (0x0F)
• Valori TK di Security Manager (0x10)
• Flag fuori banda di Gestione sicurezza (0x11)
• Intervallo di connessione periferica (0x12)
• Elenco di UUID di richiesta di servizio a 16 bit (0x14)
• Elenco di UUID di richiesta di servizio a 32 bit (0x1F)
• Elenco di UUID di richiesta di servizio a 128 bit (0x15)
• UUID a 16 bit dei dati del servizio (0x16)
• UUID a 32 bit dei dati del servizio (0x20)
• UUID a 128 bit dei dati del servizio (0x21)
• Indirizzo di destinazione pubblico (0x17)
• Indirizzo di destinazione casuale (0x18)
• Aspetto (0x19)
• Intervallo annunci (0x1A)
• Indirizzo dispositivo Bluetooth LE (0x1B)
• Ruolo LE (0x1C)
• Hash di associazione semplice C256 (0x1D)
• Simple Pairing Randomizer R256 (0x1E)
• Dati informativi 3D (0x3D)

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
2004	19041	IncludeTransmitPowerLevel
2004	19041	IsAnonymous
2004	19041	PreferredTransmitPowerLevelInDBm
2004	19041	UseExtendedAdvertisement

Costruttori

BluetoothLEAdvertisementPublisher()	Crea un nuovo oggetto BluetoothLEAdvertisementPublisher .
BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)	Crea un nuovo oggetto BluetoothLEAdvertisementPublisher con l'annuncio Bluetooth LE da pubblicare.

Proprietà

Advertisement	Ottiene una copia dell'annuncio Bluetooth LE da pubblicare. Quando si configura l'oggetto editore, non è possibile aggiungere tipi di sezione con restrizioni (BluetoothLEAdvertisementPublisher.Advertisement.Flags e BluetoothLEAdvertisementPublisher.Advertisement.LocalName). Se si tenta di impostare tali valori di proprietà, viene generata un'eccezione di runtime. È comunque possibile impostare la sezione relativa ai dati del produttore o qualsiasi altra sezione non definita dall'elenco di restrizioni.
IncludeTransmitPowerLevel	Specifica se il livello di potenza di trasmissione è incluso nell'intestazione dell'annuncio. Il valore predefinito è False.
IsAnonymous	Specifica se l'indirizzo del dispositivo è incluso nell'intestazione dell'annuncio. Per impostazione predefinita, l'indirizzo è incluso.
PreferredTransmitPowerLevelInDBm	Se specificato, richiede che la radio usi il livello di potenza di trasmissione indicato per l'annuncio. Il valore predefinito è Null.
Status	Ottiene lo stato corrente di BluetoothLEAdvertisementPublisher.
UseExtendedAdvertisement	Specifica che l'editore dell'annuncio deve utilizzare il formato Extended Advertising.

Metodi

Start()	Avviare la pubblicità di un payload annuncio Bluetooth LE.
Stop()	Arrestare l'editore e interrompere la pubblicità di un payload annuncio Bluetooth LE.

Eventi

StatusChanged

Notifica che lo stato di BluetoothLEAdvertisementPublisher è stato modificato.

Vedi anche

• BluetoothLEAdvertisement
• DataSections
• BluetoothLEAdvertisementReceivedEventArgs