Um painel de instrumentos típico atualiza informações de direção, chamadas e/ou mídia sempre que novos dados chegam. O Android fornece a seguinte API para permitir que um painel de instrumentos de um OEM receba facilmente o status atualizado.
Estado de condução
Os eventos de direção de direção são enviados enquanto a navegação está em andamento. O arquivo packages/services/Car/car-lib/src/android/car/cluster/renderer/NavigationRenderer.java
contém métodos abstratos para um renderizador de aplicativo de navegação no cluster de instrumentos.
Em um InstrumentClusterRenderingService
estendido, esses métodos são os seguintes:
public class MyClusterRenderingService extends InstrumentClusterRenderingService { ... @Override protected NavigationRenderer getNavigationRenderer() { return new NavigationRenderer() { @Override CarNavigationInstrumentCluster getNavigationProperties() {...} @Override void onStartNavigation() {...} @Override void onStopNavigation() {...} @Override void onNextTurnChanged(int event, String road, int turnAngle, int turnNumber, Bitmap image, int turnSide) {...} @Override void onNextTurnDistanceChanged(int distanceMeters, int timeSeconds) {...} }; } }
Você pode adicionar ações personalizadas (como renderização) a esses métodos para exibir as informações desejadas.
Status da chamada
Para monitorar o status da chamada, use as seguintes etapas:
- Estenda
android.telecom.InCallService
.public class ClusterInCallService extends InCallService { ...
- Registre o serviço em
AndroidManifest.xml
.<service android:name="com.android.car.cluster.sample.ClusterInCallService" android:permission="android.permission.BIND_INCALL_SERVICE" android:exported="false">
- Substitua onCallAdded e onCallRemoved.
public void onCallAdded(Call call) { ... call.registerCallback(mPhoneCallback); mPhoneCallback.onStateChanged(call, call.getState()); } public void onCallRemoved(Call call) { ... call.unregisterCallback(mPhoneCallback); }
- Registre retornos de chamada para receber eventos de mudança de status de chamada (
Call#registerCallback
).private static class PhoneCallback extends Callback { ... public void onStateChanged(Call call, int state) {...} }
- Use provedores de conteúdo para extrair informações de contato:
ContactsContract.PhoneLookup, ContactsContract.Contacts#openContactPhotoInputStream
).
Para obter o código de amostra do monitor de status da chamada, consulte:
packages/services/Car/tests/InstrumentClusterRendererSample/src/com/android/car/cluster/sample/ClusterInCallService.java
Para o código de amostra do provedor de conteúdo, consulte:
packages/services/Car/tests/InstrumentClusterRendererSample/src/com/android/car/cluster/sample/TelecomUtils.java
.
Status da mídia
Você pode configurar o sistema para atualizar o status da mídia ao receber eventos relacionados a uma alteração em MediaMetadata (como título de álbum ou música ou imagem de capa) ou estado de reprodução (buffer, pausar, reproduzir e parar). Para atualizar o status da mídia:
- Use
MediaSessionManager
e obtenha o controlador primário (#getActiveSessions(null)[0]
). - Registre retornos de chamada (
MediaController#Callback
). - Assinar na sessão ativa alterada
MediaSessionManager#addOnActiveSessionsChangedListener(...)
.
Para detalhes, consulte: