Communitygithub.com

Sitio web 3D premium

Directrices para crear sitios web 3D de alta calidad, centrándose en shaders WebGL personalizados, post-procesamiento, interacciones basadas en física, animaciones suaves, preloaders y optimización para dispositivos.

¿Qué es Sitio web 3D premium?

Esta habilidad proporciona pautas arquitectónicas y patrones de código para desarrollar sitios web 3D premium y de alta gama. Está dirigida a desarrolladores que buscan implementar efectos visuales avanzados de WebGL, pipelines de shaders personalizados, elementos físicos interactivos y transiciones de página inmersivas, manteniendo un alto rendimiento. La habilidad es útil cuando se diseñan sitios web creativos galardonados con elementos 3D, al integrar Three.js, React Three Fiber (R3F) o Spline con shaders personalizados (GLSL), al implementar efectos de post-procesamiento como bloom, profundidad de campo o grano de película, al diseñar preloaders interactivos y estrategias de carga de activos de alto rendimiento, y al optimizar escenas 3D complejas para capacidad de respuesta móvil y rendimiento. El proceso incluye establecer un bucle de renderizado robusto con manejo de redimensionamiento y relaciones de píxeles limitadas, implementar pipelines de post-procesamiento, integrar física interactiva y animaciones, y optimizar los activos 3D con compresión Draco y gestores de carga personalizados para mostrar preloaders atractivos. La habilidad también enfatiza las mejores prácticas como limitar la relación de píxeles, deshabilitar el antialiasing durante el post-procesamiento, hornear iluminación en texturas y usar renderizado de instancias, mientras se advierte contra el uso de modelos no comprimidos o sombras en tiempo real en dispositivos de gama baja.

Compatible con✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/AbbasMalikzada/agent-skills/tree/HEAD/skills/premium-3d-website

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Sitio web 3D premium?

Descripción general

Esta habilidad proporciona pautas arquitectónicas y patrones de código para desarrollar sitios web 3D premium y de alta gama. Está dirigida a desarrolladores que buscan implementar efectos visuales avanzados de WebGL, pipelines de shaders personalizados, elementos físicos interactivos y transiciones de página inmersivas, manteniendo un alto rendimiento.

Cuándo usar esta habilidad

  • Úsela al diseñar sitios web creativos premium o galardonados con elementos 3D.
  • Úsela al integrar Three.js, React Three Fiber (R3F) o Spline con shaders personalizados (GLSL).
  • Úsela al implementar efectos de post-procesamiento como bloom, profundidad de campo o grano de película personalizado.
  • Úsela al diseñar preloaders interactivos y estrategias de carga de activos de alto rendimiento.
  • Úsela al optimizar escenas 3D complejas para capacidad de respuesta móvil y rendimiento.

Cómo funciona

Paso 1: Establecer el bucle de renderizado y la arquitectura de la escena

Configurar un contexto WebGL robusto con manejo de redimensionamiento adecuado y relaciones de píxeles favorables al rendimiento es crucial. Mantenga las relaciones de píxeles limitadas a un máximo de 2 para evitar renderizar demasiados píxeles en pantallas de alta densidad.

Paso 2: Implementar efectos de shader y post-procesamiento

Incorpore pipelines de post-procesamiento (usando EffectComposer o @react-three/postprocessing) para agregar bloom, aberración cromática, profundidad de campo o grano de película. Mantenga los pases bajos y combine shaders de fragmentos personalizados para minimizar las llamadas de dibujo.

Paso 3: Integrar física interactiva y movimiento

Utilice marcos de física (como Cannon.js o Rapier) o animaciones de resorte procedimentales para que los objetos 3D reaccionen al hover del ratón, arrastre y clics con retroalimentación orgánica.

Paso 4: Pipeline de activos y preloader

Optimice los modelos 3D (usando compresión Draco) y cárguelos usando gestores de carga personalizados. Renderice preloaders interactivos para entretener a los usuarios mientras los activos pesados se obtienen en segundo plano.

Ejemplos

Ejemplo 1: Post-procesamiento personalizado en React Three Fiber (R3F)

import { Canvas } from '@react-three/fiber';
import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';

export default function PremiumComposer() {
  return (
    <Canvas dpr={[1, 2]} gl={{ powerPreference: "high-performance", antialias: false }}>
      <ambientLight intensity={0.5} />
      <mesh>
        <boxGeometry />
        <meshStandardMaterial emissive="orange" emissiveIntensity={2.0} />
      </mesh>
      
      <EffectComposer disableNormalPass>
        <DepthOfField focusDistance={0} focalLength={0.02} bokehScale={2} height={480} />
        <Bloom luminanceThreshold={0.3} luminanceSmoothing={0.9} height={300} />
        <Vignette eskil={false} offset={0.1} darkness={1.1} />
      </EffectComposer>
    </Canvas>
  );
}

Ejemplo 2: Material de shader GLSL personalizado para efectos líquidos/ondulados

import * as THREE from 'three';

const CustomWavyMaterial = new THREE.ShaderMaterial({
  vertexShader: `
    varying vec2 vUv;
    uniform float uTime;
    void main() {
      vUv = uv;
      vec3 pos = position;
      pos.z += sin(pos.x * 5.0 + uTime) * 0.1;
      pos.z += cos(pos.y * 5.0 + uTime) * 0.1;
      gl_Position = projectionMatrix * modelViewMatrix * vec4(pos, 1.0);
    }
  `,
  fragmentShader: `
    varying vec2 vUv;
    uniform float uTime;
    uniform vec3 uColor;
    void main() {
      float pulse = 0.5 + 0.5 * sin(uTime + vUv.x * 10.0);
      gl_FragColor = vec4(uColor * pulse, 1.0);
    }
  `,
  uniforms: {
    uTime: { value: 0.0 },
    uColor: { value: new THREE.Color('#3b82f6') }
  }
});

Mejores prácticas

  • ✅ Establezca dpr={[1, 2]} para restringir la relación de píxeles del dispositivo a un máximo de 2.
  • ✅ Deshabilite el antialiasing en el WebGLRenderer cuando el post-procesamiento esté activo para evitar penalizaciones de rendimiento por doble antialiasing.
  • ✅ Hornee la oclusión ambiental, la iluminación y las sombras en texturas usando Blender u otro software 3D en lugar de usar luces dinámicas y sombras en tiempo real.
  • ✅ Use renderizado de instancias (THREE.InstancedMesh o <Instances> de R3F) para escenas que contengan múltiples mallas idénticas.
  • ❌ Evite usar modelos GLTF/OBJ sin comprimir. Siempre comprima los modelos usando Draco o Meshopt.
  • ❌ Evite mapas de sombras en tiempo real (como THREE.DirectionalLightShadow) en dispositivos móviles o de gama baja debido a la gran sobrecarga de rendimiento.

Limitaciones

  • Esta habilidad no reemplaza la validación, las pruebas o la revisión de expertos específicos del entorno.
  • Deténgase y solicite aclaraciones si faltan entradas requeridas, permisos o límites de seguridad.
  • Las matemáticas complejas de shaders y los límites de simulación física avanzada requieren pruebas manuales en diferentes conjuntos de chips de dispositivos.

Notas de seguridad y protección

  • Verifique que las URL de modelos 3D externos (cargados mediante GLTFLoader) estén alojadas en CDNs confiables y seguras (HTTPS).
  • No ejecute scripts de shell arbitrarios no validados ni use paquetes NPM no fijos para optimizar activos.

Errores comunes

  • Problema: Caída severa de velocidad de fotogramas en dispositivos móviles o pantallas de alta densidad (Retina). Solución: Asegúrese de que la relación de píxeles esté limitada a 2 (renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))) y deshabilite los pases de post-procesamiento no utilizados.
  • Problema: Tiempos de carga largos y pantallas blancas durante la inicialización. Solución: Use un gestor de carga (THREE.LoadingManager) y muestre un preloader interactivo y receptivo para mantener al usuario comprometido.

Habilidades relacionadas

  • @3d-web-experience - Conceptos básicos de WebGL, Three.js y Spline.
  • @scroll-experience - Integración de animación 3D con controladores de desplazamiento.
  • @performance-optimizer - Ajuste general del rendimiento de la ejecución del código.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados