Guía de Instalación de SDKs .NET de VisioForge¶
Video Capture SDK .Net Video Edit SDK .Net Media Blocks SDK .Net Media Player SDK .Net
VisioForge ofrece potentes SDKs multimedia para desarrolladores .NET que permiten capacidades avanzadas de captura, edición, reproducción y procesamiento de medios en tus aplicaciones. Esta guía cubre todo lo que necesitas saber para instalar y configurar correctamente nuestros SDKs en tu entorno de desarrollo.
SDKs .NET Disponibles¶
VisioForge proporciona varios SDKs especializados para abordar diferentes necesidades multimedia:
- Video Capture SDK .Net - Para capturar video de cámaras, grabación de pantalla y streaming
- Video Edit SDK .Net - Para edición de video, procesamiento y conversión de formato
- Media Blocks SDK .Net - Para construir pipelines de procesamiento de medios personalizados
- Media Player SDK .Net - Para crear reproductores de medios personalizados con características avanzadas
Métodos de Instalación¶
Puedes instalar nuestros SDKs usando dos métodos principales:
Usando Archivos de Instalación¶
El método de instalación con archivo de configuración se recomienda para entornos de desarrollo Windows. Este enfoque:
- Instala automáticamente todas las dependencias requeridas
- Configura la integración con Visual Studio
- Incluye proyectos de ejemplo para ayudarte a comenzar rápidamente
- Proporciona documentación y recursos adicionales
Los archivos de instalación pueden descargarse desde las páginas de productos SDK respectivas en nuestro sitio web.
Usando Paquetes NuGet¶
Para desarrollo multiplataforma o pipelines de CI/CD, nuestros paquetes NuGet ofrecen flexibilidad y fácil integración:
Pueden requerirse paquetes adicionales específicos de UI dependiendo de tu plataforma objetivo:
Install-Package VisioForge.DotNet.Core.UI.MAUI
Install-Package VisioForge.DotNet.Core.UI.WinUI
Install-Package VisioForge.DotNet.Core.UI.Avalonia
Integración y Configuración del IDE¶
Nuestros SDKs se integran perfectamente con entornos de desarrollo .NET populares:
Integración con Visual Studio¶
Visual Studio ofrece la experiencia más completa con nuestros SDKs:
- Soporte completo de IntelliSense para componentes del SDK
- Depuración integrada para componentes de procesamiento de medios
- Soporte de diseñador para controles visuales
- Gestión de paquetes NuGet
Para instrucciones detalladas de configuración de Visual Studio, consulta nuestra guía de integración de Visual Studio.
Integración con JetBrains Rider¶
Rider proporciona excelente soporte de desarrollo multiplataforma:
- Completado de código completo para APIs del SDK
- Características de navegación inteligente para explorar clases del SDK
- Gestión integrada de paquetes NuGet
- Capacidades de depuración multiplataforma
Para instrucciones específicas de Rider, visita nuestra documentación de integración de Rider.
Visual Studio para Mac¶
Los usuarios de Visual Studio para Mac pueden desarrollar aplicaciones para macOS, iOS y Android:
- Gestor de paquetes NuGet integrado para instalar componentes del SDK
- Plantillas de proyecto para configuración rápida
- Herramientas de depuración integradas
Aprende más en nuestra guía de configuración de Visual Studio para Mac.
Configuración Específica de Plataforma¶
Configuración del Framework Objetivo¶
Cada sistema operativo requiere configuraciones específicas de framework objetivo para compatibilidad óptima:
Aplicaciones Windows¶
Las aplicaciones Windows deben usar el sufijo de framework objetivo -windows:
Esto permite acceso a APIs específicas de Windows y frameworks de UI como WPF y Windows Forms.
Desarrollo Android¶
Los proyectos Android requieren el sufijo de framework -android:
Asegúrate de que las cargas de trabajo de Android estén instaladas en tu entorno de desarrollo:
Desarrollo iOS¶
Las aplicaciones iOS deben usar el framework objetivo -ios:
El desarrollo iOS requiere un Mac con Xcode instalado, incluso cuando se usa Visual Studio en Windows.
Aplicaciones macOS¶
Las aplicaciones nativas de macOS usan el framework -macos o -maccatalyst:
Para aplicaciones .NET MAUI dirigidas a macOS, usa:
Desarrollo Linux¶
Las aplicaciones Linux usan el framework objetivo estándar sin sufijo de plataforma:
Asegúrate de que las cargas de trabajo .NET requeridas estén instaladas:
Soporte de Frameworks Especiales¶
Aplicaciones .NET MAUI¶
Los proyectos MAUI requieren configuración especial:
- Agregar el paquete NuGet
VisioForge.DotNet.Core.UI.MAUI - Configurar permisos específicos de plataforma en tu proyecto
- Usar controles de vista de video específicos de MAUI
Consulta nuestra guía detallada de MAUI para instrucciones completas.
Framework Avalonia UI¶
Los proyectos Avalonia proporcionan una alternativa de UI multiplataforma:
- Instalar el paquete
VisioForge.DotNet.Core.UI.Avalonia - Usar controles de renderizado de video específicos de Avalonia
- Configurar dependencias específicas de plataforma
Nuestra guía de integración de Avalonia proporciona instrucciones de configuración completas.
Inicialización del SDK para Motores Multiplataforma¶
Nuestros SDKs incluyen tanto motores DirectShow específicos de Windows (como VideoCaptureCore) como motores X multiplataforma (como VideoCaptureCoreX). Los motores X requieren inicialización y limpieza explícitas.
Inicializando el SDK¶
Antes de usar cualquier componente de motor X, inicializa el SDK:
// Inicializar al inicio de la aplicación
VisioForge.Core.VisioForgeX.InitSDK();
// O usar la versión async
await VisioForge.Core.VisioForgeX.InitSDKAsync();
Limpiando Recursos¶
Cuando tu aplicación termine, libera correctamente los recursos:
// Limpiar al salir de la aplicación
VisioForge.Core.VisioForgeX.DestroySDK();
// O usar la versión async
await VisioForge.Core.VisioForgeX.DestroySDKAsync();
No inicializar o limpiar correctamente puede resultar en fugas de memoria o comportamiento inestable.
Controles de Renderizado de Video¶
Cada framework de UI requiere controles de vista de video específicos para mostrar contenido multimedia:
Windows Forms¶
// Agregar referencia a VisioForge.DotNet.Core
using VisioForge.Core.UI.WinForms;
// En tu formulario
videoView = new VideoView();
this.Controls.Add(videoView);
Aplicaciones WPF¶
// Agregar referencia a VisioForge.DotNet.Core
using VisioForge.Core.UI.WPF;
// En tu XAML
<vf:VideoView x:Name="videoView" />
Aplicaciones MAUI¶
// Agregar referencia a VisioForge.DotNet.Core.UI.MAUI
using VisioForge.Core.UI.MAUI;
// En tu XAML
<vf:VideoView x:Name="videoView" />
Avalonia UI¶
// Agregar referencia a VisioForge.DotNet.Core.UI.Avalonia
using VisioForge.Core.UI.Avalonia;
// En tu XAML
<vf:VideoView Name="videoView" />
Gestión de Dependencias Nativas¶
Nuestros SDKs aprovechan bibliotecas nativas para rendimiento óptimo. Estas dependencias deben gestionarse correctamente para el despliegue:
- Windows: Incluidas automáticamente con la instalación de configuración o paquetes NuGet
- macOS/iOS: Empaquetadas con paquetes NuGet pero requieren firma de app adecuada
- Android: Incluidas en paquetes NuGet con soporte de arquitectura apropiado
- Linux: Pueden requerir paquetes de sistema adicionales dependiendo de la distribución
Para instrucciones detalladas de despliegue, consulta nuestra guía de despliegue.
Solución de Problemas Comunes de Instalación¶
Si encuentras problemas durante la instalación:
- Verifica la compatibilidad del framework objetivo con tu tipo de proyecto
- Asegúrate de que todas las cargas de trabajo requeridas estén instaladas (
dotnet workload list) - Verifica conflictos de dependencias en tu proyecto
- Confirma la inicialización adecuada del SDK para motores X
- Revisa los requisitos específicos de plataforma en nuestra documentación
Código de Ejemplo y Recursos¶
Mantenemos una extensa colección de aplicaciones de ejemplo en nuestro repositorio de GitHub para ayudarte a comenzar rápidamente con nuestros SDKs.
Estos ejemplos cubren escenarios comunes como:
- Captura de video de cámaras y pantallas
- Reproducción de medios con controles personalizados
- Edición y procesamiento de video
- Desarrollo multiplataforma
Visita nuestro repositorio para los últimos ejemplos de código y mejores prácticas para usar nuestros SDKs.
Para soporte adicional o preguntas, por favor contacta a nuestro equipo de soporte técnico o visita nuestro portal de documentación.