Virtual Game Controller (VGC) hace que sea simple crear controladores basados en software para juegos y otros fines, lo que le permite controlar fácilmente un dispositivo iOS con otros (o otros dispositivos, como en el caso de un juego de TVOS). El marco envuelve la API GCController Framework de Apple, lo que hace que sea fácil admitir simulatenamente sus propios controladores basados en software y controladores basados en hardware que se ajustan al estándar MFI, con una sola base de código. La API GCController admite tanto leer los valores de los elementos del controlador del juego (encuestas), así como registrarse para llamarse cuando un valor cambia con un controlador basado en bloques. VGC opera de la misma manera y admite todas las características de la API GCController para controladores basados en software y hardware.
Si bien VGC se usa generalmente para que un dispositivo iOS actúe como controlador para otro dispositivo iOS o TVOS, también se puede usar donde dos dispositivos iOS actúan como pares, con un entorno de juego compartido presentado en cada dispositivo. En ese tipo de implementación, las entradas del usuario a través de controles en pantalla fluyen a través del marco y los controladores procesan en ambos dispositivos. VGC admite la creación fácil de tipos de elementos personalizados, incluidas imágenes y tipos de datos, de modo que la lógica del juego, como el estado, se pueda coordinar entre los dos dispositivos. Esta capacidad es perfecta para los juegos de mesa con dos jugadores, incluidos los juegos de Arkit donde quieres que ambos jugadores vean y actúen en un espacio de juego común.
IMPORTANTE : El marco viene con un rico conjunto de aplicaciones de muestra para iOS, TVOS y macOS, incluidos los ejemplos de ScineKit y SprikeKit. Una cantidad considerable de documentación aparece como comentarios en los proyectos de muestra de iOS Perifheral e iOS Central, y usar esos dos proyectos en dispositivos separados es el mejor lugar para comenzar. A continuación, considere probar el ScineKitshipDemo, lo que realmente da una idea de cómo el marco puede mejorar un juego. Si tiene problemas para que los proyectos de muestra funcionen o cualquier otra pregunta, contácteme en [email protected].
VirtualGameController es un reemplazo de entrega para el marco del controlador de juego de Apple, por lo que se puede integrar fácilmente en los juegos existentes basados en el controlador.
VirtualGameController puede ser útil en los siguientes casos:
Los proyectos marco específicos de la plataforma se incluyen en el espacio de trabajo. Un solo archivo de marco admite tanto periféricos (controladores basados en software) como centrales (es decir, su juego).
import VirtualGameController
Tenga en cuenta que actualmente también necesita import GameController
.
Consulte las instrucciones sobre el wiki para utilizar el objetivo C. `` `` ``
El apoyo preliminar está en su lugar para los cocoapods.
Para integrarse con Carthage, agregue VGC a su Cartfile:
github "robreuss/VirtualGameController"
Luego use comandos específicos de la plataforma para crear los productos de compilación que necesita agregar a su proyecto:
carthage update --platform iOS
carthage update --platform OSX
carthage update --platform tvOS
carthage update --platform watchOS
El proyecto incluye un par aplicaciones que implementan la mayoría de las características y configuraciones del marco disponibles, además de proporcionar un entorno de prueba generalmente útil.
Nota: No puede ejecutar más de una aplicación usando simuladores a la vez debido al intercambio de direcciones IP. Ejecute un central o periférico en un simulador y use dispositivos de hardware para interactuar.
El proyecto de muestra Peripheral_iOS
proporciona una implementación de referencia de un controlador de juego basado en software. Una vez que haya implementado VGC en su juego (Central), puede usar la aplicación Peripheral_ios para probarlo:
El proyecto de muestra Central_iOS
proporciona una implementación de referencia de un central (su juego, al que se conectan los periféricos). Proporciona una forma directa de probar su implementación de periféricos:
No dude en ponerse en contacto conmigo con cualquier pregunta utilizando LinkedIn o [email protected].
VirtualGameController es un envoltorio alrededor del marco del controlador de juego de Apple, por lo que trabajar con controladores de hardware con VGC es lo mismo que con el marco del controlador de juego de Apple. Consulte la sección de integración del juego a continuación y los proyectos de muestra para obtener detalles adicionales.
La licencia del MIT (MIT)
Copyright (c) [2018] [Rob Reuss]
El permiso se otorga, de forma gratuita, a cualquier persona que obtenga una copia de este software y archivos de documentación asociados (el "software"), para tratar el software sin restricción, incluidos los derechos de usar, copiar, modificar, modificar, modificar, fusionar , publique, distribuya, sublicence y venda copias del software, y para permitir a las personas a las que se proporciona el software para hacerlo, sujeto a las siguientes condiciones:
El aviso de derechos de autor anterior y este aviso de permiso se incluirán en todas las copias o porciones sustanciales del software.
El software se proporciona "tal cual", sin garantía de ningún tipo, expresa o implícita, incluidas, entre otros, las garantías de comerciabilidad, idoneidad para un propósito particular y no infracción. En ningún caso los autores o titulares de derechos de autor serán responsables de cualquier reclamo, daños u otro responsabilidad, ya sea en una acción de contrato, agravio o de otro tipo, derivado, de o en relación con el software o el uso u otros tratos en el SOFTWARE.
Logotipo desde aquí