Trạng thái giám sát

Một cụm đồng hồ thông thường sẽ cập nhật thông tin về việc lái xe, cuộc gọi và nội dung nghe nhìn bất cứ khi nào có dữ liệu mới. Android cung cấp API sau đây để cho phép cụm đồng hồ của nhà sản xuất thiết bị gốc (OEM) dễ dàng nhận được trạng thái mới nhất.

Trạng thái lái xe

Sự kiện chỉ đường lái xe được gửi trong khi đang đi theo chỉ dẫn. Tệp packages/services/Car/car-lib/src/android/car/cluster/renderer/NavigationRenderer.java chứa các phương thức trừu tượng cho trình kết xuất ứng dụng điều hướng trong cụm đồng hồ.

Trong InstrumentClusterRenderingService mở rộng, các phương thức này như sau:

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

Bạn có thể thêm các thao tác tuỳ chỉnh (chẳng hạn như kết xuất) vào các phương thức này để hiển thị thông tin mong muốn.

Trạng thái cuộc gọi

Để theo dõi trạng thái cuộc gọi, hãy làm theo các bước sau:

  1. Mở rộng android.telecom.InCallService. 
    public class ClusterInCallService extends InCallService {
...
  2. Đăng ký dịch vụ trong AndroidManifest.xml. 
    <service android:name="com.android.car.cluster.sample.ClusterInCallService"
    android:permission="android.permission.BIND_INCALL_SERVICE"
    android:exported="false">
  3. Ghi đè onCallAdded và onCallRemoved. 
    public void onCallAdded(Call call) {
    ...
    call.registerCallback(mPhoneCallback);
    mPhoneCallback.onStateChanged(call, call.getState());
}
public void onCallRemoved(Call call) {
    ...
    call.unregisterCallback(mPhoneCallback);
}
  4. Đăng ký lệnh gọi lại để nhận các sự kiện thay đổi trạng thái cuộc gọi (Call#registerCallback). 
    private static class PhoneCallback extends Callback {
    ...
    public void onStateChanged(Call call, int state) {...}
}
  5. Sử dụng nhà cung cấp nội dung để lấy thông tin liên hệ:
    ContactsContract.PhoneLookup, ContactsContract.Contacts#openContactPhotoInputStream).

Để biết mã mẫu của trình theo dõi trạng thái cuộc gọi, hãy xem:
packages/services/Car/tests/InstrumentClusterRendererSample/src/com/android/car/cluster/sample/ClusterInCallService.java

Để biết mã mẫu của nhà cung cấp nội dung, hãy xem:
packages/services/Car/tests/InstrumentClusterRendererSample/src/com/android/car/cluster/sample/TelecomUtils.java.

Trạng thái nội dung nghe nhìn

Bạn có thể định cấu hình hệ thống để cập nhật trạng thái nội dung nghe nhìn khi hệ thống nhận được các sự kiện liên quan đến sự thay đổi trong MediaMetadata (chẳng hạn như tên album, tên bài hát hoặc hình ảnh bìa) hoặc trạng thái phát (lưu vào bộ đệm, tạm dừng, phát và dừng). Cách cập nhật trạng thái nội dung nghe nhìn:

  1. Sử dụng MediaSessionManager và lấy tay điều khiển chính (#getActiveSessions(null)[0]).
  2. Đăng ký lệnh gọi lại (MediaController#Callback).
  3. Đăng ký MediaSessionManager#addOnActiveSessionsChangedListener(...) khi phiên hoạt động thay đổi.

Để biết chi tiết, hãy xem: