Memenuhi perintah

Halaman ini menjelaskan cara memenuhi perintah dengan interaksi suara.

Memenuhi perintah media

Perintah terkait media dapat dibagi menjadi tiga grup yang berbeda:

• Sumber media eksternal (seperti Spotify yang diinstal di AAOS).
• Sumber media backend (seperti musik yang di-streaming melalui VIA).
• Sumber media lokal (seperti radio mobil).

Menangani perintah sumber media eksternal

Sumber media eksternal ditentukan sebagai aplikasi Android yang mendukung API MediaSessionCompat dan MediaBrowseCompat (lihat Membangun aplikasi media untuk mobil untuk penjelasan mendetail tentang penggunaan API ini).

Penting: Agar aplikasi asisten dapat terhubung ke MediaBrowseService semua aplikasi media yang diinstal di sistem, aplikasi tersebut harus:

1. Diinstal sebagai aplikasi yang ditandatangani sistem (lihat panduan Pengembangan Aplikasi Media untuk AAOS dan kode contoh PackageValidator).
2. Memiliki izin hak istimewa sistem android.permission.MEDIA_CONTENT_CONTROL (lihat Memberikan izin hak istimewa sistem).

Selain MediaBrowserCompat dan MediaControllerCompat, AAOS menyediakan hal berikut:

• CarMediaService memberikan informasi terpusat tentang sumber media yang saat ini dipilih. Hal ini juga digunakan untuk melanjutkan sumber media yang sebelumnya diputar setelah mobil dimatikan lalu dimulai ulang.
• car-media-common menyediakan metode yang mudah untuk membuat daftar, menghubungkan, dan berinteraksi dengan aplikasi media.

Di bawah ini adalah panduan khusus untuk penerapan perintah interaksi suara umum.

Mendapatkan daftar sumber media yang terinstal

Sumber media dapat dideteksi menggunakan PackageManager, dan memfilter layanan yang cocok dengan MediaBrowserService.SERVICE_INTERFACE. Di beberapa mobil, mungkin ada beberapa implementasi layanan browser media khusus yang harus dikecualikan. Berikut adalah contoh logika ini:

private Map<String, MediaSource> getAvailableMediaSources() {
    List<String> customMediaServices =
        Arrays.asList(mContext.getResources()
            .getStringArray(R.array.custom_media_packages));
    List<ResolveInfo> mediaServices = mPackageManager.queryIntentServices(
            new Intent(MediaBrowserService.SERVICE_INTERFACE),
            PackageManager.GET_RESOLVED_FILTER);
    Map<String, MediaSource> result = new HashMap<>();
    for (ResolveInfo info : mediaServices) {
        String packageName = info.serviceInfo.packageName;
        if (customMediaServices.contains(packageName)) {
            // Custom media sources should be ignored, as they might have a
            // specialized handling (e.g., radio).
            continue;
        }
        String className = info.serviceInfo.name;
        ComponentName componentName = new ComponentName(packageName,
            className);
        MediaSource source = MediaSource.create(mContext, componentName);
        result.put(source.getDisplayName().toString().toLowerCase(),
            source);
    }
    return result;
}

Perhatikan bahwa sumber media dapat diinstal atau di-uninstal kapan saja. Untuk mempertahankan daftar yang akurat, sebaiknya terapkan instance BroadcastReceiver untuk tindakan intent ACTION_PACKAGE_ADDED, ACTION_PACKAGE_CHANGED, ACTION_PACKAGE_REPLACED, dan ACTION_PACKAGE_REMOVED.

Menghubungkan ke sumber media yang sedang diputar

CarMediaService menyediakan metode untuk mendapatkan sumber media yang saat ini dipilih, dan saat sumber media ini berubah. Perubahan ini dapat terjadi karena pengguna berinteraksi langsung dengan UI, atau karena penggunaan tombol hardware di mobil. Di sisi lain, library car-media-common menawarkan cara mudah untuk terhubung ke sumber media tertentu. Berikut adalah cuplikan sederhana tentang cara terhubung ke aplikasi media yang saat ini dipilih:

public class MediaActuator implements
        MediaBrowserConnector.onConnectedBrowserChanged {
    private final Car mCar;
    private CarMediaManager mCarMediaManager;
    private MediaBrowserConnector mBrowserConnector;

    …

    public void initialize(Context context) {
        mCar = Car.createCar(context);
        mBrowserConnector = new MediaBrowserConnector(context, this);
        mCarMediaManager = (CarMediaManager)
            mCar.getCarManager(Car.CAR_MEDIA_SERVICE);
        mBrowserConnector.connectTo(mCarMediaManager.getMediaSource());
        …
    }

    @Override
    public void onConnectedBrowserChanged(
            @Nullable MediaBrowserCompat browser) {
        // TODO: Handle connected/disconnected browser
    }

    …
}

Mengontrol pemutaran sumber media yang sedang diputar

Dengan MediaBrowserCompat yang terhubung, Anda dapat dengan mudah mengirim perintah kontrol transportasi ke aplikasi target. Berikut contoh sederhananya:

public class MediaActuator …  {
    …
    private MediaControllerCompat mMediaController;

    @Override
    public void onConnectedBrowserChanged(
            @Nullable MediaBrowserCompat browser) {
        if (browser != null && browser.isConnected()) {
            mMediaController = new MediaControllerCompat(mContext,
                browser.getSessionToken());
        } else {
            mMediaController = null;
        }
    }

    private boolean playSongOnCurrentSource(String song) {
        if (mMediaController == null) {
            // No source selected.
            return false;
        }
        MediaControllerCompat.TransportControls controls =
            mMediaController.getTransportControls();
        PlaybackStateCompat state = controller.getPlaybackState();
        if (state == null || ((state.getActions() &
                PlaybackStateCompat.ACTION_PLAY_FROM_SEARCH) == 0)) {
            // Source can't play from search
            return false;
        }
        controls.playFromSearch(query, null);
        return true;
    }

    …
}

Menangani perintah sumber media lokal (radio, pemutar CD, Bluetooth, USB)

Sumber media lokal mengekspos fungsinya ke sistem menggunakan API MediaSession dan MediaBrowse yang sama seperti yang dijelaskan di atas. Untuk mengakomodasi kekhasan setiap jenis hardware, layanan MediaBrowse ini menggunakan konvensi khusus untuk mengatur informasi dan perintah media.

Menangani radio

Radio MediaBrowseService dapat diidentifikasi oleh filter intent ACTION_PLAY_BROADCASTRADIO. Aplikasi ini diharapkan mengikuti struktur kontrol pemutaran dan penjelajahan media yang dijelaskan dalam Menerapkan radio. AAOS menawarkan library car-broadcastradio-support yang berisi konstanta dan metode untuk membantu OEM membuat implementasi MediaBrowseService untuk layanan radio mereka sendiri yang mengikuti protokol yang ditentukan, dan memberikan dukungan untuk aplikasi yang menggunakan hierarki penjelajahan mereka (misalnya, VIA).

Menangani input tambahan, audio CD, dan media USB

Tidak ada penerapan default sumber media ini sebagai bagian dari AOSP. Pendekatan yang disarankan adalah:

• Meminta OEM menerapkan layanan media untuk setiap perangkat tersebut. Untuk mengetahui detailnya, lihat Membuat aplikasi media untuk mobil.
• Implementasi MediaBrowseService ini akan diidentifikasi dan direspons dalam tindakan intent yang ditentukan di Intent pemutaran umum.
• Layanan ini akan menampilkan hierarki penjelajahan yang mengikuti panduan yang dijelaskan di Jenis sumber lainnya.

Menangani Bluetooth

Konten media Bluetooth diekspos melalui profil Bluetooth AVRCP. Untuk memfasilitasi akses ke fungsi ini, AAOS menyertakan implementasi MediaBrowserService dan MediaSession yang mengabstraksi detail komunikasi (lihat packages/apps/Bluetooth).

Struktur hierarki browser media masing-masing ditentukan di class BrowseTree. Perintah kontrol pemutaran dapat dikirimkan dengan cara yang sama seperti aplikasi lainnya, dengan menggunakan penerapan MediaSession-nya.

Menangani perintah media streaming

Untuk menerapkan streaming media sisi server, VIA itu sendiri harus menjadi sumber media, yang menerapkan MediaBrowse dan MediaSession API. Lihat Membangun aplikasi media untuk mobil. Dengan menerapkan API ini, aplikasi kontrol suara akan dapat (antara lain):

• Berpartisipasi dengan lancar dalam pemilihan sumber media
• Dilanjutkan secara otomatis setelah mobil dimulai ulang
• Menyediakan kontrol pemutaran dan penjelajahan menggunakan UI Pusat Media
• Menerima peristiwa tombol media hardware standar

Memenuhi perintah navigasi

Tidak ada cara standar untuk berinteraksi dengan semua aplikasi navigasi. Untuk integrasi dengan Google Maps, lihat Intent Google Maps untuk Android Automotive. Untuk integrasi dengan aplikasi lain, hubungi developer aplikasi secara langsung. Sebelum meluncurkan intent ke aplikasi mana pun (termasuk Google Maps), verifikasi bahwa intent dapat diselesaikan (lihat Intent Google Maps). Hal ini memberikan peluang untuk memberi tahu pengguna jika aplikasi target tidak tersedia.

Memenuhi perintah kendaraan

Akses ke properti kendaraan untuk baca dan tulis disediakan melalui CarPropertyManager. Jenis properti kendaraan, penerapannya, dan detail lainnya dijelaskan dalam Konfigurasi properti. Untuk deskripsi akurat tentang properti yang didukung oleh Android, sebaiknya langsung merujuk ke hardware/interfaces/automotive/vehicle/2.0/types.hal. Enum VehicleProperty yang ditentukan di sana berisi properti standar dan khusus vendor, jenis data, mode perubahan, unit, dan definisi akses baca/tulis.

Untuk mengakses konstanta yang sama ini dari Java, Anda dapat menggunakan VehiclePropertyIds dan class pendampingnya. Properti yang berbeda memiliki izin Android yang berbeda untuk mengontrol aksesnya. Izin ini dideklarasikan dalam manifes CarService, dan pemetaan antara properti dan izin dijelaskan dalam Javadoc VehiclePropertyIds dan diterapkan di PropertyHalServiceIds.

Membaca properti kendaraan

Berikut adalah contoh yang menunjukkan cara membaca kecepatan kendaraan:

public class CarActuator ... {
    private final Car mCar;
    private final CarPropertyManager mCarPropertyManager;
    private final TextToSpeech mTTS;

    /** Global VHAL area id */
    public static final int GLOBAL_AREA_ID = 0;

    public CarActuator(Context context, TextToSpeech tts) {
        mCar = Car.createCar(context);
        mCarPropertyManager = (CarPropertyManager) mCar.getCarManager(Car.PROPERTY_SERVICE);
        mTTS = tts;
        ...
    }

    @Nullable
    private void getSpeedInMetersPerSecond() {
        if (!mCarPropertyManager.isPropertyAvailable(VehiclePropertyIds.PERF_VEHICLE_SPEED,
                GLOBAL_AREA_ID)) {
            mTTS.speak("I'm sorry, but I can't read the speed of this vehicle");
            return;
        }
        // Data type and unit can be found in
        // automotive/vehicle/2.0/types.hal
        float speedInMps = mCarPropertyManager.getFloatProperty(
                VehiclePropertyIds.PERF_VEHICLE_SPEED, GLOBAL_AREA_ID);
        int speedInMph = (int)(speedInMetersPerSecond * 2.23694f);
        mTTS.speak(String.format("Sure. Your current speed is %d miles "
                + "per hour", speedInUserUnit);
    }

    ...
}

Menetapkan properti kendaraan

Berikut adalah contoh yang menunjukkan cara mengaktifkan dan menonaktifkan AC depan.

public class CarActuator … {
    …

    private void changeFrontAC(boolean turnOn) {
        List<CarPropertyConfig> configs = mCarPropertyManager
                .getPropertyList(new ArraySet<>(Arrays.asList(
                    VehiclePropertyIds.HVAC_AC_ON)));
        if (configs == null || configs.size() != 1) {
            mTTS.speak("I'm sorry, but I can't control the AC of your vehicle");
            return;
        }

        // Find the front area Ids for the AC property.
        int[] areaIds = configs.get(0).getAreaIds();
        List<Integer> areasToChange = new ArrayList<>();
        for (int areaId : areaIds) {
            if ((areaId & (VehicleAreaSeat.SEAT_ROW_1_CENTER
                        | VehicleAreaSeat.SEAT_ROW_1_LEFT
                        | VehicleAreaSeat.SEAT_ROW_1_RIGHT)) == 0) {
                continue;
            }
            boolean isACInAreaAlreadyOn = mCarPropertyManager
                    .getBooleanProperty(VehiclePropertyIds.HVAC_AC_ON, areaId);
            if ((!isACInAreaAlreadyOn && turnOn) || (isACInAreaAlreadyOn && !turnOn)) {
                areasToChange.add(areaId);
            }
        }
        if (areasToChange.isEmpty()) {
            mTTS.speak(String.format("The AC is already %s", turnOn ? "on" : "off"));
            return;
        }

        for (int areaId : areasToChange) {
            mCarPropertyManager.setBooleanProperty(
                VehiclePropertyIds.HVAC_AC_ON, areaId, turnOn);
        }
        mTTS.speak(String.format("Okay, I'm turning your front AC %s",
            turnOn ? "on" : "off"));
    }

    …
}

Memenuhi perintah komunikasi

Menangani perintah pesan

VIA harus menangani pesan masuk mengikuti alur "ketuk untuk membaca" yang dijelaskan di Ketuk untuk Membaca Asisten suara, yang secara opsional dapat menangani pengiriman balasan kembali kepada pengirim pesan masuk. Selain itu, VIA dapat menggunakan SmsManager (bagian dari paket android.telephony ) untuk menyusun dan mengirim pesan SMS langsung dari mobil atau melalui Bluetooth.

Menangani perintah panggilan

Dengan cara yang sama, VIA dapat menggunakan TelephonyManager untuk melakukan panggilan telepon dan menelepon ke nomor pesan suara pengguna. Dalam kasus ini, VIA akan berinteraksi dengan stack telepon secara langsung atau dengan aplikasi Car Dialer. Bagaimanapun, aplikasi Car Dialer harus menjadi aplikasi yang menampilkan UI terkait panggilan suara kepada pengguna.

Memenuhi perintah lainnya

Untuk daftar kemungkinan titik integrasi lainnya antara VIA dan sistem, periksa daftar intent Android terkenal. Banyak perintah pengguna dapat diselesaikan di sisi server (misalnya, membaca email dan acara kalender pengguna) dan tidak memerlukan interaksi apa pun dengan sistem selain interaksi suara itu sendiri.

Tindakan imersif (menampilkan konten visual)

Jika meningkatkan tindakan atau pemahaman pengguna, VIA dapat memberikan konten visual tambahan di layar mobil. Untuk meminimalkan gangguan pengemudi, buat konten tersebut sederhana, singkat, dan dapat ditindaklanjuti. Untuk mengetahui detail tentang pedoman UI/UX pada tindakan imersif, lihat Asisten yang Sudah Dimuat: Panduan UX.

Untuk mengaktifkan penyesuaian dan konsistensi dengan desain head unit (HU) lainnya, VIA harus menggunakan komponen Car UI Library untuk sebagian besar elemen UI. Untuk mengetahui detailnya, lihat Penyesuaian.