Memantau status

Cluster instrumen standar memperbarui informasi mengemudi, panggilan, dan media setiap kali data baru datang. Android menyediakan API berikut untuk memungkinkan cluster instrumen OEM menerima status terbaru dengan mudah.

Status mengemudi

Peristiwa rute mengemudi dikirim saat navigasi sedang berlangsung. File packages/services/Car/car-lib/src/android/car/cluster/renderer/NavigationRenderer.java berisi metode abstrak untuk perender aplikasi navigasi di cluster instrumen.

Dalam InstrumentClusterRenderingService yang diperluas, metode ini adalah sebagai berikut:

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) {...}
        };
    }
}

Anda dapat menambahkan tindakan kustom (seperti rendering) ke metode ini untuk menampilkan informasi yang diinginkan.

Status panggilan

Untuk memantau status panggilan, gunakan langkah-langkah berikut:

  1. Perluas android.telecom.InCallService. 
    public class ClusterInCallService extends InCallService {
...
  2. Daftarkan layanan di AndroidManifest.xml. 
    <service android:name="com.android.car.cluster.sample.ClusterInCallService"
    android:permission="android.permission.BIND_INCALL_SERVICE"
    android:exported="false">
  3. Ganti onCallAdded dan onCallRemoved. 
    public void onCallAdded(Call call) {
    ...
    call.registerCallback(mPhoneCallback);
    mPhoneCallback.onStateChanged(call, call.getState());
}
public void onCallRemoved(Call call) {
    ...
    call.unregisterCallback(mPhoneCallback);
}
  4. Daftarkan callback untuk menerima peristiwa perubahan status panggilan (Call#registerCallback). 
    private static class PhoneCallback extends Callback {
    ...
    public void onStateChanged(Call call, int state) {...}
}
  5. Gunakan penyedia konten untuk mengambil informasi kontak:
    ContactsContract.PhoneLookup, ContactsContract.Contacts#openContactPhotoInputStream).

Untuk kode contoh pemantauan status panggilan, lihat:
packages/services/Car/tests/InstrumentClusterRendererSample/src/com/android/car/cluster/sample/ClusterInCallService.java

Untuk kode contoh penyedia konten, lihat:
packages/services/Car/tests/InstrumentClusterRendererSample/src/com/android/car/cluster/sample/TelecomUtils.java.

Status media

Anda dapat mengonfigurasi sistem untuk memperbarui status media saat menerima peristiwa yang terkait dengan perubahan MediaMetadata (seperti album atau judul lagu atau gambar sampul) atau status pemutaran (buffering, jeda, putar, dan hentikan). Untuk memperbarui status media:

  1. Gunakan MediaSessionManager dan dapatkan pengontrol utama (#getActiveSessions(null)[0]).
  2. Daftarkan callback (MediaController#Callback).
  3. Berlangganan ke sesi aktif berubah MediaSessionManager#addOnActiveSessionsChangedListener(...).

Untuk detailnya, lihat: