BluetoothLEAdvertisementPublisherTrigger クラス

定義

名前空間:

Windows.ApplicationModel.Background

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

public ref class BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
class BluetoothLEAdvertisementPublisherTrigger 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(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class BluetoothLEAdvertisementPublisherTrigger

function BluetoothLEAdvertisementPublisherTrigger()

Public NotInheritable Class BluetoothLEAdvertisementPublisherTrigger

継承

Object Platform::Object IInspectable BluetoothLEAdvertisementPublisherTrigger

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装

IBackgroundTrigger

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 です。
UseExtendedFormat	広告の発行元が拡張広告形式を使用することを指定します。

こちらもご覧ください

• IBackgroundTrigger