BluetoothLEAdvertisementPublisherTrigger Kelas

Definisi

Mewakili pemicu yang terdaftar untuk mengiklankan iklan Bluetooth LE di latar belakang.

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
Warisan
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger
Atribut
Penerapan

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Tugas latar belakang diluncurkan ketika status penerbit latar belakang berubah.

Pemicu ini berfungsi mirip dengan kelas BluetoothAdvertisementPublisher dengan pengecualian bahwa ia memiliki lebih banyak batasan karena memungkinkan aplikasi untuk mempertahankan iklan di latar belakang. Setelah terdaftar, penerbit latar belakang dilayankan dengan cara upaya terbaik. Tugas latar belakang akan diluncurkan untuk memberi tahu Aplikasi tentang status penerbit. Tepat setelah pendaftaran, status diharapkan dimulai atau Menunggu (jika pemicu tidak dapat dilayankan saat ini). Aplikasi ini juga diberi tahu tentang kegagalan atau gangguan penerbit latar belakang melalui detail pemicu yang disediakan dalam konteks tugas latar belakang. Untuk menghentikan iklan, tugas latar belakang yang terkait dengan pemicu ini harus tidak terdaftar.

Sumber daya iklan lokal terbatas pada lapisan protokol. Penggunaan sumber daya ini paling cocok untuk skenario terkontrol seperti kasus penggunaan perusahaan. Aplikasi lain dapat bersaing untuk sumber daya terbatas ini dan siaran iklan reguler untuk setiap kasus penggunaan tertentu tidak dapat dijamin.

Jenis iklan berikut diizinkan:

  • Informasi Spesifik Produsen (0xFF)
  • Jenis non-standar apa pun yang tidak dicadangkan oleh sistem, seperti yang ditunjukkan dalam daftar di bawah ini. Untuk informasi selengkapnya tentang jenis non-standar, lihat Spesifikasi Gap Bluetooth dan nomor yang ditetapkan .

Jenis iklan berikut dicadangkan sistem dan tidak diizinkan:

  • Bendera (0x01)
  • Daftar UUID Layanan 16-bit (0x02) tidak lengkap
  • Daftar Lengkap UUID Layanan 16-bit (0x03)
  • Daftar UUID Layanan 32-bit (0x04) tidak lengkap
  • Daftar Lengkap UUID Layanan 32-bit (0x05)
  • Daftar UUID Layanan 128-bit (0x06) tidak lengkap
  • Daftar Lengkap UUID Layanan 128-bit (0x07)
  • Nama Lokal yang Disingkat (0x08)
  • Nama Lokal Lengkap (0x09)
  • Tingkat Daya Tx (0x0A)
  • Kelas Perangkat (0x0D)
  • Simple Pairing Hash C192 (0x0E)
  • Pengacak Pemasangan Sederhana R192 (0x0F)
  • Nilai TK Manajer Keamanan (0x10)
  • Bendera Out-of-Band Manajer Keamanan (0x11)
  • Rentang Interval Koneksi Periferal (0x12)
  • Daftar UUID Permintaan Layanan 16-bit (0x14)
  • Daftar UUID Permintaan Layanan 32-bit (0x1F)
  • Daftar UUID Permintaan Layanan 128-bit (0x15)
  • UUID Data Layanan 16-bit (0x16)
  • UUID (0x20) Data Layanan 32-bit
  • Data Layanan UUID 128-bit (0x21)
  • Alamat Target Publik (0x17)
  • Alamat Target Acak (0x18)
  • Penampilan (0x19)
  • Interval Iklan (0x1A)
  • Alamat Perangkat Bluetooth LE (0x1B)
  • Peran LE (0x1C)
  • Hash Pemasangan Sederhana C256 (0x1D)
  • Pengacak Pemasangan Sederhana R256 (0x1E)
  • Data Informasi 3D (0x3D)

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
2004 19041 SertakanTransmitPowerLevel
2004 19041 IsAnonymous
2004 19041 PreferredTransmitPowerLevelInDBm
2004 19041 UseExtendedFormat

Konstruktor

BluetoothLEAdvertisementPublisherTrigger()

Membuat instans baru kelas BluetoothLEAdvertisementPublisherTrigger .

Properti

Advertisement

Mendapatkan iklan BLUETOOTH LE untuk mengonfigurasi dan menerbitkan di latar belakang.

IncludeTransmitPowerLevel

Menentukan apakah tingkat daya transmisi disertakan dalam header iklan. Default ke False.

IsAnonymous

Menentukan apakah alamat perangkat disertakan dalam header iklan atau tidak. Secara default, alamat disertakan.

PreferredTransmitPowerLevelInDBm

Jika ditentukan, permintaan radio menggunakan tingkat daya transmisi yang ditunjukkan untuk iklan. Default ke Null.

UseExtendedFormat

Menentukan bahwa penerbit iklan harus menggunakan format Extended Advertising.

Berlaku untuk

Lihat juga