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;