O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Esta página foi traduzida pela API Cloud Translation.

Serviço de proxy de exibição para automóveis

Com esse serviço de framework simples, processos usam SurfaceFlinger/EGL em implementações de HAL, sem vinculação libgui O AOSP oferece a implementação padrão desse serviço, que é totalmente funcional. No entanto, o fornecedor também precisa implementar APIs para fornecer esse serviço na plataforma.

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

Para usar este serviço:

Baixe o IAutomotiveDisplayProxyService.

android::sp<IAutomotiveDisplayProxyService> windowProxyService =
    IAutomotiveDisplayProxyService::getService("default");
if (windowProxyService == nullptr) {
    LOG(ERROR) << "Cannot use AutomotiveDisplayProxyService. Exiting.";
    return 1;
}

Extraia informações de uma tela ativa do serviço para determinar a resolução.

// 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;
});

Extrair um IGraphicBufferProducer de hardware (ou HIDL GraphicBufferProducer (HGBP) de IAutomotiveDisplayProxyService:

mGfxBufferProducer = pWindowProxy->getIGraphicBufferProducer(displayId);
if (mGfxBufferProducer == nullptr) {
    LOG(ERROR) << "Failed to get IGraphicBufferProducer from "
               << "IAutomotiveDisplayProxyService.";
    return false;
}

Receber um SurfaceHolder de um HGBP recuperado usando a API libbufferqueueconverter:

mSurfaceHolder = getSurfaceFromHGBP(mGfxBufferProducer);
if (mSurfaceHolder == nullptr) {
    LOG(ERROR) << "Failed to get a Surface from HGBP.";
    return false;
}

Converta um SurfaceHolder em uma janela nativa usando o API libbufferqueueconverter:

mWindow = getNativeWindow(mSurfaceHolder.get());
if (mWindow == nullptr) {
    LOG(ERROR) << "Failed to get a native window from Surface.";
    return false;
}

Crie uma superfície de janela EGL com uma janela nativa e renderize:

// 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;
}
...

Ligar para IAutomotiveDisplayProxyService::showWindow() exibir a visualização renderizada na tela. Esse serviço tem a prioridade mais alta e, Portanto, sempre assume o controle da tela pelo proprietário atual:
```
mAutomotiveDisplayProxyService->showWindow();
```

Consulte service.cpp e GlWrapper.cpp em $ANDROID_BUILD_TOP/packages/services/Car/evs/sampleDriver/ para mais detalhes de implementação.

Uma implementação de HAL de EVS exige que as bibliotecas adicionais exibidas em negrito abaixo.

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",
    ],

Suporte a várias telas

Exibir a enumeração do dispositivo e recuperar informações de exibição

Assim como a enumeração do dispositivo de câmera, o framework EVS fornece um método para enumerar as exibições disponíveis. O identificador de exibição estático codifica um identificador de tipo longo, o elemento informações de porta em byte mínimo e Extended Display IDentification Data em bits superiores. IAutomotiveDisplayProxyService::getDisplayIdList() retorna uma lista. de IDs de exibição de telas físicas locais, que estão disponíveis para o serviço EVS, e IEvsEnumerator::getDisplayIdList() retorna uma lista de objetos às quais as portas detectadas estão conectadas. O primeiro ID na lista é sempre de na tela principal.

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

Abrir dispositivo de exibição de destino

O app EVS chama IEvsEnumerator::openDisplay_1_1() com uma tela de destino número da porta:

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

Observação:somente uma tela pode estar em uso por vez, o que significa que o cliente EVS atual perde a exibição quando outro cliente EVS solicitações para abrir a tela, mesmo que não sejam iguais.