다음을 통해 공유


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)
  • 단순 페어링 임의 변환기 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)
  • 단순 페어링 임의 변환기 R256(0x1E)
  • 3D 정보 데이터(0x3D)

버전 기록

Windows 버전 SDK 버전 추가된 값
2004 19041 IncludeTransmitPowerLevel
2004 19041 IsAnonymous
2004 19041 PreferredTransmitPowerLevelInDBm
2004 19041 UseExtendedFormat

생성자

BluetoothLEAdvertisementPublisherTrigger()

BluetoothLEAdvertisementPublisherTrigger 클래스의 새 instance 만듭니다.

속성

Advertisement

백그라운드에서 구성하고 게시할 Bluetooth LE 광고를 가져옵니다.

IncludeTransmitPowerLevel

전송 전원 수준이 보급 알림 헤더에 포함되는지 여부를 지정합니다. 기본값은 False입니다.

IsAnonymous

디바이스 주소가 광고 헤더에 포함되는지 여부를 지정합니다. 기본적으로 주소가 포함됩니다.

PreferredTransmitPowerLevelInDBm

지정된 경우 라디오가 보급 알림에 대해 표시된 전송 전원 수준을 사용하도록 요청합니다. 기본값은 Null입니다.

PrimaryPhy

백그라운드에서 Bluetooth LE 광고를 보급하기 위해 등록된 트리거를 나타냅니다.

SecondaryPhy

백그라운드에서 Bluetooth LE 광고를 보급하기 위해 등록된 트리거를 나타냅니다.

UseExtendedFormat

광고 게시자가 확장 광고 형식을 사용하도록 지정합니다.

적용 대상

추가 정보