Librería 369peerjs

1. Inicio Rápido desde CDN

Incorpóralo directamente en cualquier aplicación web desde la CDN oficial cifrada por SSL:

<!-- Importar versión minificada de producción -->
<script src="https://369peerjs.net.ar/369peer.min.js"></script>

<script>
  // Inicializar Peer con servidor propio y preset 1080p por defecto
  const peer = new Peer369('mi-usuario-id', {
    preset: '1080p',
    videoFormat: 'VP9'
  });

  peer.on('open', (id) => {
    console.log('✅ Conectado exitosamente con ID:', id);
  });
</script>

2. Presets de Resolución (720p a 4K)

La librería cuenta con presets integrados que aplican restricciones ideales de resolución, FPS, ancho de banda doble SDP (`b=AS:` y `b=TIAS:`) y preferencias de no-pixelado:

const peer = new Peer369({
  preset: '4k', // Asigna 3840x2160@60fps y 35 Mbps de ancho de banda
  videoFormat: 'VP9', // VP9 o H264/AV1
  degradationPreference: 'maintain-resolution' // Mantiene nitidez 4K
});

// Ajustar dinámicamente el ancho de banda durante una llamada
peer.setBitrate(25000); // Cambiar a 25 Mbps en vivo

// O cambiar preset dinámicamente
peer.setQualityPreset('1080p');

3. Transmisión de Pantalla en Alta Calidad (Nativa)

Para compartir la pantalla sin desenfoque ni degradación de texto (código fuente, documentos, dashboards o video en movimiento):

async function transmitirPantallaAltaCalidad(receptorId) {
  try {
    // 1. Obtener stream de pantalla a resolución nativa completa (hasta 4K 60fps)
    const screenStream = await navigator.mediaDevices.getDisplayMedia({
      video: {
        width: { ideal: 3840, max: 3840 },
        height: { ideal: 2160, max: 2160 },
        frameRate: { ideal: 60, max: 60 },
        displaySurface: 'monitor'
      },
      audio: true
    });

    // 2. Transmitir al receptor
    const call = peer.call(receptorId, screenStream);

    call.on('connected', () => {
      console.log('🚀 Transmisión de pantalla en alta calidad conectada con:', receptorId);
    });

    // Detectar cuando el usuario detiene la captura desde la barra del navegador
    screenStream.getVideoTracks()[0].onended = () => {
      console.log('🛑 Transmisión finalizada por el usuario');
      call.close();
    };

  } catch (err) {
    console.error('❌ Error capturando pantalla:', err);
  }
}

5. Infraestructura STUN / TURN / TURNS SSL

La librería viene preconfigurada con servidores STUN/TURN de alta disponibilidad con soporte TLS cifrado:

6. Objeto de Configuración Completo `Peer369`

const peer = new Peer369('mi-peer-id', {
  // Servidor de señalización WebSocket
  signalingServer: 'wss://369peerjs.net.ar',

  // Preset de calidad multimedia: '720p', '1080p', '2k', '4k'
  preset: '1080p',

  // Ancho de banda personalizado en kbps (sobreescribe el preset)
  bandwidth: 10000,

  // Codec de video preferido: 'VP9', 'H264', 'VP8', 'AV1'
  videoFormat: 'VP9',

  // Preferencia de degradación: 'maintain-resolution', 'maintain-framerate', 'balanced'
  degradationPreference: 'maintain-resolution',

  // Restricciones de captura de cámara personalizadas
  videoConstraints: {
    width: { ideal: 1920 },
    height: { ideal: 1080 },
    frameRate: { ideal: 60 }
  },

  // Configuración de servidor TURN/STUN personalizado
  turnServer: {
    realm: '369app.net.ar',
    ip: '13.140.43.187',
    port: 3478,
    turnsPort: 5349,
    user: '369user',
    password: '369turnpass2026',
    secret: 'LAhienas123'
  }
});

7. Métodos y Eventos de la API

Métodos Principales de `Peer369`

Eventos Emitidos

8. Transferencia de Archivos y Canales Binarios Chunked

Soporte para transferencia de archivos de gigabytes divididos en fragmentos de 16 KB con encabezado binario de 14 bytes y sin límite de tamaño:

const dataConn = peer.connect('receptor-id', {
  serialization: 'binary',
  reliable: true
});

dataConn.on('open', () => {
  const file = document.getElementById('fileInput').files[0];
  console.log('📦 Enviando archivo:', file.name, file.size, 'bytes');
  dataConn.send(file);
});

// Receptor
peer.on('connection', (conn) => {
  conn.on('data', (data) => {
    if (data instanceof Blob || data instanceof ArrayBuffer) {
      console.log('✅ Archivo completo recibido');
    }
  });
});

9. Overlay HUD para Mostrar Calidad Real en Pantalla

La librería incluye el método nativo attachStatsHUD(videoElement) para mostrar una insignia flotante sobre el reproductor de video con las métricas en tiempo real (Resolución exacta, FPS, Bitrate Mbps, Latencia RTT y Codec en uso):

const call = peer.call('receptor-id', stream);

call.on('stream', (remoteStream) => {
  const videoElem = document.getElementById('remoteVideo');
  videoElem.srcObject = remoteStream;

  // Adjuntar insignia HUD sobre el video (Muestra: 3840x2160, 60 FPS, 34.8 Mbps, 12ms RTT, VP9)
  const detachHUD = call.attachStatsHUD(videoElem);

  // Para remover el HUD cuando finalice la llamada:
  // detachHUD();
});

10. Autor & Creador de la Librería