Share via


Settings.ActionProcessWifiEasyConnectUri Field

Definition

Activity Action: Show setting page to process a Wi-Fi Easy Connect (aka DPP) URI and start configuration.

[Android.Runtime.Register("ACTION_PROCESS_WIFI_EASY_CONNECT_URI", ApiSince=29)]
public const string ActionProcessWifiEasyConnectUri;
[<Android.Runtime.Register("ACTION_PROCESS_WIFI_EASY_CONNECT_URI", ApiSince=29)>]
val mutable ActionProcessWifiEasyConnectUri : string

Field Value

Attributes

Remarks

Activity Action: Show setting page to process a Wi-Fi Easy Connect (aka DPP) URI and start configuration. This intent should be used when you want to use this device to take on the configurator role for an IoT/other device. When provided with a valid DPP URI string, Settings will open a Wi-Fi selection screen for the user to indicate which network they would like to configure the device specified in the DPP URI string and carry them through the rest of the flow for provisioning the device.

In some cases, a matching Activity may not exist, so ensure to safeguard against this by checking WifiManager#isEasyConnectSupported().

Input: The Intent's data URI specifies bootstrapping information for authenticating and provisioning the peer, and uses a "DPP" scheme. The URI should be attached to the intent using Intent#setData(Uri). The calling app can obtain a DPP URI in any way, e.g. by scanning a QR code or other out-of-band methods. The calling app may also attach the #EXTRA_EASY_CONNECT_BAND_LIST extra to provide information about the bands supported by the enrollee device.

Output: After calling android.app.Activity#startActivityForResult, the callback onActivityResult will have resultCode android.app.Activity#RESULT_OK if the Wi-Fi Easy Connect configuration succeeded and the user tapped the 'Done' button, or android.app.Activity#RESULT_CANCELED if the operation failed and user tapped the 'Cancel' button. In case the operation has failed, a status code from android.net.wifi.EasyConnectStatusCallbackEASY_CONNECT_EVENT_FAILURE_* will be returned as an Extra #EXTRA_EASY_CONNECT_ERROR_CODE. Easy Connect R2 Enrollees report additional details about the error they encountered, which will be provided in the #EXTRA_EASY_CONNECT_ATTEMPTED_SSID, #EXTRA_EASY_CONNECT_CHANNEL_LIST, and #EXTRA_EASY_CONNECT_BAND_LIST.

Java documentation for android.provider.Settings.ACTION_PROCESS_WIFI_EASY_CONNECT_URI.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to