Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: AIR 30.0 y versiones anteriores, Flash Player 30.0 y versiones anteriores, Flash Lite 4
Flex 4.6 y versiones anteriores, Flash Pro CS6 y versiones anteriores
Ocultar filtros
flash.ui 

GameInputDevice  - AS3

Paquetesx

Nivel superior
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Elementos del lenguaje

Constantes globales
Funciones globales
Operadores
Sentencias, palabras clave y directivas
Tipos especiales

Apéndices

Novedades
Errores del compilador
Advertencias del compilador
Errores en tiempo de ejecución
Migración a ActionScript 3
Conjuntos de caracteres admitidos
Solo etiquetas MXML
Elementos Motion XML
Etiquetas de texto temporizado
Lista de elementos desfasados
Constantes de implementación de accesibilidad
Cómo utilizar ejemplos de ActionScript
Avisos legales
Paqueteflash.ui
Clasepublic final class GameInputDevice
HerenciaGameInputDevice Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

La clase GameInputDevice representa un solo dispositivo de entrada utilizado habitualmente para juegos.

Esta clase incluye métodos y propiedades que se pueden utilizar para:

  • Active o desactive un dispositivo de entrada. Inicialmente, los dispositivos están desactivados de forma predeterminada (enabled es false). Debe activar de forma explícita un dispositivo, estableciendo enabled como true, para poder obtener los valores de control desde el dispositivo.
  • Obtiene el nombre y el identificador de un dispositivo de entrada. Las propiedades name e id juntas identifican de forma exclusiva un dispositivo. Para dispositivos Android, el fabricante del dispositivo suministra estos valores. Para dispositivos iOS, el ID puede cambiar cada vez que conecte el dispositivo.
  • Enumera los controles en un dispositivo de entrada. Los controles físicos en un dispositivo se asignan a objetos GameInputControl lógicos y se almacenan en una lista. Se puede acceder a un control en la lista con el método getControlAt().
  • Administra el almacenamiento en caché de valores muestreados del control. Tomar muestras de un conjunto de valores de controles directamente de un objeto del dispositivo es una de las tres formas para obtener los valores del control. (Las otras dos formas, descritas en la sección correspondiente, recurren al método value en la clase GameInputControl.) El almacenamiento en caché de las muestras resulta útil cuando se necesita acceder a valores del control a una velocidad superior que la velocidad de fotogramas de una aplicación.

Siempre configure un detector en esta clase para el evento GameInputEvent.DEVICE_REMOVED. Este detector permite gestionar el caso de un dispositivo que se desconecta o se apaga de forma inesperada. Cuando desconecte un dispositivo, libere su objeto GameInputDevice, ya que el objeto no es válido después de desconectar su dispositivo asociado.

Un dispositivo Android que se elimina y luego se vuelve a conectar conserva el ID que tenía cuando se conectó por primera vez. Puede volver a conectar lógicamente a un dispositivo haciendo coincidir su ID. Para dispositivos iOS, el ID puede cambiar cuando vuelva a conectar el dispositivo.

Nota: No se puede depender del orden de dispositivos en la lista. (El orden se puede alterar al añadir y eliminar dispositivos).

Para obtener más información, consulte el artículo del Centro de desarrolladores de Adobe Air:Controladores de juego en Adobe AIR.

Para Android, esta función es compatible con una versión del SO Android mínima de 4.1 y requiere la versión de SWF mínima de 20 y espacio de nombre 3.7. Para iOS, esta función es compatible con una versión mínima de iOS 9.0 y requiere la versión de SWF mínima de 34 y espacio de nombre 23.0.

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
      enabled : Boolean
Activa o desactiva este dispositivo.
GameInputDevice
      id : String
[solo lectura] Devuelve el ID de este dispositivo.
GameInputDevice
      name : String
[solo lectura] Devuelve el nombre de este dispositivo.
GameInputDevice
      numControls : int
[solo lectura] Devuelve el número de controles de este dispositivo.
GameInputDevice
      sampleInterval : int
Especifica la velocidad (en milisegundos) en que se va a recuperar los valores de control.
GameInputDevice
Métodos públicos
 MétodoDefinido por
  
    getCachedSamples(data:ByteArray, append:Boolean = false):int
Escribe valores de muestra de caché en ByteArray.
GameInputDevice
  
Recupera un control específico de un dispositivo.
GameInputDevice
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
  
    startCachingSamples(numSamples:int, controls:Vector.<String>):void
Solicita al dispositivo que comience a mantener una caché de los valores de las muestras.
GameInputDevice
  
Detiene el almacenamiento de muestra en caché.
GameInputDevice
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
      MAX_BUFFER_SIZE : int = 32000
[estática] Especifica el tamaño máximo del búfer utilizado para guardar los valores de control muestreados en caché.
GameInputDevice
Información sobre propiedades
    

enabled

propiedad
enabled:Boolean

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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.



Implementación
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
    

id

propiedad 
id:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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.



Implementación
    public function get id():String
    

name

propiedad 
name:String  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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.



Implementación
    public function get name():String
    

numControls

propiedad 
numControls:int  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

Devuelve el número de controles de este dispositivo.



Implementación
    public function get numControls():int
    

sampleInterval

propiedad 
sampleInterval:int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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.



Implementación
    public function get sampleInterval():int
    public function set sampleInterval(value:int):void

Emite
IOError — Cuando se desactiva el dispositivo durante la definición de esta propiedad.
 
RangeError — Cuando sampleInterval es menor que 0.
Información sobre métodos

    getCachedSamples

()método
public function getCachedSamples(data:ByteArray, append:Boolean = false):int

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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é.
Importante: Si append es true, la aplicación es responsable de para borrar ByteArray. Si ByteArray no se borra, sigue creciendo y potencialmente podría hacer fallar la aplicación.

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

data:ByteArray — El ByteArray que contiene los datos recuperados. Se rellena con valores de muestra escritos como valores dobles. El objeto ByteArray contiene NaN como el valor de un control en caso de que no se detecte ningún cambio en la posición del control.
 
append:Boolean (default = false) — Un indicador que determina el modo en el que se escriben los datos en ByteArray. Si es true, los valores muestreados se escriben al final del conjunto. Si es false, el contenido de ByteArray se elimina y, a continuación, los datos se escriben en el conjunto. El valor predeterminado es false.

Valor devuelto
int — El número de muestras (no valores) escritos en ByteArray.

Emite
ArgumentError — Cuando data es null.
 
IOError — Cuando se llama a este método y el dispositivo está desactivado.

    getControlAt

()método 
public function getControlAt(i:int):GameInputControl

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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

i:int — La posición del índice del GameInputControl en la lista de GameInputControls.

Valor devuelto
GameInputControl — El objeto GameInputControl en la posición del índice especificada.

Emite
RangeError — Cuando el índice es menor que cero o mayor que (numControls - 1).

    startCachingSamples

()método 
public function startCachingSamples(numSamples:int, controls:Vector.<String>):void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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

numSamples:int — El número de muestras que se almacenan en la memoria caché. Cuando se recuperan muestras siempre son menor o igual que numSamples.
 
controls:Vector.<String> — Un vector de String. Cada String es un ID de un control. Las muestras se escriben en el mismo orden que proporciona este vector.


Emite
RangeError — Cuando numSamples es menor o igual que cero, o cuando una entrada en controls es menor que cero o mayor que (numControls - 1).
 
ArgumentError — Cuando el control es null o no contiene al menos una entrada o contiene entradas no válidas.
 
IOError — Cuando se llama a este método en un dispositivo desactivado.
 
MemoryError — Cuando el tamaño de la caché (número de valores * muestras) es más grande que MAX_BUFFER_SIZE.

    stopCachingSamples

()método 
public function stopCachingSamples():void

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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.


Emite
IOError — Cuando se llama a este método sin activar el dispositivo primero.
Información sobre constantes
    

MAX_BUFFER_SIZE

Constante
public static const MAX_BUFFER_SIZE:int = 32000

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 3.7

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.





[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.