Layanan proxy layar otomotif

Layanan kerangka kerja sederhana ini memungkinkan vendor proses menggunakan SurfaceFlinger/EGL dalam implementasi HAL, tanpa menautkan libgui. AOSP menyediakan implementasi default layanan ini, fungsional. Namun, vendor juga harus menerapkan API untuk menyediakan layanan ini platform mereka.

package android.frameworks.automotive.display@1.0;

import android.hardware.graphics.bufferqueue@2.0::IGraphicBufferProducer;

interface IAutomotiveDisplayProxyService {
    /**
     * Gets an IGraphicBufferProducer instance from the service.
     *
     * @param  id   Target's stable display identifier
     *
     * @return igbp Returns an IGraphicBufferProducer object, that can be
     *              converted to an ANativeWindow object.
     */
    getIGraphicBufferProducer(uint64_t id) generates (IGraphicBufferProducer igbp);

    /**
     * Sets the ANativeWindow, which is associated with the
     * IGraphicBufferProducer, to be visible and to take over the display.
     *
     * @param  id      Target display ID
     *
     * @return success Returns true on success.
     */
    showWindow(uint64_t id) generates (bool success);

    /**
     * Sets the ANativeWindow, which is associated with the
     * IGraphicBufferProducer, to be invisible and to release the control
     * over display.
     *
     * @param  id      Target display ID
     *
     * @return success Returns true on success.
     */
    hideWindow(uint64_t id) generates (bool success);

    /**
     * Returns the stable identifiers of all available displays.
     *
     * @return ids A list of stable display identifiers.
     */
    getDisplayIdList() generates (vec<uint64_t> ids);

    /**
     * Returns the descriptor of the target display.
     *
     * @param  id    Stable ID of a target display.
     * @return cfg   DisplayConfig of the active display.
     * @return state Current state of the active display.
     */
    getDisplayInfo(uint64_t id) generates (HwDisplayConfig cfg, HwDisplayState state);
}

Untuk menggunakan layanan ini:

  1. Dapatkan IAutomotiveDisplayProxyService. 
    android::sp<IAutomotiveDisplayProxyService> windowProxyService =
            IAutomotiveDisplayProxyService::getService("default");
    if (windowProxyService == nullptr) {
        LOG    (ERROR) << "Cannot use AutomotiveDisplayProxyService. Exiting.";
            return 1;
    }
  2. Mengambil informasi tampilan aktif dari layanan untuk menentukan resolusi. 
    // We use the first display in the list as the primary.
    pWindowProxy    ->getDisplayInfo(displayId, [this](auto dpyConfig, auto dpyState) {
            DisplayConfig *pConfig = (DisplayConfig*)dpyConfig.data();
        mWidth     = pConfig->resolution.getWidth();
        mHeight     = pConfig->resolution.getHeight();

        ui    ::DisplayState* pState = (ui::DisplayState*)dpyState.data();
            if (pState->orientation != ui::ROTATION_0 &&
            pState    ->orientation != ui::ROTATION_180) {
                // rotate
            std    ::swap(mWidth, mHeight);
            }

        LOG    (DEBUG) << "Display resolution is " << mWidth << " x " << mHeight;
    });
  3. Ambil IGraphicBufferProducer hardware (atau, HIDL GraphicBufferProducer (HGBP) dari IAutomotiveDisplayProxyService: 
    mGfxBufferProducer = pWindowProxy->getIGraphicBufferProducer(displayId);
    if (mGfxBufferProducer == nullptr) {
        LOG    (ERROR) << "Failed to get IGraphicBufferProducer from "
                       << "IAutomotiveDisplayProxyService.";
            return false;
    }
  4. Mendapatkan SurfaceHolder dari HGBP yang diambil, menggunakan API libbufferqueueconverter: 
    mSurfaceHolder = getSurfaceFromHGBP(mGfxBufferProducer);
    if (mSurfaceHolder == nullptr) {
        LOG    (ERROR) << "Failed to get a Surface from HGBP.";
            return false;
    }
  5. Konversi SurfaceHolder menjadi jendela native dengan menggunakan API libbufferqueueconverter: 
    mWindow = getNativeWindow(mSurfaceHolder.get());
    if (mWindow == nullptr) {
        LOG    (ERROR) << "Failed to get a native window from Surface.";
            return false;
    }
  6. Buat platform jendela EGL dengan jendela native, lalu render: 
    // Set up our OpenGL ES context associated with the default display
    mDisplay     = eglGetDisplay(EGL_DEFAULT_DISPLAY);
    if (mDisplay == EGL_NO_DISPLAY) {
        LOG    (ERROR) << "Failed to get egl display";
            return false;
    }
    ...

    // Create the EGL render target surface
    mSurface     = eglCreateWindowSurface(mDisplay, egl_config, mWindow, nullptr);
    if (mSurface == EGL_NO_SURFACE) {
        LOG    (ERROR) << "eglCreateWindowSurface failed.";
            return false;
    }
    ...
  7. Telepon IAutomotiveDisplayProxyService::showWindow() ke menampilkan tampilan yang dirender di layar. Layanan ini memiliki prioritas tertinggi dan, oleh karena itu, selalu memegang kendali layar dari pemilik saat ini: 
    mAutomotiveDisplayProxyService->showWindow();

Lihat service.cpp dan GlWrapper.cpp dalam $ANDROID_BUILD_TOP/packages/services/Car/evs/sampleDriver/ untuk detail penerapan selengkapnya.

Implementasi EVS HAL memerlukan pustaka tambahan yang ditampilkan di tebal di bawah.

cc_binary {
    name: "android.hardware.automotive.evs@1.1-sample",

    vendor: true,

    srcs: [
        ...
    ],

    shared_libs: [
        ...
        "libbufferqueueconverter",
        "android.hidl.token@1.0-utils",
        "android.frameworks.automotive.display@1.0",
        "android.hardware.graphics.bufferqueue@1.0",
        "android.hardware.graphics.bufferqueue@2.0",
    ],

Dukungan multi-tampilan

Menampilkan enumerasi perangkat dan mengambil informasi tampilan

Seperti enumerasi perangkat kamera, {i>framework<i} EVS menyediakan metode untuk menghitung tampilan yang tersedia. ID tampilan statis mengenkode ID jenis panjang, yaitu informasi porta di byte bawah dan Extended Display IDentification Data di bit atas. IAutomotiveDisplayProxyService::getDisplayIdList() menampilkan daftar ID tampilan pada tampilan lokal fisik, yang tersedia untuk layanan EVS, dan IEvsEnumerator::getDisplayIdList() menampilkan daftar tampilan porta yang terdeteksi terhubung dengan layar perangkat. ID pertama dalam daftar selalu dari layar utama.

interface IEvsEnumerator extends @1.0::IEvsEnumerator {
    ...
    /**
     * Returns a list of all EVS displays available to the system
     *
     * @return displayIds Identifiers of available displays.
     */
    getDisplayIdList() generates (vec<uint8_t> displayIds);
};

Membuka perangkat layar target

Aplikasi EVS memanggil IEvsEnumerator::openDisplay_1_1() dengan tampilan target nomor port:

android::sp<IEvsDisplay> pDisplay = pEvs->openDisplay_1_1(displayId);
if (pDisplay.get() == nullptr) {
    LOG(ERROR) << "EVS Display unavailable. Exiting.";
    return 1;
}

Catatan: Hanya satu layar yang dapat digunakan pada satu waktu, yang berarti klien EVS saat ini kehilangan tampilannya ketika klien EVS lain untuk membuka layar, bahkan saat tidak sama.