Ta prosta usługa ramowa umożliwia procesom dostawców używanie SurfaceFlinger/EGL w implementacjach HAL, bez łączenia bibliotek libgui. AOSP zapewnia domyślną implementację tej usługi, która jest w pełni funkcjonalna. Jednak dostawca musi również wdrożyć interfejsy API, aby świadczyć tę usługę na swojej platformie.
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); }
Aby skorzystać z tej usługi:
- Pobierz
IAutomotiveDisplayProxyService
.android::sp<IAutomotiveDisplayProxyService> windowProxyService = IAutomotiveDisplayProxyService::getService("default"); if (windowProxyService == nullptr) { LOG(ERROR) << "Cannot use AutomotiveDisplayProxyService. Exiting."; return 1; }
- Pobierz z usługi informacje o aktywnym ekranie, aby określić rozdzielczość.
// 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; });
- Pobierz sprzętowy
IGraphicBufferProducer
(lub HIDL GraphicBufferProducer (HGBP) zIAutomotiveDisplayProxyService
:mGfxBufferProducer = pWindowProxy->getIGraphicBufferProducer(displayId); if (mGfxBufferProducer == nullptr) { LOG(ERROR) << "Failed to get IGraphicBufferProducer from " << "IAutomotiveDisplayProxyService."; return false; }
- Uzyskaj
SurfaceHolder
z pobranego HGBP, używając APIlibbufferqueueconverter
:mSurfaceHolder = getSurfaceFromHGBP(mGfxBufferProducer); if (mSurfaceHolder == nullptr) { LOG(ERROR) << "Failed to get a Surface from HGBP."; return false; }
- Konwertuj
SurfaceHolder
na natywne okno, używając interfejsu APIlibbufferqueueconverter
:mWindow = getNativeWindow(mSurfaceHolder.get()); if (mWindow == nullptr) { LOG(ERROR) << "Failed to get a native window from Surface."; return false; }
- Utwórz powierzchnię okna EGL z natywnym oknem, a następnie wyrenderuj:
// 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; } ...
- Wywołaj funkcję
IAutomotiveDisplayProxyService::showWindow()
, aby wyświetlić wyrenderowany widok na ekranie. Ta usługa ma najwyższy priorytet i dlatego zawsze przejmuje kontrolę nad ekranem od aktualnego właściciela:mAutomotiveDisplayProxyService->showWindow();
Zobacz service.cpp
i GlWrapper.cpp
w $ANDROID_BUILD_TOP/packages/services/Car/evs/sampleDriver/
aby uzyskać więcej szczegółów implementacji.
Implementacja EVS HAL wymaga dodatkowych bibliotek wyświetlonych poniżej pogrubioną czcionką .
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", ],
Obsługa wielu wyświetlaczy
Wyświetl listę urządzeń i pobierz informacje o wyświetlaczu
Podobnie jak wyliczanie urządzeń z kamerą, środowisko EVS zapewnia metodę wyliczania dostępnych wyświetlaczy. Statyczny identyfikator wyświetlania koduje identyfikator o długim typie, informacje o porcie wyświetlacza w dolnym bajcie i Extended Display IDentification Data
w górnych bitach. IAutomotiveDisplayProxyService::getDisplayIdList()
zwraca listę identyfikatorów wyświetlaczy fizycznych wyświetlaczy lokalnych, które są dostępne dla usługi EVS, a IEvsEnumerator::getDisplayIdList()
zwraca listę portów wyświetlania, do których podłączone są wykryte wyświetlacze. Pierwszy identyfikator na liście jest zawsze identyfikatorem głównego wyświetlacza.
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); };
Otwórz docelowe urządzenie wyświetlające
Aplikacja EVS wywołuje funkcję IEvsEnumerator::openDisplay_1_1() z docelowym numerem portu wyświetlacza:
android::sp<IEvsDisplay> pDisplay = pEvs->openDisplay_1_1(displayId); if (pDisplay.get() == nullptr) { LOG(ERROR) << "EVS Display unavailable. Exiting."; return 1; }
Uwaga: jednocześnie może być używany tylko jeden wyświetlacz, co oznacza, że bieżący klient EVS traci wyświetlacz, gdy inny klient EVS zażąda otwarcia wyświetlacza, nawet jeśli nie są one takie same.