BluetoothLEAdvertisementPublisher クラス

定義

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
継承
Object Platform::Object IInspectable 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 オブジェクトを作成 します。

BluetoothLEAdvertisementPublisher(BluetoothLEAdvertisement)

発行する Bluetooth LE アドバタイズを使用して、新しい BluetoothLEAdvertisementPublisher オブジェクトを作成します。

プロパティ

Advertisement

発行する Bluetooth LE アドバタイズのコピーを取得します。

パブリッシャー オブジェクトを構成するときに、制限付きセクションの種類 (BluetoothLEAdvertisementPublisher.Advertisement.FlagsBluetoothLEAdvertisementPublisher.Advertisement.LocalName) を追加することはできません。 これらのプロパティ値を設定しようとすると、ランタイム例外が発生します。 製造元のデータ セクション、または制限の一覧で定義されていないその他のセクションは、引き続き設定できます。

IncludeTransmitPowerLevel

送信電力レベルをアドバタイズ ヘッダーに含めるかどうかを指定します。 既定値は False です。

IsAnonymous

デバイス アドレスをアドバタイズ ヘッダーに含めるかどうかを指定します。 既定では、アドレスが含まれます。

PreferredTransmitPowerLevelInDBm

指定した場合は、指定された送信電力レベルをアドバタイズに無線で使用することを要求します。 既定値は Null です。

PrimaryPhy

Bluetooth 低エネルギー (LE) アドバタイズを送信するオブジェクト。

SecondaryPhy

Bluetooth 低エネルギー (LE) アドバタイズを送信するオブジェクト。

Status

BluetoothLEAdvertisementPublisher の現在の状態を取得します。

UseExtendedAdvertisement

広告の発行元が拡張広告形式を使用することを指定します。

メソッド

Start()

Bluetooth LE アドバタイズ ペイロードのアドバタイズを開始します。

Stop()

発行元を停止し、Bluetooth LE アドバタイズ ペイロードのアドバタイズを停止します。

イベント

StatusChanged

BluetoothLEAdvertisementPublisher の状態が変更されたことを示す通知。

適用対象

こちらもご覧ください