在行車期間維持熱點

本頁面說明如何設定使用者，在駕駛期間維持熱點連線，與 AAOS 中的 Wi-Fi 駕駛體驗類似。

public class CarSettings {
  ...

  @SystemApi
  public static final class Global {
    ...

    /**
     * Enables persistent tethering when set to {@code "true"}.
     *
     * <p>When enabled, tethering is started when the car is started given
     * that the hotspot was enabled at shutdown and all tethering sessions
     * will remain on even if no devices are connected to it.
     *
     * <p>When disabled, hotspot will turn off automatically if no devices
     * are connected and will no longer persist through drives.
     *
     * @hide
     */
    @SystemApi
    public static final String ENABLE_PERSISTENT_TETHERING =
           "android.car.ENABLE_PERSISTENT_TETHERING";
  }
}

如要保留網路共用設定，請透過 Settings API 使用 ENABLE_PERSISTENT_TETHERING，這個 API 也可用於查詢。

權限

CarWifiManager API 的使用受到限制。這項新權限是為了保護存取權而建立。

public boolean canControlPersistApSettings() { ... }

這項權限的防護等級如下：

新權限 權限 防護等級
是 READ_PERSIST_TETHERING_SETTINGS Signature | Privileged

預設的持續性行為為「不支援」。資源重疊 (config_enablePersistTetheringCapabilities) 設定為禁止保留網路共用功能。如要刻意保留網路共用功能，請將值設為 true，以便在使用者偏好設定選擇啟用這項功能時，一併啟用這項功能，因為其他具有 WRITE_SECURE_SETTINGS 權限的系統應用程式也能控制這項設定。

下列 API 會判斷是否啟用這項行為。請先呼叫這個 API，再變更 ENABLE_PERSISTENT_TETHERING。

/**
 * CarWifiManager provides API to allow for applications to perform Wi-Fi specific
 * operations.
 *
 * @hide
 */
@SystemApi
public final class CarWifiManager extends CarManagerBase {
 /**
  * Returns {@code true} if the persist tethering settings are able to be
  * changed.
  *
  * @hide
  */
 @SystemApi
 @RequiresPermission(Car.PERMISSION_READ_PERSIST_TETHERING_SETTINGS)
 public boolean canControlPersistApSettings() { ... }
}