WiFiDirectServiceAdvertiser クラス

定義

名前空間:

Windows.Devices.WiFiDirect.Services

サービス広告主を表します。 このクラスは、ダイレクト サービスをアドバタイズするデバイス上のコード Wi-Fi 使用して、サービスをアドバタイズします。

public ref class WiFiDirectServiceAdvertiser sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class WiFiDirectServiceAdvertiser final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Devices.WiFiDirect.Services.IWiFiDirectServiceAdvertiserFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WiFiDirectServiceAdvertiser

function WiFiDirectServiceAdvertiser(serviceName)

Public NotInheritable Class WiFiDirectServiceAdvertiser

継承

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

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 で導入)

注釈

これは、グループ所有者であるデバイスを優先して 2 つのデバイスを接続することをサポートするいくつかのクラスの 1 つです。 デバイスのペアリングと、グループ所有者の基本設定を無視する方法 (およびそれを修正する方法) については、 Windows.Devices.WiFiDirect.Service トピックを参照してください。

サービス名は 、WiFiDirectServiceAdvertiser コンストラクターで設定されます。 サービス名は、255 文字以下の UTF-8 文字列です。 名前には逆ドメイン名表記を使用することをお勧めします。この表記では、サービス所有者の DNS 名 ("contoso.com" など) が逆になり、サービス名の先頭 ("com.contoso.serviceX" など) として使用されます。 この規則は、一意のサービス名を簡単に選択できるようにするためです。 "org.wi-fi.wfds" で始まるサービス名は、Wi-Fi Alliance で使用するために予約されており、サービスにこのような名前を使用することはできません。

コンストラクター

WiFiDirectServiceAdvertiser(String)

WiFiDirectServiceAdvertiser クラスのインスタンスを作成します。 Wi-Fi Direct Service のアドバタイズを開始するには、このクラスのインスタンスを作成し、サービスに適したプロパティを設定してから、 その Start メソッドを呼び出します。

プロパティ

AdvertisementStatus	アドバタイズの現在の状態を表す値を取得します。
AutoAcceptSession	このサービス提供情報の Auto Accept プロパティを取得または設定します。
CustomServiceStatusCode	カスタム サービスの状態コードを取得または設定します。 ServiceStatus プロパティの値が Custom の場合にのみ有効です。
DeferredSessionInfo	セッションの確立時にセッションリクエスターに渡されるサービス固有の情報を取得または設定します。これは、たとえば、サービスがユーザー入力が要求を完了するのを待機している場合のように、すぐには完了しません。 要求者は、要求が延期されたときに 120 秒のタイムアウトを実装する必要があります。
PreferGroupOwnerMode	サービスが Wi-Fi Direct Peer to Peer (P2P) グループ所有者である必要があるかどうかを示す値を取得または設定します。 グループ所有者である場合、サービスは P2P 接続構成と接続プロセスをより詳細に制御できます。 詳細については、Wi-Fi Alliance から入手できる Wi-Fi Direct P2P 技術仕様に関するページを参照してください。
PreferredConfigurationMethods	優先セッション構成メソッドの一覧 ( IVector インターフェイスを実装) を取得します。 コードでは、リストに対する IVector 操作を使用して、リストの要素を追加または削除します。
ServiceError	AdvertisementStatus が Aborted の場合に特定のエラー コードを取得します。
ServiceInfo	サービス情報 BLOB を取得または設定します。 BLOB の形式と内容は、個々のサービスによって決定され、サービスの検出時に Seekers によって使用されることを意図しています。
ServiceName	サービス名を取得します。
ServiceNamePrefixes	シークャーがプレフィックス検索を使用している場合に、このサービスと一致する必要があるサービス名プレフィックスの一覧を取得します。 コードでは 、IVector メソッドを使用して、リストの要素を追加または削除します。
ServiceStatus	サービスの状態を取得または設定します。

メソッド

ConnectAsync(DeviceInformation)	PIN を必要とせずにセッション要求を受け入れます。
ConnectAsync(DeviceInformation, String)	指定された PIN を使用して接続することで、セッション要求を受け入れます。
Start()	現在のプロパティ値を使用してアドバタイズのパラメーターを設定して、サービスのアドバタイズを開始します。
Stop()	サービスのアドバタイズを停止します。 これは、サービスに接続されている既存のセッションには影響しません。

イベント

AdvertisementStatusChanged	AdvertisementStatus プロパティの値が変更されたときに発生するイベント。
AutoAcceptSessionConnected	サービスがセッション要求を自動的に受け入れたときに発生するイベント。 イベント ハンドラーは、イベント引数オブジェクトに一覧表示されているエンドポイント ペアのソケット接続を確立する必要があります。
SessionRequested	Seeker がこの WiFiDirectServiceAdvertiser インスタンスに関連付けられているサービスとのセッションを確立することを要求したときに発生するイベントです。 要求を受け入れるには、イベント ハンドラーで WiFiDirectServiceAdvertiser.ConnectAsync を呼び出します。