Saltar a contenido

Ver una cámara RTSP en Unity

Media Blocks SDK .NET Video Capture SDK .NET

Hay dos formas de visualizar un stream en vivo de cámara RTSP / IP en Unity, y el paquete incluye una escena lista para cada una. Ambas renderizan en un RawImage de Unity y se ejecutan en Windows, Android, macOS Standalone e iOS. Este artículo asume que ya ha importado el paquete de Unity y aplicado los dos ajustes de proyecto requeridos — consulte primero Usar VisioForge en Unity.

Dos escenas, dos motores

Escena Motor Nivel Ideal para
RTSPViewer MediaBlocksPipeline (Media Blocks SDK) Bajo nivel Control total de la canalización — elija sus propios sinks, efectos y salidas.
IPCameraX VideoCaptureCoreX (Video Capture SDK) Alto nivel Motor de captura listo para usar — añade salidas de grabación, instantáneas, enrutamiento de audio y superposiciones sobre el mismo stream.

Elija RTSPViewer cuando quiera montar la canalización usted mismo; elija IPCameraX cuando quiera un motor de captura que además pueda grabar mientras previsualiza. Ambas alimentan el mismo VisioForgeVideoView incluido, así que la subida de textura, el manejo de aspecto y el volteo vertical son idénticos.

RTSPViewer — la canalización de Media Blocks

La escena RTSPViewer muestra un stream en vivo de cámara RTSP / IP con el Media Blocks SDK .NET de bajo nivel, renderizado en un RawImage.

Ejecutar la escena RTSPViewer

  1. En la ventana Project abra Assets/Scenes/RTSPViewer.unity (haga doble clic en ella).
  2. En la Hierarchy seleccione el GameObject RawImage. El componente RTSPViewerPlayer está adjunto a él.
  3. En el Inspector, establezca Rtsp Url (y Login / Password si la cámara requiere autenticación).
  4. Pulse ▶ Play — el stream se renderiza en la vista Game.

Hierarchy de la escena RTSPViewer: Canvas con RawImage, EventSystem, Main Camera

Componente RTSPViewerPlayer en el Inspector con los campos Rtsp Url, Login y Password

Campos del Inspector (RTSPViewerPlayer)

Campo Predeterminado Descripción
Rtsp Url rtsp://192.168.1.10:554/stream URL RTSP de la cámara/stream.
Login (vacío) Nombre de usuario RTSP — déjelo vacío si el stream no necesita autenticación.
Password (vacío) Contraseña RTSP.
Auto Play On Start true Conectar automáticamente en Start().
Render Audio true Renderizar audio a través del dispositivo predeterminado del sistema.
Aspect Mode Letterbox Cómo se ajusta el video al RawImage: Stretch, Letterbox o Crop.

La canalización de RTSPViewer

RTSPViewerPlayer construye este pipeline:

graph LR;
    src[RTSPSourceBlock] -->|video| sink["BufferSinkBlock (RGBA)"];
    sink --> view["VisioForgeVideoView (Texture2D)"];
    src -->|audio, opcional| audio[AudioRendererBlock];

El núcleo de PlayAsync:

_pipeline = new MediaBlocksPipeline();

// readInfo:false omite el pre-sondeo del medio (puede fallar en el runtime de Unity, y
// sondear un stream en vivo añade latencia de conexión); el codec se negocia al iniciar la reproducción.
var settings = await RTSPSourceSettings.CreateAsync(
    new Uri(rtspUrl), login ?? string.Empty, password ?? string.Empty,
    audioEnabled: _renderAudio, readInfo: false);

_source = new RTSPSourceBlock(settings);

_videoSink = new BufferSinkBlock(VideoFormatX.RGBA);
_videoSink.OnVideoFrameBuffer += _videoView.OnFrameBuffer;
_pipeline.Connect(_source.VideoOutput, _videoSink.Input);

if (_renderAudio && _source.AudioOutput != null)
{
    _audioRenderer = new AudioRendererBlock();
    _pipeline.Connect(_source.AudioOutput, _audioRenderer.Input);
}

await _pipeline.StartAsync();

IPCameraX — el motor VideoCaptureCoreX

La escena IPCameraX visualiza la misma cámara RTSP / IP con el motor de alto nivel VideoCaptureCoreX. Además de la vista previa en vivo, puede grabar a MP4 y expone instantáneas, enrutamiento de audio y superposiciones — las funciones de motor de captura que la canalización RTSPViewer construida a mano no proporciona de fábrica.

El evento OnVideoFrameUnity

VideoCaptureCoreX expone el evento exclusivo de Unity OnVideoFrameUnity: cada fotograma llega como RGBA32 empaquetado de forma compacta (Stride == Width * 4), listo para Texture2D.LoadRawTextureData sin conversión. Suscríbase antes de StartAsync.

Ejecutar la escena IPCameraX

  1. En la ventana Project abra Assets/Scenes/SampleScene.unity.
  2. En la Hierarchy seleccione el GameObject RawImage — el componente IPCameraXViewer está adjunto a él.
  3. En el Inspector establezca Rtsp Url (y Login / Password si la cámara los necesita).
  4. Pulse ▶ Play — el stream de la cámara aparece en la vista Game.

Campos del Inspector (IPCameraXViewer)

Campo Predeterminado Descripción
Rtsp Url rtsp://192.168.1.10:554/stream URL de cámara RTSP / HTTP.
Login (vacío) Nombre de usuario de la cámara (vacío para streams abiertos).
Password (vacío) Contraseña de la cámara (vacío para streams abiertos).
Render Audio false Solicitar y renderizar el stream de audio de la cámara, si está presente.
Record To File false Grabar el stream a MP4 mientras se previsualiza.
Output Path (vacío) Ruta MP4. Vacío → <persistentDataPath>/ipcamera.mp4.
Auto Play On Start true Conectar automáticamente en Start().
Aspect Mode Letterbox Cómo se ajusta el video en el RawImage.

La canalización de IPCameraX

graph LR;
    rtsp["VideoCaptureCoreX (RTSP source)"] -->|OnVideoFrameUnity, RGBA32| view["VisioForgeVideoView (Texture2D)"];
    rtsp -->|optional record| mp4["MP4Output (H264 + AAC)"];

El núcleo de PlayAsync:

_capture = new VideoCaptureCoreX();

// readInfo:false omite el pre-sondeo del medio (puede fallar bajo el runtime de Unity y añade latencia).
var rtspSettings = await RTSPSourceSettings.CreateAsync(
    new Uri(rtspUrl), login, password, audioEnabled: renderAudio, readInfo: false);
_capture.Video_Source = rtspSettings;

// Fotogramas RGBA32 listos para textura directamente hacia la vista.
_capture.OnVideoFrameUnity += _videoView.OnFrameBuffer;

if (recordToFile)
    _capture.Outputs_Add(new MP4Output(outputPath), autostart: true);

await _capture.StartAsync();

Úselo en su propia escena

Añada un Canvas → Raw Image (GameObject → UI → Raw Image), selecciónelo, Add Component → RTSPViewerPlayer (canalización Media Blocks) o IPCameraXViewer (motor VideoCaptureCoreX), establezca Rtsp Url y pulse ▶ Play. El diseño del RawImage, el manejo del aspecto y el volteo vertical los gestiona el VisioForgeVideoView incluido. Para reproducción de archivos locales en lugar de RTSP, use MediaBlocksPlayer o MediaPlayerXPlayer (consulte Reproducir un archivo multimedia).

Ajustes de build y permisos de red por plataforma

Ambas escenas se ejecutan sin cambios en cada plataforma soportada — pero cada target tiene sus propios requisitos de permisos de red y de Build Profile.

Ajuste Valor
Architecture x86_64
Api Compatibility Level .NET Standard 2.1
Scripting Backend Mono (predeterminado) o IL2CPP

El TCP / UDP saliente al puerto RTSP de la cámara funciona sin declaración especial. Windows Defender Firewall puede preguntar la primera vez que el player vincule un socket UDP — acepta el prompt de red privada. Consulte Compilar para Windows para la lista completa.

Ajuste Valor
Architecture arm64-v8a (desmarca ARMv7)
Api Compatibility Level .NET Standard 2.1
Scripting Backend IL2CPP (obligatorio)
Internet Access Require

AndroidManifest.xml debe declarar:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Para RTSP sobre UDP en una red pública, Android 9+ (API 28+) también requiere android:usesCleartextTraffic="true" en el elemento <application> si la cámara solo es alcanzable vía RTSP / RTP plano sin TLS. Consulte Compilar para Android para la lista completa.

Ajuste Valor
Architecture Universal arm64 + x86_64
Api Compatibility Level .NET Standard 2.1
Scripting Backend Mono (predeterminado) o IL2CPP

No hay entradas de manifiesto adicionales — las conexiones salientes son irrestrictas por defecto. Para distribución por Mac App Store, añada el entitlement com.apple.security.network.client al bundle firmado para que el App Sandbox permita acceso de red saliente. Consulte Compilar para macOS para notas de firma de código y notarización.

Ajuste Valor
Architecture dispositivo arm64 (Simulator no soportado)
Api Compatibility Level .NET Standard 2.1
Scripting Backend IL2CPP (obligatorio)

iOS 14+ bloquea el primer intento de conexión a cualquier dirección de red local hasta que su app declare por qué. Añada a Info.plist:

<key>NSLocalNetworkUsageDescription</key>
<string>Esta app reproduce video de cámaras IP locales en tu red.</string>

Para URLs rtsp:// planas (sin TLS) o http://, añada una excepción de App Transport Security:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

Las URLs públicas https:// / rtsps:// con certificados firmados por CA no necesitan excepción ATS. Consulte Compilar para iOS para el flujo Xcode completo.

Auto-reconexión

Ambos motores se reconectan automáticamente cuando el stream cae, con backoff entre intentos — sin máquina de estado manual en su script. Para RTSPViewer, suba el timeout en los ajustes RTSPSourceSettings subyacentes antes de pasarlos a RTSPSourceBlock si necesita una ventana más larga; IPCameraX (VideoCaptureCoreX) gestiona los reinicios de la cámara y las breves interrupciones de la misma forma.

Preguntas frecuentes

¿Qué escena debería usar — RTSPViewer o IPCameraX?

Use RTSPViewer (MediaBlocksPipeline) para una canalización ligera de solo visualización que monta usted mismo. Use IPCameraX (VideoCaptureCoreX) cuando además quiera grabación a MP4, instantáneas, enrutamiento de audio o superposiciones sobre el mismo stream — vienen listas en el motor de captura.

¿Cómo proporciono las credenciales de la cámara?

Establezca los campos Login y Password en cualquiera de los componentes. Déjelos vacíos para streams que no necesitan autenticación; las credenciales se envían a la cámara, no se incrustan en la URL.

¿Qué formato de URL debo usar?

La forma estándar rtsp://host:port/path que expone su cámara, p. ej. rtsp://192.168.1.21:554/Streaming/Channels/101 (Hikvision) o rtsp://192.168.1.22:554/cam/realmonitor?channel=1&subtype=0 (Dahua). Consulte el manual de su cámara para conocer la ruta exacta del stream.

¿Graba la cámara?

IPCameraX sí — active Record To File para añadir un MP4Output junto a la vista previa. RTSPViewer es solo de visualización; añada usted mismo una rama de grabación a su canalización si la necesita.

¿Qué ocurre si la cámara no tiene audio?

Ambas funcionan solo con video. La rama de audio se conecta únicamente cuando el stream realmente lleva audio, por lo que una cámara solo de video no necesita ningún cambio.

¿Puedo mostrar varias cámaras a la vez?

Sí. Añada un RawImage con su propio RTSPViewerPlayer o IPCameraXViewer para cada cámara; cada uno construye un pipeline independiente.

Véase también