在行車期間維持熱點

本頁面說明如何設定使用者在行車期間維持熱點，類似於 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";
  }
}

如要持續使用 Tethering，請透過 Settings API 使用 ENABLE_PERSISTENT_TETHERING，這也可以用於查詢。

權限

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

public boolean canControlPersistApSettings() { ... }

此權限的防護等級如下：

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

持久化行為預設為「不支援」。資源疊加層 (config_enablePersistTetheringCapabilities) 已設為封鎖持續 Tethering 的功能。如要刻意持續使用 Tethering，請將值設為 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() { ... }
}