บริการเฟรมเวิร์กที่เรียบง่ายนี้ช่วยให้กระบวนการของผู้จำหน่ายใช้ SurfaceFlinger/EGL ในการใช้งาน HAL โดยไม่ต้องลิงก์ libgui AOSP จัดเตรียมการใช้งานเริ่มต้นของบริการนี้ ซึ่งทำงานได้อย่างสมบูรณ์ อย่างไรก็ตาม ผู้จำหน่ายต้องใช้ API เพื่อให้บริการนี้บนแพลตฟอร์มของตนด้วย
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); }
หากต้องการใช้บริการนี้:
- รับ
IAutomotiveDisplayProxyService
android::sp<IAutomotiveDisplayProxyService> windowProxyService = IAutomotiveDisplayProxyService::getService("default"); if (windowProxyService == nullptr) { LOG(ERROR) << "Cannot use AutomotiveDisplayProxyService. Exiting."; return 1; }
- ดึงข้อมูลการแสดงผลที่ใช้งานอยู่จากบริการเพื่อกำหนดความละเอียด
// 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; });
- ดึงฮาร์ดแวร์
IGraphicBufferProducer
(หรือ HIDL GraphicBufferProducer (HGBP) จากIAutomotiveDisplayProxyService
:mGfxBufferProducer = pWindowProxy->getIGraphicBufferProducer(displayId); if (mGfxBufferProducer == nullptr) { LOG(ERROR) << "Failed to get IGraphicBufferProducer from " << "IAutomotiveDisplayProxyService."; return false; }
- รับ
SurfaceHolder
จาก HGBP ที่ดึงข้อมูลโดยใช้ APIlibbufferqueueconverter
:mSurfaceHolder = getSurfaceFromHGBP(mGfxBufferProducer); if (mSurfaceHolder == nullptr) { LOG(ERROR) << "Failed to get a Surface from HGBP."; return false; }
- แปลง
SurfaceHolder
ให้เป็นหน้าต่างดั้งเดิมโดยใช้ APIlibbufferqueueconverter
:mWindow = getNativeWindow(mSurfaceHolder.get()); if (mWindow == nullptr) { LOG(ERROR) << "Failed to get a native window from Surface."; return false; }
- สร้างพื้นผิวหน้าต่าง EGL ด้วยหน้าต่างดั้งเดิมแล้วเรนเดอร์:
// 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; } ...
- โทร
IAutomotiveDisplayProxyService::showWindow()
เพื่อแสดงมุมมองที่แสดงผลบนหน้าจอ บริการนี้มีลำดับความสำคัญสูงสุด ดังนั้นจึงเข้าควบคุมหน้าจอจากเจ้าของปัจจุบันเสมอ:mAutomotiveDisplayProxyService->showWindow();
ดู service.cpp
และ GlWrapper.cpp
ใน $ANDROID_BUILD_TOP/packages/services/Car/evs/sampleDriver/
สำหรับรายละเอียดการใช้งานเพิ่มเติม
การใช้งาน EVS HAL จำเป็นต้องมีไลบรารีเพิ่มเติมที่แสดงเป็น ตัวหนา ด้านล่าง
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", ],
รองรับการแสดงผลหลายจอ
แสดงการแจงนับอุปกรณ์และดึงข้อมูลการแสดงผล
เช่นเดียวกับการแจงนับอุปกรณ์กล้อง กรอบงาน EVS มีวิธีในการแจงนับจอแสดงผลที่พร้อมใช้งาน ตัวระบุการแสดงผลแบบคงที่ จะเข้ารหัสตัวระบุชนิดยาว ข้อมูลพอร์ตการแสดงผลในไบต์ล่าง และ Extended Display IDentification Data
ในบิตด้านบน IAutomotiveDisplayProxyService::getDisplayIdList()
ส่งคืนรายการ ID การแสดงผลของจอแสดงผลในตัวเครื่องจริง ซึ่งพร้อมใช้งานสำหรับบริการ EVS และ IEvsEnumerator::getDisplayIdList()
ส่งคืนรายการพอร์ตการแสดงผลที่ตรวจพบว่าจอแสดงผลเชื่อมต่ออยู่ รหัสแรกในรายการจะเป็นของจอแสดงผลหลักเสมอ
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); };
เปิดอุปกรณ์แสดงผลเป้าหมาย
แอป EVS เรียก IEvsEnumerator::openDisplay_1_1() พร้อมหมายเลขพอร์ตการแสดงผลเป้าหมาย:
android::sp<IEvsDisplay> pDisplay = pEvs->openDisplay_1_1(displayId); if (pDisplay.get() == nullptr) { LOG(ERROR) << "EVS Display unavailable. Exiting."; return 1; }
หมายเหตุ: สามารถใช้จอแสดงผลได้เพียงจอเดียวในคราวเดียว ซึ่งหมายความว่าไคลเอนต์ EVS ปัจจุบันจะสูญเสียการแสดงผลเมื่อไคลเอนต์ EVS อื่นร้องขอให้เปิดจอแสดงผล แม้ว่าจะไม่เหมือนกันก็ตาม