确定并监控对接状态和类型

Android 驱动的设备可以对接到不同类型的底座。这些包括汽车底座、家用底座以及数字或模拟底座。对接状态通常与充电状态密切相关,因为许多底座为对接设备供电。

您的应用会影响手机在对接状态下的更新速率。您可以提高体育新闻应用在桌面底座中的更新频率,或者如果设备对接到汽车底座,则完全禁用更新。相反,如果您在后台服务中更新交通状况,则可以最大限度地提高在汽车底座对接时的更新频率。

对接状态也会作为粘性 Intent 广播,让您可以查询设备是否已对接以及是否已对接到哪种类型的底座。

确定当前对接状态

对接状态详细信息包含在 粘性广播 中的额外信息中,该广播的 ACTION_DOCK_EVENT 操作。由于它是粘性的,您可以调用 registerReceiver(),并将 null 作为广播接收器传递。以下代码段展示了如何完成此过程

Kotlin

val dockStatus: Intent? = IntentFilter(Intent.ACTION_DOCK_EVENT).let { ifilter ->
    context.registerReceiver(null, ifilter)
}

Java

IntentFilter ifilter = new IntentFilter(Intent.ACTION_DOCK_EVENT);
Intent dockStatus = context.registerReceiver(null, ifilter);

您可以从 EXTRA_DOCK_STATE 额外信息中提取当前对接状态

Kotlin

val dockState: Int = dockStatus?.getIntExtra(EXTRA_DOCK_STATE, -1) ?: -1
val isDocked: Boolean = dockState != Intent.EXTRA_DOCK_STATE_UNDOCKED

Java

int dockState -1;
if (dockStatus != null) {
  dockState = dockStatus.getIntExtra(EXTRA_DOCK_STATE, -1);
}
boolean isDocked = dockState != Intent.EXTRA_DOCK_STATE_UNDOCKED;

确定当前底座类型

如果设备已对接,则它可以对接到以下四种不同类型的底座中

  • 汽车
  • 桌面
  • 低端(模拟)桌面
  • 高端(数字)桌面

后两个选项仅在 Android API 级别 11 中引入,因此当您只对底座类型而不是它是否是数字或模拟感兴趣时,最好检查所有三种桌面类型

Kotlin

val isCar: Boolean = dockState == EXTRA_DOCK_STATE_CAR
val isDesk: Boolean = dockState == EXTRA_DOCK_STATE_DESK
        || dockState == EXTRA_DOCK_STATE_LE_DESK
        || dockState == EXTRA_DOCK_STATE_HE_DESK

Java

boolean isCar = dockState == EXTRA_DOCK_STATE_CAR;
boolean isDesk = dockState == EXTRA_DOCK_STATE_DESK ||
                 dockState == EXTRA_DOCK_STATE_LE_DESK ||
                 dockState == EXTRA_DOCK_STATE_HE_DESK;