次の方法で共有


BluetoothLEAdvertisementPublisherTrigger クラス

定義

バックグラウンドで Bluetooth LE アドバタイズをアドバタイズするために登録されているトリガーを表します。

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
継承
Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger
属性
実装

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

バックグラウンド パブリッシャーの状態が変更されると、バックグラウンド タスクが起動します。

このトリガーは BluetoothAdvertisementPublisher クラスと同様に機能しますが、アプリでバックグラウンドで広告を維持できるため、より多くの制限があります。 登録が完了すると、バックグラウンドパブリッシャーはベスト エフォート方式で処理されます。 バックグラウンド タスクが起動し、発行元の状態をアプリに通知します。 登録の直後に、状態は [開始] または [待機中] のいずれかになります (現時点でトリガーを処理できない場合)。 アプリは、バックグラウンド タスク コンテキストで提供されるトリガーの詳細を通じて、バックグラウンドパブリッシャーの障害または中断についても通知されます。 広告を停止するには、このトリガーに関連付けられているバックグラウンド タスクの登録を解除する必要があります。

ローカルアドバタイズリソースはプロトコル層で制限されています。 このリソースの使用は、エンタープライズ ユース ケースなどの制御されたシナリオに最適です。 他のアプリは、この限られたリソースのために競合する可能性があり、特定のユースケースのための広告の定期的な放送は保証できません。

次の広告の種類を使用できます。

  • 製造元固有の情報 (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 UseExtendedFormat

コンストラクター

BluetoothLEAdvertisementPublisherTrigger()

BluetoothLEAdvertisementPublisherTrigger クラスの新しいインスタンスを作成します。

プロパティ

Advertisement

バックグラウンドで構成および発行する Bluetooth LE アドバタイズを取得します。

IncludeTransmitPowerLevel

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

IsAnonymous

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

PreferredTransmitPowerLevelInDBm

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

PrimaryPhy

バックグラウンドで Bluetooth LE アドバタイズをアドバタイズするために登録されているトリガーを表します。

SecondaryPhy

バックグラウンドで Bluetooth LE アドバタイズをアドバタイズするために登録されているトリガーを表します。

UseExtendedFormat

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

適用対象

こちらもご覧ください