BluetoothLEAdvertisementPublisher Classe

Definizione

Oggetto per l'invio di annunci 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
Ereditarietà
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher
Attributi

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.

PrimaryPhy

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

SecondaryPhy

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

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.

Si applica a

Vedi anche