Most visited

Recently visited

Results for

ScanResult

public final class ScanResult
extends Object implements Parcelable

java.lang.Object
↳	android.net.wifi.ScanResult

Describes information about a detected access point. In addition to the attributes described here, the supplicant keeps track of quality, noise, and maxbitrate attributes, but does not currently report them to external clients.

Summary

Nested classes
`class`	`ScanResult.InformationElement` information elements from beacon.

Constants
`int`	`CHANNEL_WIDTH_160MHZ` AP Channel bandwidth is 160 MHZ
`int`	`CHANNEL_WIDTH_20MHZ` AP Channel bandwidth is 20 MHZ
`int`	`CHANNEL_WIDTH_40MHZ` AP Channel bandwidth is 40 MHZ
`int`	`CHANNEL_WIDTH_80MHZ` AP Channel bandwidth is 80 MHZ
`int`	`CHANNEL_WIDTH_80MHZ_PLUS_MHZ` AP Channel bandwidth is 160 MHZ, but 80MHZ + 80MHZ
`int`	`UNSPECIFIED` The unspecified value.
`int`	`WIFI_BAND_24_GHZ` Wi-Fi 2.4 GHz band.
`int`	`WIFI_BAND_5_GHZ` Wi-Fi 5 GHz band.
`int`	`WIFI_BAND_60_GHZ` Wi-Fi 60 GHz band.
`int`	`WIFI_BAND_6_GHZ` Wi-Fi 6 GHz band.
`int`	`WIFI_STANDARD_11AC` Wi-Fi 802.11ac
`int`	`WIFI_STANDARD_11AD` Wi-Fi 802.11ad
`int`	`WIFI_STANDARD_11AX` Wi-Fi 802.11ax
`int`	`WIFI_STANDARD_11N` Wi-Fi 802.11n
`int`	`WIFI_STANDARD_LEGACY` Wi-Fi 802.11a/b/g
`int`	`WIFI_STANDARD_UNKNOWN` Wi-Fi unknown standard

Inherited constants

From interface android.os.Parcelable

`int`	`CONTENTS_FILE_DESCRIPTOR` Descriptor bit used with `describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` Flag for use with `writeToParcel(Parcel, int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`".

Fields
`public String`	`BSSID` The address of the access point.
`public static final Creator<ScanResult>`	`CREATOR` Implement the Parcelable interface
`public String`	`SSID` The network name.
`public String`	`capabilities` Describes the authentication, key management, and encryption schemes supported by the access point.
`public int`	`centerFreq0` Not used if the AP bandwidth is 20 MHz If the AP use 40, 80 or 160 MHz, this is the center frequency (in MHz) if the AP use 80 + 80 MHz, this is the center frequency of the first segment (in MHz)
`public int`	`centerFreq1` Only used if the AP bandwidth is 80 + 80 MHz if the AP use 80 + 80 MHz, this is the center frequency of the second segment (in MHz)
`public int`	`channelWidth` AP Channel bandwidth; one of `CHANNEL_WIDTH_20MHZ`, `CHANNEL_WIDTH_40MHZ`, `CHANNEL_WIDTH_80MHZ`, `CHANNEL_WIDTH_160MHZ` or `CHANNEL_WIDTH_80MHZ_PLUS_MHZ`.
`public int`	`frequency` The primary 20 MHz frequency (in MHz) of the channel over which the client is communicating with the access point.
`public int`	`level` The detected signal level in dBm, also known as the RSSI.
`public CharSequence`	`operatorFriendlyName` This field is deprecated. - Use `WifiInfo#getPasspointProviderFriendlyName()`
`public long`	`timestamp` timestamp in microseconds (since boot) when this result was last seen.
`public CharSequence`	`venueName` This field is deprecated. - This information is not provided

Public constructors
`ScanResult(ScanResult source)` copy constructor
`ScanResult()` Construct an empty scan result.

Public methods
`static int`	`convertChannelToFrequencyMhzIfSupported(int channel, int band)` Utility function to convert Wi-Fi channel number to frequency in MHz.
`static int`	`convertFrequencyMhzToChannelIfSupported(int freqMhz)` Utility function to convert frequency in MHz to channel number.
`List<ScanResult.InformationElement>`	`getInformationElements()` Get all information elements found in the beacon.
`int`	`getWifiStandard()` return the AP wifi standard.
`boolean`	`is80211mcResponder()`
`boolean`	`isPasspointNetwork()`
`String`	`toString()` Returns a string representation of the object.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


        
          android.os.Parcelable

`abstract int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`abstract void`	`writeToParcel(Parcel dest, int flags)` Flatten this object in to a Parcel.

Constants

CHANNEL_WIDTH_160MHZ

public static final int CHANNEL_WIDTH_160MHZ

AP Channel bandwidth is 160 MHZ

Constant Value: 3 (0x00000003)

CHANNEL_WIDTH_20MHZ

public static final int CHANNEL_WIDTH_20MHZ

AP Channel bandwidth is 20 MHZ

Constant Value: 0 (0x00000000)

CHANNEL_WIDTH_40MHZ

public static final int CHANNEL_WIDTH_40MHZ

AP Channel bandwidth is 40 MHZ

Constant Value: 1 (0x00000001)

CHANNEL_WIDTH_80MHZ

public static final int CHANNEL_WIDTH_80MHZ

AP Channel bandwidth is 80 MHZ

Constant Value: 2 (0x00000002)

CHANNEL_WIDTH_80MHZ_PLUS_MHZ

public static final int CHANNEL_WIDTH_80MHZ_PLUS_MHZ

AP Channel bandwidth is 160 MHZ, but 80MHZ + 80MHZ

Constant Value: 4 (0x00000004)

UNSPECIFIED

public static final int UNSPECIFIED

The unspecified value.

Constant Value: -1 (0xffffffff)

WIFI_BAND_24_GHZ

public static final int WIFI_BAND_24_GHZ

Wi-Fi 2.4 GHz band.

Constant Value: 1 (0x00000001)

WIFI_BAND_5_GHZ

public static final int WIFI_BAND_5_GHZ

Wi-Fi 5 GHz band.

Constant Value: 2 (0x00000002)

WIFI_BAND_60_GHZ

public static final int WIFI_BAND_60_GHZ

Wi-Fi 60 GHz band.

Constant Value: 16 (0x00000010)

WIFI_BAND_6_GHZ

public static final int WIFI_BAND_6_GHZ

Wi-Fi 6 GHz band.

Constant Value: 8 (0x00000008)

WIFI_STANDARD_11AC

public static final int WIFI_STANDARD_11AC

Wi-Fi 802.11ac

Constant Value: 5 (0x00000005)

WIFI_STANDARD_11AD

public static final int WIFI_STANDARD_11AD

Wi-Fi 802.11ad

Constant Value: 7 (0x00000007)

WIFI_STANDARD_11AX

public static final int WIFI_STANDARD_11AX

Wi-Fi 802.11ax

Constant Value: 6 (0x00000006)

WIFI_STANDARD_11N

public static final int WIFI_STANDARD_11N

Wi-Fi 802.11n

Constant Value: 4 (0x00000004)

WIFI_STANDARD_LEGACY

public static final int WIFI_STANDARD_LEGACY

Wi-Fi 802.11a/b/g

Constant Value: 1 (0x00000001)

WIFI_STANDARD_UNKNOWN

public static final int WIFI_STANDARD_UNKNOWN

Wi-Fi unknown standard

Constant Value: 0 (0x00000000)

Fields

BSSID

public String BSSID

The address of the access point.

CREATOR

public static final Creator<ScanResult> CREATOR

Implement the Parcelable interface

SSID

public String SSID

The network name.

capabilities

public String capabilities

Describes the authentication, key management, and encryption schemes supported by the access point.

centerFreq0

public int centerFreq0

Not used if the AP bandwidth is 20 MHz If the AP use 40, 80 or 160 MHz, this is the center frequency (in MHz) if the AP use 80 + 80 MHz, this is the center frequency of the first segment (in MHz)

centerFreq1

public int centerFreq1

Only used if the AP bandwidth is 80 + 80 MHz if the AP use 80 + 80 MHz, this is the center frequency of the second segment (in MHz)

channelWidth

public int channelWidth

AP Channel bandwidth; one of CHANNEL_WIDTH_20MHZ, CHANNEL_WIDTH_40MHZ, CHANNEL_WIDTH_80MHZ, CHANNEL_WIDTH_160MHZ or CHANNEL_WIDTH_80MHZ_PLUS_MHZ.
Value is CHANNEL_WIDTH_20MHZ, CHANNEL_WIDTH_40MHZ, CHANNEL_WIDTH_80MHZ, CHANNEL_WIDTH_160MHZ, or CHANNEL_WIDTH_80MHZ_PLUS_MHZ

frequency

public int frequency

The primary 20 MHz frequency (in MHz) of the channel over which the client is communicating with the access point.

level

public int level

The detected signal level in dBm, also known as the RSSI.

Use WifiManager.calculateSignalLevel(int) to convert this number into an absolute signal level which can be displayed to a user.

operatorFriendlyName

public CharSequence operatorFriendlyName

This field is deprecated.
- Use WifiInfo#getPasspointProviderFriendlyName()

Indicates Passpoint operator name published by access point.

timestamp

public long timestamp

timestamp in microseconds (since boot) when this result was last seen.

venueName

public CharSequence venueName

This field is deprecated.
- This information is not provided

Indicates venue name (such as 'San Francisco Airport') published by access point; only available on Passpoint network and if published by access point.

Public constructors

ScanResult

public ScanResult (ScanResult source)

copy constructor

Parameters
`source`	`ScanResult`: This value cannot be `null`.

ScanResult

public ScanResult ()

Construct an empty scan result.

Public methods

convertChannelToFrequencyMhzIfSupported

public static int convertChannelToFrequencyMhzIfSupported (int channel, 
                int band)

Utility function to convert Wi-Fi channel number to frequency in MHz. Reference the Wi-Fi channel numbering and the channelization in IEEE 802.11-2016 specifications, section 17.3.8.4.2, 17.3.8.4.3 and Table 15-6. See also convertFrequencyMhzToChannelIfSupported(int).

Parameters
`channel`	`int`: number to convert.
`band`	`int`: of channel to convert. One of the following bands: `WIFI_BAND_24_GHZ`, `WIFI_BAND_5_GHZ`, `WIFI_BAND_6_GHZ`, `WIFI_BAND_60_GHZ`. Value is `UNSPECIFIED`, `WIFI_BAND_24_GHZ`, `WIFI_BAND_5_GHZ`, `WIFI_BAND_6_GHZ`, or `WIFI_BAND_60_GHZ`

Returns
`int`	center frequency in Mhz of the channel, `UNSPECIFIED` if no match

convertFrequencyMhzToChannelIfSupported

public static int convertFrequencyMhzToChannelIfSupported (int freqMhz)

Utility function to convert frequency in MHz to channel number. See also convertChannelToFrequencyMhzIfSupported(int, int).

Parameters
`freqMhz`	`int`: frequency in MHz

Returns
`int`	channel number associated with given frequency, `UNSPECIFIED` if no match

getInformationElements

public List<ScanResult.InformationElement> getInformationElements ()

Get all information elements found in the beacon.

Returns
`List<ScanResult.InformationElement>`	This value cannot be `null`.

getWifiStandard

public int getWifiStandard ()

return the AP wifi standard.

Returns
`int`	Value is `WIFI_STANDARD_UNKNOWN`, `WIFI_STANDARD_LEGACY`, `WIFI_STANDARD_11N`, `WIFI_STANDARD_11AC`, `WIFI_STANDARD_11AX`, or `WIFI_STANDARD_11AD`

is80211mcResponder

public boolean is80211mcResponder ()

Returns
`boolean`

isPasspointNetwork

public boolean isPasspointNetwork ()

Returns
`boolean`

toString

public String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())

Returns
`String`	a string representation of the object.

Most visited

Recently visited

Results for

ScanResult

Summary

Nested classes

Constants

Inherited constants

Fields

Public constructors

Public methods

Inherited methods

Constants

CHANNEL_WIDTH_160MHZ

CHANNEL_WIDTH_20MHZ

CHANNEL_WIDTH_40MHZ

CHANNEL_WIDTH_80MHZ

CHANNEL_WIDTH_80MHZ_PLUS_MHZ

UNSPECIFIED

WIFI_BAND_24_GHZ

WIFI_BAND_5_GHZ

WIFI_BAND_60_GHZ

WIFI_BAND_6_GHZ

WIFI_STANDARD_11AC

WIFI_STANDARD_11AD

WIFI_STANDARD_11AX

WIFI_STANDARD_11N

WIFI_STANDARD_LEGACY

WIFI_STANDARD_UNKNOWN

Fields

BSSID

CREATOR

SSID

capabilities

centerFreq0

centerFreq1

channelWidth

frequency

level

operatorFriendlyName

timestamp

venueName

Public constructors

ScanResult

ScanResult

Public methods

convertChannelToFrequencyMhzIfSupported

convertFrequencyMhzToChannelIfSupported

getInformationElements

getWifiStandard

is80211mcResponder

isPasspointNetwork

toString