BluetoothLEAdvertisementPublisherTrigger Classe

Definizione

Rappresenta un trigger registrato per annunciare un annuncio Bluetooth LE in background.

public ref class BluetoothLEAdvertisementPublisherTrigger sealed
/// [Windows.Foundation.Metadata.Activatable(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 BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisherTrigger final
[Windows.Foundation.Metadata.Activatable(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 BluetoothLEAdvertisementPublisherTrigger
[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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisherTrigger
function BluetoothLEAdvertisementPublisherTrigger()
Public NotInheritable Class BluetoothLEAdvertisementPublisherTrigger
Ereditarietà
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Un'attività in background viene avviata quando lo stato dell'autore in background cambia.

Questo trigger funziona in modo analogo alla classe BluetoothAdvertisementPublisher, ad eccezione del fatto che ha più restrizioni in quanto consente all'app di mantenere la pubblicità in background. Dopo la registrazione, l'autore in background viene eseguito in modo ottimale. Verrà avviata un'attività in background per notificare all'app lo stato del server di pubblicazione. Subito dopo la registrazione, lo stato dovrebbe essere Avviato o In attesa (se non è possibile gestire il trigger al momento). L'app riceve anche una notifica di errori o interruzioni dell'autore in background tramite i dettagli del trigger forniti nel contesto dell'attività in background. Per interrompere la pubblicità, l'attività in background associata a questo trigger deve essere annullata.

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 UseExtendedFormat

Costruttori

BluetoothLEAdvertisementPublisherTrigger()

Crea una nuova istanza della classe BluetoothLEAdvertisementPublisherTrigger .

Proprietà

Advertisement

Ottiene l'annuncio Bluetooth LE per configurare e pubblicare in background.

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.

UseExtendedFormat

Specifica che l'editore dell'annuncio deve utilizzare il formato Extended Advertising.

Si applica a

Vedi anche