Android-系统服务-WifiManager_android wifimanager

4074      /**
4075       * Enable or disable Wi-Fi.
4076       * <p>
4077       * Applications must have the {@link android.Manifest.permission#CHANGE_WIFI_STATE}
4078       * permission to toggle wifi.
4079       *
4080       * @param enabled {@code true} to enable, {@code false} to disable.
4081       * @return {@code false} if the request cannot be satisfied; {@code true} indicates that wifi is
4082       *         either already in the requested state, or in progress toward the requested state.
4083       * @throws  {@link java.lang.SecurityException} if the caller is missing required permissions.
4084       *
4085       * @deprecated Starting with Build.VERSION_CODES#Q, applications are not allowed to
4086       * enable/disable Wi-Fi.
4087       * <b>Compatibility Note:</b> For applications targeting
4088       * {@link android.os.Build.VERSION_CODES#Q} or above, this API will always fail and return
4089       * {@code false}. If apps are targeting an older SDK ({@link android.os.Build.VERSION_CODES#P}
4090       * or below), they can continue to use this API.
4091       * <p>
4092       * Deprecation Exemptions:
4093       * <ul>
4094       * <li>Device Owner (DO), Profile Owner (PO) and system apps.
4095       * </ul>
4096       *
4097       * Starting with Build.VERSION_CODES#T, DO/COPE may set a user restriction
4098       * (DISALLOW_CHANGE_WIFI_STATE) to only allow DO/PO to use this API.
4099       */
4100      @Deprecated
4101      public boolean setWifiEnabled(boolean enabled) {
4102          try {
4103              return mService.setWifiEnabled(mContext.getOpPackageName(), enabled);
4104          } catch (RemoteException e) {
4105              throw e.rethrowFromSystemServer();
4106          }
4107      }

2958      /**
2959       * Disable a configured network. The specified network will not be
2960       * a candidate for associating. This may result in the asynchronous
2961       * delivery of state change events.
2962       *
2963       * Applications are not allowed to disable networks created by other
2964       * applications.
2965       *
2966       * @param netId the ID of the network as returned by {@link #addNetwork} or {@link
2967       *        #getConfiguredNetworks}.
2968       * @return {@code true} if the operation succeeded
2969       *
2970       * @deprecated
2971       * a) See {@link WifiNetworkSpecifier.Builder#build()} for new
2972       * mechanism to trigger connection to a Wi-Fi network.
2973       * b) See {@link #addNetworkSuggestions(List)},
2974       * {@link #removeNetworkSuggestions(List)} for new API to add Wi-Fi networks for consideration
2975       * when auto-connecting to wifi.
2976       * <b>Compatibility Note:</b> For applications targeting
2977       * {@link android.os.Build.VERSION_CODES#Q} or above, this API will always fail and return
2978       * {@code false}.
2979       * <p>
2980       * Deprecation Exemptions:
2981       * <ul>
2982       * <li>Device Owner (DO), Profile Owner (PO) and system apps.
2983       * </ul>
2984       */
2985      @Deprecated
2986      public boolean disableNetwork(int netId) {
2987          try {
2988              return mService.disableNetwork(netId, mContext.getOpPackageName());
2989          } catch (RemoteException e) {
2990              throw e.rethrowFromSystemServer();
2991          }
2992      }

2909      /**
2910       * Allow a previously configured network to be associated with. If
2911       * <code>attemptConnect</code> is true, an attempt to connect to the selected
2912       * network is initiated. This may result in the asynchronous delivery
2913       * of state change events.
2914       * <p>
2915       * <b>Note:</b> Network communication may not use Wi-Fi even if Wi-Fi is connected;
2916       * traffic may instead be sent through another network, such as cellular data,
2917       * Bluetooth tethering, or Ethernet. For example, traffic will never use a
2918       * Wi-Fi network that does not provide Internet access (e.g. a wireless
2919       * printer), if another network that does offer Internet access (e.g.
2920       * cellular data) is available. Applications that need to ensure that their
2921       * network traffic uses Wi-Fi should use APIs such as
2922       * {@link Network#bindSocket(java.net.Socket)},
2923       * {@link Network#openConnection(java.net.URL)}, or
2924       * {@link ConnectivityManager#bindProcessToNetwork} to do so.
2925       *
2926       * Applications are not allowed to enable networks created by other
2927       * applications.
2928       *
2929       * @param netId the ID of the network as returned by {@link #addNetwork} or {@link
2930       *        #getConfiguredNetworks}.
2931       * @param attemptConnect The way to select a particular network to connect to is specify
2932       *        {@code true} for this parameter.
2933       * @return {@code true} if the operation succeeded
2934       *
2935       * @deprecated
2936       * a) See {@link WifiNetworkSpecifier.Builder#build()} for new
2937       * mechanism to trigger connection to a Wi-Fi network.
2938       * b) See {@link #addNetworkSuggestions(List)},
2939       * {@link #removeNetworkSuggestions(List)} for new API to add Wi-Fi networks for consideration
2940       * when auto-connecting to wifi.
2941       * <b>Compatibility Note:</b> For applications targeting
2942       * {@link android.os.Build.VERSION_CODES#Q} or above, this API will always fail and return
2943       * {@code false}.
2944       * Deprecation Exemptions:
2945       * <ul>
2946       * <li>Device Owner (DO), Profile Owner (PO) and system apps.
2947       * </ul>
2948       */
2949      @Deprecated
2950      public boolean enableNetwork(int netId, boolean attemptConnect) {
2951          try {
2952              return mService.enableNetwork(netId, attemptConnect, mContext.getOpPackageName());
2953          } catch (RemoteException e) {
2954              throw e.rethrowFromSystemServer();
2955          }
2956      }

4273      /**
4274       * Gets the Wi-Fi enabled state.
4275       * @return One of {@link #WIFI_STATE_DISABLED},
4276       *         {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED},
4277       *         {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN}
4278       * @see #isWifiEnabled()
4279       */
4280      public int getWifiState() {
4281          try {
4282              return mService.getWifiEnabledState();
4283          } catch (RemoteException e) {
4284              throw e.rethrowFromSystemServer();
4285          }
4286      }

1079      /**
1080       * Returns the MAC address used for this connection.
1081       * @return MAC address of the connection or {@code "02:00:00:00:00:00"} if the caller has
1082       * insufficient permission.
1083       *
1084       * Requires {@code android.Manifest.permission#LOCAL_MAC_ADDRESS} and
1085       * {@link android.Manifest.permission#ACCESS_FINE_LOCATION}.
1086       */
1087      public String getMacAddress() {
1088          return mMacAddress;
1089      }