Artículos previos recomendados para desarrollo HarmonyOS NEXT:

Introducción rápida al desarorllo de aplicaciones para HarmonyOS Next (versión nativa)

Guía completa para aprender desarrollo de aplicaciones en HarmonyOS Next (desde principiantes hasta expertos)

Casos prácticos de desarrollo para HarmonyOS NEXT (actualizaciones periódicas)

Optimización de rendimiento en aplicaciones HarmonyOS NEXT (actualizaciones periódicas)

Introducción

XComponent permite a las aplicaciones acceder a la API de gráficos OpenGLES en el entorno nativo. Este artículo explica cómo integrar eventos Vsync para crear animaciones personalizadas. Este enfoque desacopla la renderización de la animación del hilo principal de UI, garantizando que incluso si el hilo principal se bloquea, las animaciones mantendrán su fluidez.

Demostración funcional

Enfoque de implementación

1. Configuración de dependencias en CMakeLists

find_library( # Nombre de la variable de ruta
               libvsync_native
               # Biblioteca nativa objetivo
               native_vsync )

1. Instancia de Vsync

#include <native_vsync/native_vsync.h>

ParametroSincronizacion *config = new ParametroSincronizacion();
config->contextoEGL = this;
config->ventana = ventana;
void* vsyncHandle = OH_NativeVSync_Create(GAME_SYNC_NAME, 3);
if (!vsyncHandle) {
    LOGE("ContextoEGL:: Error creando manejador Vsync");
    return;
}

1. Registro del callback de frame con operaciones de renderizado EGL

OH_NativeVSync_RequestFrame(
    vsyncHandle,
    [](long long marcaTiempo, void *datos) {
        LOGI("ContextoEGL:: Callback Vsync - Tiempo: %{public}lld", marcaTiempo);
        ParametroSincronizacion *params = (ParametroSincronizacion*)datos;
        if (!params) return;

        ContextoEGL *contexto = params->contextoEGL;
        void *ventana = params->ventana;
        
        contexto->ventanaRender = reinterpret_cast<EGLNativeWindowType>(ventana);
        ...
        contexto->renderizarFigura();
        contexto->actualizarReflexion();
        contexto->modificarAmbiente();
    },
    config
);

Nota: El callback se ejecuta en un hilo distinto al que solicitó el evento, por lo que la inicialización de la ventana EGL debe realizarse dentro del callback.

Conceptos clave de rendimiento

• Cada instancia Vsync genera un nuevo hilo EventRunner. Las operaciones en este hilo afectan únicamente la frecuencia de la animación, sin interferir en el hilo principal de la aplicación.
• Las operaciones OpenGLES restantes siguen las mismas convenciones que en la implementación estándar de OpenGLES

Estructura del proyecto

XcomponentVsync                                      // Tipo de módulo HAR
|---cpp                                              // Implementación nativa con XComponent y Vsync
|---pages
|   |---XcomponentVsync.ets                          // Carga del componente XComponent