| /* |
| * Copyright (C) 2017 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License |
| */ |
| |
| package android.net; |
| |
| import android.annotation.DrawableRes; |
| import android.annotation.IntDef; |
| import android.annotation.IntRange; |
| import android.annotation.NonNull; |
| import android.annotation.Nullable; |
| import android.annotation.SystemApi; |
| import android.content.res.Resources; |
| import android.content.res.Resources.Theme; |
| import android.graphics.drawable.Drawable; |
| import android.graphics.drawable.LayerDrawable; |
| import android.net.wifi.WifiManager; |
| import android.view.View; |
| |
| import java.lang.annotation.Retention; |
| import java.lang.annotation.RetentionPolicy; |
| |
| /** |
| * Utility methods for working with network badging. |
| * |
| * @removed |
| * |
| */ |
| @Deprecated |
| public class NetworkBadging { |
| |
| @IntDef({BADGING_NONE, BADGING_SD, BADGING_HD, BADGING_4K}) |
| @Retention(RetentionPolicy.SOURCE) |
| public @interface Badging {} |
| |
| public static final int BADGING_NONE = 0; |
| public static final int BADGING_SD = 10; |
| public static final int BADGING_HD = 20; |
| public static final int BADGING_4K = 30; |
| |
| private NetworkBadging() {} |
| |
| /** |
| * Returns a Wi-Fi icon for a network with a given signal level and badging value. |
| * |
| * @param signalLevel The level returned by {@link WifiManager#calculateSignalLevel(int, int)} |
| * for a network. Must be between 0 and {@link WifiManager#RSSI_LEVELS}-1. |
| * @param badging {@see NetworkBadging#Badging}, retrieved from |
| * {@link ScoredNetwork#calculateBadge(int)}. |
| * @param theme The theme for the current application, may be null. |
| * @return Drawable for the given icon |
| * @throws IllegalArgumentException if {@code signalLevel} is out of range or {@code badging} |
| * is an invalid value |
| */ |
| @NonNull public static Drawable getWifiIcon( |
| @IntRange(from=0, to=4) int signalLevel, @Badging int badging, @Nullable Theme theme) { |
| return Resources.getSystem().getDrawable(getWifiSignalResource(signalLevel), theme); |
| } |
| |
| /** |
| * Returns the wifi signal resource id for the given signal level. |
| * |
| * <p>This wifi signal resource is a wifi icon to be displayed by itself when there is no badge. |
| * |
| * @param signalLevel The level returned by {@link WifiManager#calculateSignalLevel(int, int)} |
| * for a network. Must be between 0 and {@link WifiManager#RSSI_LEVELS}-1. |
| * @return the @DrawableRes for the icon |
| * @throws IllegalArgumentException for an invalid signal level |
| * @hide |
| */ |
| @DrawableRes private static int getWifiSignalResource(int signalLevel) { |
| switch (signalLevel) { |
| case 0: |
| return com.android.internal.R.drawable.ic_wifi_signal_0; |
| case 1: |
| return com.android.internal.R.drawable.ic_wifi_signal_1; |
| case 2: |
| return com.android.internal.R.drawable.ic_wifi_signal_2; |
| case 3: |
| return com.android.internal.R.drawable.ic_wifi_signal_3; |
| case 4: |
| return com.android.internal.R.drawable.ic_wifi_signal_4; |
| default: |
| throw new IllegalArgumentException("Invalid signal level: " + signalLevel); |
| } |
| } |
| |
| /** |
| * Returns the badged wifi signal resource id for the given signal level. |
| * |
| * <p>This badged wifi signal resource should be displayed with the quality badge retrieved |
| * from {@link #getWifiBadgeResource(int)}. If there is no badge, |
| * {@link #getWifiBadgeResource(int)} should be used instead of this method. |
| * |
| * @param signalLevel The level returned by {@link WifiManager#calculateSignalLevel(int, int)} |
| * for a network. Must be between 0 and {@link WifiManager#RSSI_LEVELS}-1. |
| * @return the @DrawableRes for the icon |
| * @throws IllegalArgumentException for an invalid signal level |
| * @hide |
| */ |
| @DrawableRes private static int getBadgedWifiSignalResource(int signalLevel) { |
| switch (signalLevel) { |
| case 0: |
| return com.android.internal.R.drawable.ic_signal_wifi_badged_0_bars; |
| case 1: |
| return com.android.internal.R.drawable.ic_signal_wifi_badged_1_bar; |
| case 2: |
| return com.android.internal.R.drawable.ic_signal_wifi_badged_2_bars; |
| case 3: |
| return com.android.internal.R.drawable.ic_signal_wifi_badged_3_bars; |
| case 4: |
| return com.android.internal.R.drawable.ic_signal_wifi_badged_4_bars; |
| default: |
| throw new IllegalArgumentException("Invalid signal level: " + signalLevel); |
| } |
| } |
| } |