Merge "wifi: Revise java doc to add more explanation"

    }

    /**

     * Registers a callback for Soft AP. See {@link SoftApCallback}. Caller will receive the current

     * soft AP state and number of connected devices immediately after a successful call to this API

     * via callback. Note that receiving an immediate WIFI_AP_STATE_FAILED value for soft AP state

     * indicates that the latest attempt to start soft AP has failed. Caller can unregister a

     * previously registered callback using {@link #unregisterSoftApCallback}

     * Registers a callback for Soft AP. See {@link SoftApCallback}. Caller will receive the

     * following callbacks on registration:

     * <ul>

     * <li> {@link SoftApCallback#onStateChanged(int, int)}</li>

     * <li> {@link SoftApCallback#onConnectedClientsChanged(List<WifiClient>)}</li>

     * <li> {@link SoftApCallback#onInfoChanged(SoftApInfo)}</li>

     * <li> {@link SoftApCallback#onCapabilityChanged(SoftApCapability)}</li>

     * </ul>

     * These will be dispatched on registration to provide the caller with the current state

     * (and are not an indication of any current change). Note that receiving an immediate

     * WIFI_AP_STATE_FAILED value for soft AP state indicates that the latest attempt to start

     * soft AP has failed. Caller can unregister a previously registered callback using

     * {@link #unregisterSoftApCallback}

     * <p>

     * Applications should have the

     * {@link android.Manifest.permission#NETWORK_SETTINGS NETWORK_SETTINGS} permission. Callers

    }

    /**

     * Returns soft ap config from the backed up data.

     * Returns soft ap config from the backed up data or null if data is invalid.

     * @param data byte stream in the same format produced by {@link #retrieveSoftApBackupData()}

     *

     * @hide