# Print output for @column tags ?>
public
static
final
class
WifiAwareNetworkSpecifier.Builder
extends Object
java.lang.Object | |
↳ | android.net.wifi.aware.WifiAwareNetworkSpecifier.Builder |
A builder class for a Wi-Fi Aware network specifier to set up an Aware connection with a peer.
Public constructors | |
---|---|
Builder(DiscoverySession discoverySession, PeerHandle peerHandle)
Create a builder for |
Public methods | |
---|---|
WifiAwareNetworkSpecifier
|
build()
Create a |
WifiAwareNetworkSpecifier.Builder
|
setPmk(byte[] pmk)
Configure the PMK for the Wi-Fi Aware connection being requested. |
WifiAwareNetworkSpecifier.Builder
|
setPort(int port)
Configure the port number which will be used to create a connection over this link. |
WifiAwareNetworkSpecifier.Builder
|
setPskPassphrase(String pskPassphrase)
Configure the PSK Passphrase for the Wi-Fi Aware connection being requested. |
WifiAwareNetworkSpecifier.Builder
|
setTransportProtocol(int transportProtocol)
Configure the transport protocol which will be used to create a connection over this link. |
Inherited methods | |
---|---|
public Builder (DiscoverySession discoverySession, PeerHandle peerHandle)
Create a builder for WifiAwareNetworkSpecifier
used in requests to set up a
Wi-Fi Aware connection with a peer.
Parameters | |
---|---|
discoverySession |
DiscoverySession : A Wi-Fi Aware discovery session in whose context the connection
is created.
This value cannot be null . |
peerHandle |
PeerHandle : The handle of the peer to which the Wi-Fi Aware connection is
requested. The peer is discovered through Wi-Fi Aware discovery. The
handle can be obtained through
DiscoverySessionCallback#onServiceDiscovered(PeerHandle, byte[], java.util.List)
or
DiscoverySessionCallback#onMessageReceived(PeerHandle, byte[]) .
This value cannot be null . |
public WifiAwareNetworkSpecifier build ()
Create a NetworkRequest.Builder.setNetworkSpecifier(NetworkSpecifier)
for a WiFi Aware connection (link) to the specified peer. The
NetworkRequest.Builder.addTransportType(int)
should be set to
NetworkCapabilities.TRANSPORT_WIFI_AWARE
.
The default builder constructor will initialize a NetworkSpecifier which requests an
open (non-encrypted) link. To request an encrypted link use the
setPskPassphrase(java.lang.String)
or setPmk(byte[])
builder methods.
Returns | |
---|---|
WifiAwareNetworkSpecifier |
A NetworkSpecifier to be used to construct
NetworkRequest.Builder.setNetworkSpecifier(NetworkSpecifier) to pass
to ConnectivityManager.requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback)
[or other varieties of that API].
This value cannot be null . |
public WifiAwareNetworkSpecifier.Builder setPmk (byte[] pmk)
Configure the PMK for the Wi-Fi Aware connection being requested. This method is optional - if not called, then an Open (unencrypted) connection will be created.
Parameters | |
---|---|
pmk |
byte : A PMK (pairwise master key, see IEEE 802.11i) specifying the key to use for
encrypting the data-path. Use the setPskPassphrase(java.lang.String) to
specify a Passphrase.
This value cannot be null . |
Returns | |
---|---|
WifiAwareNetworkSpecifier.Builder |
the current Builder builder, enabling chaining of builder
methods.
This value cannot be null . |
public WifiAwareNetworkSpecifier.Builder setPort (int port)
Configure the port number which will be used to create a connection over this link. This
configuration should only be done on the server device, e.g. the device creating the
ServerSocket
.
Notes:
setPskPassphrase(java.lang.String)
or setPmk(byte[])
.
Parameters | |
---|---|
port |
int : A positive integer indicating the port to be used for communication.
Value is between 0 and 65535 inclusive |
Returns | |
---|---|
WifiAwareNetworkSpecifier.Builder |
the current Builder builder, enabling chaining of builder
methods.
This value cannot be null . |
public WifiAwareNetworkSpecifier.Builder setPskPassphrase (String pskPassphrase)
Configure the PSK Passphrase for the Wi-Fi Aware connection being requested. This method is optional - if not called, then an Open (unencrypted) connection will be created.
Parameters | |
---|---|
pskPassphrase |
String : The (optional) passphrase to be used to encrypt the link. Use the
setPmk(byte[]) to specify a PMK.
This value cannot be null . |
Returns | |
---|---|
WifiAwareNetworkSpecifier.Builder |
the current Builder builder, enabling chaining of builder
methods.
This value cannot be null . |
public WifiAwareNetworkSpecifier.Builder setTransportProtocol (int transportProtocol)
Configure the transport protocol which will be used to create a connection over this
link. This configuration should only be done on the server device, e.g. the device
creating the ServerSocket
for TCP.
Notes:
setPskPassphrase(java.lang.String)
or setPmk(byte[])
.
Parameters | |
---|---|
transportProtocol |
int : The transport protocol to be used for communication.
Value is between 0 and 255 inclusive |
Returns | |
---|---|
WifiAwareNetworkSpecifier.Builder |
the current Builder builder, enabling chaining of builder
methods.
This value cannot be null . |