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¶
- En la ventana Project abra
Assets/Scenes/RTSPViewer.unity(haga doble clic en ella). - En la Hierarchy seleccione el GameObject RawImage. El componente
RTSPViewerPlayerestá adjunto a él. - En el Inspector, establezca Rtsp Url (y Login / Password si la cámara requiere autenticación).
- Pulse ▶ Play — el stream se renderiza en la vista Game.


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¶
- En la ventana Project abra
Assets/Scenes/SampleScene.unity. - En la Hierarchy seleccione el GameObject RawImage — el componente
IPCameraXViewerestá adjunto a él. - En el Inspector establezca Rtsp Url (y Login / Password si la cámara los necesita).
- 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¶
- Usar VisioForge en Unity — visión general del paquete, configuración y cómo funciona el renderizado
- Reproducir un archivo multimedia en Unity — las escenas de reproducción de archivos locales / URL
- Capturar una webcam en Unity — captura de cámara local (Windows / macOS)
- Guía de streaming RTSP — RTSP en los SDKs .NET de VisioForge
- Directorio de marcas de cámaras IP — URLs y ajustes de cámaras probadas
- Reproductor RTSP de Media Blocks en C# — un ejemplo RTSP fuera de Unity