GameInputDevice  - AS3

Activa o desactiva este dispositivo. Los dispositivos están desactivados de forma predeterminada. Active un dispositivo para acceder o muestrear sus valores de control. Asimismo, un dispositivo y sus controles individuales distribuyen eventos sólo cuando el dispositivo está activado.

Cuando se elimina un dispositivo, se desactiva. Es posible seguir obteniendo información de dispositivos desactivados, pero no se puede acceder a sus valores de control o iniciar la caché. Asimismo, no es posible activar el dispositivo si ha sido eliminado. Si se elimina un dispositivo, enabled siempre devuelve false.

Devuelve el ID de este dispositivo. Puede diferenciar dispositivos por sus ID.

Nota: Para dispositivos Android, el fabricante del dispositivo proporciona los ID de dispositivo. Para dispositivos iOS, el ID puede cambiar cuando vuelva a conectar el dispositivo.

Devuelve el nombre de este dispositivo. El nombre puede ayudar a identificar el tipo de dispositivo.

Nota: el fabricante del dispositivo facilita los nombres de sus dispositivos.

Devuelve el número de controles de este dispositivo.

Especifica la velocidad (en milisegundos) en que se va a recuperar los valores de control. El valor predeterminado es 0, lo que significa que los valores se actualizan una vez por fotograma. La definición de elemento sampleValue mayor hace que GameInput muestre valores de control a una velocidad más rápida que la velocidad de fotogramas de la aplicación.

Aunque los valores pueden actualizarse con más frecuencia que una vez por fotograma, sólo se distribuye un evento por control. Por ello, si dos actualizaciones de un valor tienen lugar en un fotograma, sólo se distribuye un evento change y sólo se puede recuperar el valor más reciente.

Para recuperar más que el valor más reciente, puede almacenar los valores de muestra en caché mediante los métodos cache de esta clase. Cuando se almacenan en caché los valores muestreados, esta propiedad determina con qué frecuencia se escriben los valores en la memoria caché.

El valor predeterminado es 0.

Escribe valores de muestra de caché en ByteArray. Los valores de muestra en caché se escriben en ByteArray en el orden en el que se recuperaron (los valores más antiguos en primer lugar, los más recientes los últimos).

Este método devuelve el número de valores de muestra en caché escritos en ByteArray (no los valores en sí). Si el parámetro append es false (valor predeterminado), ByteArray se borra antes de que se escriban los valores de muestra desde la memoria caché. Si append es true, los valores de muestra se añaden a ByteArrayconservando los valores antiguos. Añada valores de muestra si:

• Debe mantener un número específico de valores disponibles.
• Se debe mantener un historial más grande que la memoria caché.

La memoria caché se borra después de que los valores de muestra se hayan escrito en ByteArray.

Se emite un error IOError si el dispositivo se desactiva cuando se llama a este método.

Parámetros

Recupera un control específico de un dispositivo.

GameInputDevice almacena los controles en un dispositivo de una lista. Se puede acceder a controles individuales en un dispositivo mediante el método getControlAt().

El orden de control en el índice puede cambiar cada vez que se añade o se elimina un dispositivo. Puede comprobar la propiedad id en un objeto GameInputControl para que coincida con un control específico.

Puede obtener controles incluso si un dispositivo no está activado. Sin embargo, se no pueden leer valores de control desde un dispositivo desactivado. Esta función permite leer las propiedades de un control antes de activar el dispositivo al que pertenezca. Puede utilizar esta capacidad para determinar si un dispositivo es adecuado para la aplicación antes de activar el dispositivo.

Parámetros

Solicita al dispositivo que comience a mantener una caché de los valores de las muestras. La propiedad sampleInterval determina la frecuencia de muestreo. El parámetro numSamples especifica el número de muestras en caché. El parámetro controls especifica los valores de ID de los controles que muestrea.

Los valores de control se guardan en caché en el orden especificado. Puede recuperar los valores muestreados llamando al método getCachingSamples().

Si la memoria necesaria para guardar en caché los valores muestreados es más grande que el valor especificado en la constante MAX_BUFFER_SIZE, este método emite un error MemoryError. Se emite un error IOError si el dispositivo no se ha activado antes de llamar a este método.

Parámetros

Detiene el almacenamiento de muestra en caché. Aunque se siguen distribuyendo eventos change en los controles, no se guardan más muestras en la memoria caché. Los valores se siguen recuperando con la frecuencia especificada por sampleInterval, sin embargo esos valores no se almacenan en la caché. Por lo tanto, sólo se puede recuperar el último valor.

Especifica el tamaño máximo del búfer utilizado para guardar los valores de control muestreados en caché. Si startCachingSamples devuelve muestras que requieren más memoria de la especificada, se emitirá un error de memoria.