BluetoothLEAdvertisementPublisherTrigger Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Background

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

public ref class BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisherTrigger

function BluetoothLEAdvertisementPublisherTrigger()

Public NotInheritable Class BluetoothLEAdvertisementPublisherTrigger

Ereditarietà

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IBackgroundTrigger

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.

Vedi anche

• IBackgroundTrigger