BluetoothLEAdvertisementPublisher Kelas

Definisi

Ruang nama:

Windows.Devices.Bluetooth.Advertisement

Objek untuk mengirim iklan 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

Warisan

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisher

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi	bluetooth

Keterangan

Kelas BluetoothLEAdvertisementPublisher memungkinkan konfigurasi dan iklan paket iklan Bluetooth LE. Permintaan iklan dilayankan berdasarkan upaya terbaik dan parameter iklan didefinisikan oleh kebijakan iklan.

Payload iklan dikonfigurasi ketika BluetoothLEAdvertisementPublisher dibangun. Payload dapat diambil oleh properti Iklan dari BluetoothLEAdvertisementPublisher. Kelas BluetoothLEAdvertisement harus dikelola oleh pemanggil jika digunakan dengan cara ini. Misalnya, tidak disarankan untuk langsung menggunakan kembali BluetoothLEAdvertisement yang diperoleh dari BluetoothLEAdvertisementReceivedEventArgs karena berisi duplikasi payload aktual untuk memfasilitasi akses ke bagian data umum. Jika BluetoothLEAdvertisement yang diterima perlu diduplikasi, hanya properti DataSections yang harus disalin, karena mewakili bagian data iklan dalam bentuk mentah mereka.

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 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 Nomor yang ditetapkan dan spesifikasi GAP Bluetooth.

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 Dipersingkat (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)
• Data Layanan UUID 16-bit (0x16)
• Data Layanan UUID 32-bit (0x20)
• Data Layanan UUID 128-bit (0x21)
• Alamat Target Publik (0x17)
• Alamat Target Acak (0x18)
• Tampilan (0x19)
• Interval Iklan (0x1A)
• Alamat Perangkat Bluetooth LE (0x1B)
• Peran LE (0x1C)
• Simple Pairing Hash 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	UseExtendedAdvertisement

Konstruktor

BluetoothLEAdvertisementPublisher()	Membuat objek BluetoothLEAdvertisementPublisher baru.
BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)	Membuat objek BluetoothLEAdvertisementPublisher baru dengan iklan BLUETOOTH LE untuk diterbitkan.

Properti

Advertisement	Mendapatkan salinan iklan Bluetooth LE untuk dipublikasikan. Saat mengonfigurasi objek penerbit, Anda tidak dapat menambahkan jenis bagian terbatas (BluetoothLEAdvertisementPublisher.Advertisement.Flags dan BluetoothLEAdvertisementPublisher.Advertisement.LocalName). Mencoba mengatur nilai properti tersebut menghasilkan pengecualian runtime. Anda masih dapat mengatur bagian data produsen, atau bagian lain yang tidak ditentukan oleh daftar pembatasan.
IncludeTransmitPowerLevel	Menentukan apakah tingkat daya pengiriman 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 agar radio menggunakan tingkat daya transmisi yang ditunjukkan untuk iklan. Default ke Null.
Status	Mendapatkan status BluetoothLEAdvertisementPublisher saat ini.
UseExtendedAdvertisement	Menentukan bahwa penerbit iklan harus menggunakan format Extended Advertising.

Metode

Start()	Mulai iklan payload iklan Bluetooth LE.
Stop()	Hentikan penerbit dan hentikan iklan payload iklan Bluetooth LE.

Acara

StatusChanged

Pemberitahuan bahwa status BluetoothLEAdvertisementPublisher telah berubah.

Lihat juga

• BluetoothLEAdvertisement
• DataSections
• BluetoothLEAdvertisementReceivedEventArgs