Casos de uso de Delphi: un trabajo, una página

Una página de producto te dice qué hace un componente. Una página de referencia te dice cómo se llama cada propiedad. Ninguna de las dos te dice cómo terminar el trabajo por el que te sentaste. Estas páginas sí lo hacen. Cada una lleva una sola tarea desde un formulario vacío hasta código que funciona, nombra la unidad y el componente en cada paso, y declara desde el principio qué producto, qué edición y qué plataformas hacen falta, para que conozcas el coste antes de escribir la primera línea.

Una tarea por página, de principio a fin
Pascal tomado del código que se distribuye
Edición y plataforma declaradas al principio
De Delphi 7 a RAD Studio 13

Qué te da una página de caso de uso

Todas las páginas de esta lista siguen la misma forma, porque las preguntas son siempre las mismas tres, planteadas en el mismo orden.

Un trabajo, no un componente

La página se organiza alrededor del resultado que quieres, así que los componentes aparecen cuando la tarea llega a ellos. Cuando un trabajo abarca varios componentes, están todos aquí, en el orden en que te los encontrarías de verdad. Cuando existen dos caminos, se muestran ambos y se explica el compromiso entre ellos.

Código que puedes pegar

El Pascal sale del código que se distribuye y de los proyectos de demostración incluidos, no de pseudocódigo. Los nombres de unidad aparecen en cada cláusula uses, los manejadores de evento llevan su firma real, y los fallos que cuestan una tarde se señalan donde ocurren, no en una nota al pie.

Cuánto cuesta antes de empezar

Cada página indica arriba el producto, la edición, las versiones del compilador y las plataformas que el trabajo necesita. La mitad de estas funciones está protegida por un {$IFDEF} en sgcVer.inc, así que un método que no se resuelve es una respuesta de licencia, no de sintaxis, y conviene saberlo en la primera página.

Elige el trabajo que estás haciendo

Cada resumen de abajo es lo bastante extenso como para responder por sí solo a la pregunta, de modo que puedas decidir si la página completa merece tus próximos veinte minutos antes de abrirla.

Llamar a un LLM desde Delphi

Envía un prompt desde una aplicación VCL, FMX o de consola y recibe una respuesta, de un modelo alojado como OpenAI o Anthropic Claude, o de un modelo que se ejecuta en tu propia máquina a través de Ollama. Hay dos caminos. TsgcAIChat pone a todos los proveedores detrás de una sola API, así que cambiar de proveedor es una única asignación a Provider, y los clientes dedicados TsgcHTTP_API_OpenAI, TsgcHTTP_API_Anthropic y TsgcHTTP_API_Ollama exponen por completo la API de cada proveedor cuando necesitas entrada de visión, lotes, embeddings o transcripción.

La página cubre después las tres cosas con las que se topa todo proyecto justo a continuación. El streaming, para que el texto aparezca en el memo mientras el modelo sigue escribiendo, tanto en el nivel del delta decodificado como en el del evento en bruto. La llamada a herramientas, donde describes una función Pascal como JSON Schema y el modelo te pide que la ejecutes. Y la decisión entre un modelo alojado y uno local, que para cualquier cosa cubierta por un acuerdo de tratamiento de datos es una decisión de cumplimiento normativo más que de rendimiento.

Requiere: sgcWebSockets Enterprise o el paquete independiente sgcAI. Los clientes REST compilan en Windows, macOS, Linux, iOS y Android; TsgcAIChat es solo para Windows, así que la página muestra los dos caminos.

Leer la guía →

Iniciar la sesión de una persona con OAuth2 y PKCE

El flujo Authorization Code con PKCE, que es el flujo que hoy espera cualquier proveedor de una aplicación de escritorio nativa, gobernado por un solo componente no visual. Sin navegador incrustado, sin un servidor web propio, sin framework REST. TsgcHTTP_OAuth2_Client genera el verifier, deriva el challenge, abre el navegador del sistema, escucha en una redirección de loopback, canjea el code y dispara OnAfterAccessToken con el token.

En el escritorio, donde el flujo se tuerce es en la redirección, así que la página le dedica tiempo de verdad: por qué la redirección es una dirección de loopback y no una URL pública, qué hay que registrar en el proveedor, y qué te está diciendo redirect_uri_mismatch. Después cubre los refresh tokens, para que el navegador no se abra una segunda vez, cómo guardar una credencial sin dejarla a la vista, los componentes de Google y Microsoft ya preparados, y el traspaso XOAUTH2 que Gmail y Microsoft 365 exigen ahora sobre SMTP e IMAP.

Requiere: sgcWebSockets Standard y superiores, o el paquete independiente sgcAuth. Windows, macOS, Linux, iOS y Android. Solo la mitad servidor de autorización es una función Enterprise.

Leer la guía →

Conectar dos aplicaciones entre pares con WebRTC

Dos aplicaciones en dos redes distintas, que intercambian un canal de chat, un flujo de micrófono y un flujo de cámara directamente entre ellas, sin servidor de medios en medio y sin navegador incrustado en el proceso. La página divide WebRTC en los cuatro problemas que realmente es: describir la sesión como oferta y respuesta SDP, llevar esa descripción al otro lado, encontrar un camino a través de los NAT y mover los bytes.

La señalización es la parte que escribes tú, así que está aquí entera, como un relay elemental sobre TsgcWebSocketServer con tres tipos de mensaje. Después la conexión entre pares y sus eventos, los candidatos ICE y lo que te cuesta cada uno de los candidatos host, server reflexive y relay, el interruptor TURN que todo el mundo olvida, los canales de datos SCTP con fiabilidad por canal, y las pistas de audio y vídeo, que son un transporte distinto y con modos de fallo distintos a los de un canal de datos. Cierra con los fallos que no producen ningún error, que es lo que hace difícil depurar el intercambio entre pares.

Requiere: la conexión entre pares y los clientes ICE y TURN vienen con sgcWebSockets Enterprise. Los métodos de oferta y respuesta, los canales de datos y las pistas de medios necesitan el paquete sgcWebRTC por encima de Enterprise, que también está incluido en All-Access. Un cliente STUN llega con Standard.

Leer la guía →

Se están redactando más trabajos. Si el que estás haciendo todavía no está aquí, el blog cubre buena parte del mismo terreno artículo por artículo, y el soporte te señalará mientras tanto el proyecto de demostración adecuado.

Producto, edición y plataforma de un vistazo

La misma información que cada página declara en su sección de apertura, reunida para que compares el coste de tres trabajos sin abrir tres pestañas.

Guía Componentes principales Producto y edición Plataformas
Llamar a un LLM desde Delphi TsgcAIChat, TsgcHTTP_API_OpenAI, TsgcHTTP_API_Anthropic, TsgcHTTP_API_Ollama sgcWebSockets Enterprise, o el paquete independiente sgcAI Clientes REST en Windows, macOS, Linux, iOS y Android. TsgcAIChat en Windows.
Login OAuth2 con PKCE TsgcHTTP_OAuth2_Client, más los envoltorios de Google y Microsoft sgcWebSockets Standard y superiores, o el paquete independiente sgcAuth Windows, macOS, Linux, iOS y Android
WebRTC entre dos aplicaciones TsgcRTCPeerConnection, TsgcICEClient, TsgcTURNClient, TsgcWebSocketServer sgcWebSockets Enterprise para la conexión entre pares, más el paquete sgcWebRTC para oferta y respuesta, canales de datos y medios. Los dos están en All-Access. Windows para la captura y el renderizado. El transporte en sí es multiplataforma.

Cada afirmación sobre ediciones de aquí arriba es la que aplica el sgcVer.inc que se distribuye. El desglose completo está en la matriz de funciones de Delphi, y la página qué edición recorre la misma decisión desde el otro extremo.

Si no era una guía de tareas lo que querías

Estas páginas responden a las preguntas vecinas: qué hace un componente, cómo se llama, cómo se compara y cuánto cuesta.

sgcWebSockets La biblioteca que hay detrás de cada guía de esta página, desde WebSocket y HTTP/2 hasta MQTT, AMQP, WebRTC y los clientes de IA.
Comparativa de bibliotecas ¿Todavía estás eligiendo biblioteca en lugar de escribir código? El hub de comparativas pone sgcWebSockets junto a Indy, ICS, TMS, mORMot 2, IPWorks y Chilkat.
Referencia de componentes Todos los componentes de la biblioteca, con las propiedades, métodos y eventos que publica cada uno, y un documento técnico detrás.
Glosario Los términos de protocolo, criptografía y autenticación que usan estas guías, cada uno enlazado con el RFC que lo define.
Blog Varios cientos de artículos con ejemplos, incluidas las publicaciones de versión en las que se apoya cada una de estas guías.
Ediciones y precios Qué incluye cada una de Standard, Professional, Enterprise y All-Access, y dónde encajan los paquetes independientes.

Todas las guías empiezan por la misma descarga

La prueba es la biblioteca entera con todos los componentes activados, y los proyectos de demostración a los que se refiere cada guía vienen dentro.