WiFiDirectServiceAdvertiser Classe

Definizione

Spazio dei nomi:

Windows.Devices.WiFiDirect.Services

Rappresenta un inserzionista di servizi. Questa classe viene usata dal codice in un dispositivo che annuncia Wi-Fi Servizi diretti per annunciare il servizio.

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

Ereditarietà

Object Platform::Object IInspectable WiFiDirectServiceAdvertiser

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

Si tratta di una delle diverse classi che supportano la connessione di due dispositivi con una preferenza per cui il dispositivo deve essere proprietario del gruppo. Vedi l'argomento Windows.Devices.WiFiDirect.Service per una descrizione dell'associazione dei dispositivi e come può causare l'ignorare la preferenza proprietario del gruppo (e come risolverla).

Il nome del servizio viene impostato nel costruttore WiFiDirectServiceAdvertiser . I nomi dei servizi sono stringhe UTF-8 non più di 255 caratteri. È consigliabile che i nomi usino la notazione del nome di dominio inverso, in cui il nome DNS del proprietario del servizio (ad esempio "contoso.com") viene invertito e usato come inizio del nome del servizio ( ad esempio "com.contoso.serviceX"). Questa convenzione consente di scegliere facilmente nomi di servizio univoci. I nomi dei servizi che iniziano con "org.wi-fi.wfds" sono riservati per l'uso da parte del Wi-Fi Alliance e non è possibile usare tali nomi per il servizio.

Costruttori

WiFiDirectServiceAdvertiser(String)

Crea un'istanza della classe WiFiDirectServiceAdvertiser. Per avviare la pubblicità di un servizio Wi-Fi Direct, creare un'istanza di questa classe, impostarne le proprietà in modo appropriato per il servizio e quindi chiamare il relativo metodo Start .

Proprietà

AdvertisementStatus	Ottiene un valore che descrive lo stato corrente dell'annuncio.
AutoAcceptSession	Ottiene o imposta la proprietà Auto Accept per l'annuncio del servizio.
CustomServiceStatusCode	Ottiene o imposta un codice di stato del servizio personalizzato. Valido solo se il valore della proprietà ServiceStatus è Custom.
DeferredSessionInfo	Ottiene o imposta le informazioni specifiche del servizio passate a un richiedente di sessione quando si stabilisce una sessione non verranno completate immediatamente, come quando, ad esempio, il servizio è in attesa del completamento della richiesta da parte dell'utente. Un richiedente deve implementare un timeout di 120 secondi quando la richiesta viene posticipata.
PreferGroupOwnerMode	Ottiene o imposta un valore che indica se il servizio richiede che sia il proprietario del gruppo da peer a peer diretto (P2P) Wi-Fi. Essendo proprietario del gruppo, il servizio può esercitare un maggiore controllo sulla configurazione della connessione P2P e sul processo di connessione. Per informazioni dettagliate, vedere le specifiche tecniche Wi-Fi Direct P2P, disponibili in Wi-Fi Alliance.
PreferredConfigurationMethods	Ottiene un elenco (che implementa l'interfaccia IVector ) dei metodi di configurazione della sessione preferiti. Il codice usa operazioni IVector nell'elenco per aggiungere o rimuovere elementi dall'elenco.
ServiceError	Ottiene un codice di errore specifico quando AdvertisementStatus viene interrotto.
ServiceInfo	Ottiene o imposta il BLOB delle informazioni del servizio. Il formato e il contenuto del BLOB sono determinati dal singolo servizio e sono destinati a essere usati dai cercatori durante l'individuazione del servizio.
ServiceName	Ottiene il nome del servizio.
ServiceNamePrefixes	Ottiene un elenco di prefissi di nome del servizio che devono corrispondere a questo servizio quando un cercatore usa la ricerca di prefisso. Il codice usa i metodi IVector per aggiungere o rimuovere elementi dall'elenco.
ServiceStatus	Ottiene o imposta lo stato del servizio.

Metodi

ConnectAsync(DeviceInformation)	Accetta una richiesta di sessione senza richiedere un PIN.
ConnectAsync(DeviceInformation, String)	Accetta una richiesta di sessione connettendosi con il PIN specificato.
Start()	Avvia la pubblicità del servizio, utilizzando i valori correnti delle proprietà per impostare i parametri dell'annuncio pubblicitario.
Stop()	Arresta la pubblicità del servizio. Ciò non influisce sulle sessioni esistenti connesse al servizio.

Eventi

AdvertisementStatusChanged	Evento generato quando il valore della proprietà AdvertisementStatus viene modificato.
AutoAcceptSessionConnected	Evento generato quando il servizio ha accettato automaticamente una richiesta di sessione. Il gestore eventi deve stabilire connessioni socket per le coppie di endpoint elencate nell'oggetto argomenti dell'evento.
SessionRequested	Evento generato quando un cercatore ha richiesto che una sessione venga stabilita con il servizio associato a questa istanza di WiFiDirectServiceAdvertiser. Per accettare la richiesta, chiama WiFiDirectServiceAdvertiser.ConnectAsync nel gestore eventi.