BluetoothLEAdvertisementPublisher クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Bluetooth 低エネルギー (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
- 継承
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
アプリの機能 |
bluetooth
|
注釈
BluetoothLEAdvertisementPublisher クラスを使用すると、Bluetooth LE アドバタイズ パケットの構成とアドバタイズが可能になります。 広告リクエストはベストエフォートベースで処理され、広告パラメータは広告ポリシーによって定義されます。
アドバタイズのペイロードは、BluetoothLEAdvertisementPublisher が構築されるときに構成されます。 ペイロードは、BluetoothLEAdvertisementPublisher の Advertisement プロパティによって取得できます。 この方法で使用する場合は、呼び出し元が BluetoothLEAdvertisement クラスを管理する必要があります。 たとえば、一般的なデータ セクションへのアクセスを容易にするために実際のペイロードの重複が含まれているため、BluetoothLEAdvertisementReceivedEventArgs から取得した BluetoothLEAdvertisement を直接再利用することはお勧めしません。 受信した BluetoothLEAdvertisement を複製する必要がある場合は、生形式の広告データ セクションを表す DataSections プロパティのみをコピーする必要があります。
ローカルアドバタイズリソースはプロトコル層で制限されています。 このリソースの使用は、エンタープライズ ユース ケースなどの制御されたシナリオに最適です。 他のアプリは、この限られたリソースのために競合する可能性があり、特定のユースケースのための広告の定期的な放送は保証できません。
次の広告の種類を使用できます。
- 製造元固有の情報 (0xFF)
- 次の一覧に示すように、システムによって予約されていない標準以外の型。 標準以外の種類の詳細については、「 割り当てられた数値と GAP Bluetooth 仕様」を参照してください。
次のアドバタイズの種類はシステム予約であり、許可されていません。
- フラグ (0x01)
- 16 ビット サービス UUID の不完全な一覧 (0x02)
- 16 ビット サービス UUID の完全な一覧 (0x03)
- 32 ビット サービス UUID の不完全な一覧 (0x04)
- 32 ビット サービス UUID の完全な一覧 (0x05)
- 128 ビット サービス UUID の不完全な一覧 (0x06)
- 128 ビット サービス UUID の完全な一覧 (0x07)
- 短縮されたローカル名 (0x08)
- 完全なローカル名 (0x09)
- Tx 電源レベル (0x0A)
- デバイスのクラス (0x0D)
- 単純なペアリング ハッシュ C192 (0x0E)
- Simple Pairing Randomizer R192 (0x0F)
- Security Manager TK 値 (0x10)
- Security Manager 帯域外フラグ (0x11)
- 周辺機器の接続間隔範囲 (0x12)
- 16 ビット サービス要請 UUID の一覧 (0x14)
- 32 ビット サービス要請 UUID の一覧 (0x1F)
- 128 ビット サービス要請 UUID の一覧 (0x15)
- サービス データ 16 ビット UUID (0x16)
- サービス データ 32 ビット UUID (0x20)
- サービス データ 128 ビット UUID (0x21)
- パブリック ターゲット アドレス (0x17)
- ランダム ターゲット アドレス (0x18)
- 外観 (0x19)
- 広告間隔 (0x1A)
- LE Bluetooth デバイス アドレス (0x1B)
- LE ロール (0x1C)
- 単純なペアリング ハッシュ C256 (0x1D)
- Simple Pairing Randomizer R256 (0x1E)
- 3D 情報データ (0x3D)
バージョン履歴
Windows のバージョン | SDK バージョン | 追加された値 |
---|---|---|
2004 | 19041 | IncludeTransmitPowerLevel |
2004 | 19041 | IsAnonymous |
2004 | 19041 | PreferredTransmitPowerLevelInDBm |
2004 | 19041 | UseExtendedAdvertisement |
コンストラクター
BluetoothLEAdvertisementPublisher() | |
BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement) |
発行する Bluetooth LE アドバタイズを使用して、新しい BluetoothLEAdvertisementPublisher オブジェクトを作成します。 |
プロパティ
Advertisement |
発行する Bluetooth LE アドバタイズのコピーを取得します。 パブリッシャー オブジェクトを構成するときに、制限付きセクションの種類 (BluetoothLEAdvertisementPublisher.Advertisement.Flags と BluetoothLEAdvertisementPublisher.Advertisement.LocalName) を追加することはできません。 これらのプロパティ値を設定しようとすると、ランタイム例外が発生します。 製造元のデータ セクション、または制限の一覧で定義されていないその他のセクションは、引き続き設定できます。 |
IncludeTransmitPowerLevel |
送信電力レベルをアドバタイズ ヘッダーに含めるかどうかを指定します。 既定値は False です。 |
IsAnonymous |
デバイス アドレスをアドバタイズ ヘッダーに含めるかどうかを指定します。 既定では、アドレスが含まれます。 |
PreferredTransmitPowerLevelInDBm |
指定した場合は、指定された送信電力レベルをアドバタイズに無線で使用することを要求します。 既定値は Null です。 |
PrimaryPhy |
Bluetooth 低エネルギー (LE) アドバタイズを送信するオブジェクト。 |
SecondaryPhy |
Bluetooth 低エネルギー (LE) アドバタイズを送信するオブジェクト。 |
Status |
BluetoothLEAdvertisementPublisher の現在の状態を取得します。 |
UseExtendedAdvertisement |
広告の発行元が拡張広告形式を使用することを指定します。 |
メソッド
Start() |
Bluetooth LE アドバタイズ ペイロードのアドバタイズを開始します。 |
Stop() |
発行元を停止し、Bluetooth LE アドバタイズ ペイロードのアドバタイズを停止します。 |
イベント
StatusChanged |
BluetoothLEAdvertisementPublisher の状態が変更されたことを示す通知。 |