GameInputDevice  - AS3

Aktiverar eller inaktiverar den här enheten. Enheter är som standard inaktiverade. Aktivera en enhet för att få åtkomst till kontrollvärden eller sampel. En enhet och dess enskilda kontroller skickar händelser endast när enheten är aktiverad.

När en enhet tas bort kommer den att inaktiveras. Du kan fortfarande få information om den inaktiverade enheten, men du har inte åtkomst till kontrollvärden och du kan inte heller starta cache-lagring. Du kan dessutom inte aktivera enheten om den tagits bort. Om en enhet är bortagen kommer enabled alltid att returnera false.

Returnerar ID för den här enheten. Du kan skilja på olika enheter med hjälp av deras ID.

Obs! Enhetstillverkaren tillhandahåller enhetens ID:n på Android-enheter. ID för iOS-enheter kan ändras när du ansluter enheten igen.

Returnerar namnet för den här enheten. Namnet kan hjälpa dig att identifiera enhetstypen.

Obs! Det är enhetstillverkarna som ger enheterna ett namn.

Returnerar antalet kontroller på den här enheten.

Anger med vilken hastighet (i millisekunder) som kontrollvärden hämtas. Standard är 0, vilket betyder att värden uppdateras en gång per bildruta. Om du anger ett högre värde för sampleValue kommer GameInput att sampla kontrollvärden med en snabbare hastighet än programmets bildrutefrekvens.

Trots att värden kan uppdateras snabbare än en gång per bildruta, kan endast en händelse per kontroll skickas. Detta innebär att om två uppdateringar av ett värde inträffar för en bildruta, kommer endast en ändringshändelse att skickas och endast det senaste värdet kan hämtas.

Om du vill hämta fler värden än bara det senaste, kan du cache-lagra sampelvärden med hjälp av cache-lagringsmetoderna i den här klassen. När du cache-lagrar sampelvärden bestäms med den här egenskapen hur ofta värdena skrivs i cache-minnet.

Standardvärdet är 0.

Skriver cache-lagrade samplingsvärden till ByteArray. De cache-lagrade samplingsvärdena skrivs till ByteArray i den ordning de hämtades (de äldsta först och de senaste sist).

Denna metod returnerar antalet cache-lagrade samplingsvärden som skrivs till ByteArray (inte själva värdena). Om parametern append är false (standard), kommer ByteArray att rensas innan samplingsvärdena skrivs från cache-minnet. Om append är true, kommer samplingsvärdena att läggas till ByteArray och de äldre värdena behålls. Lägg till samplingsvärden om:

• Du måste ha ett specifikt antal värden tillgängliga.
• Du måste ha en historik som är större än cache-minnet.

Cache-minnet rensas efter det att samplingsvärden har skrivits till ByteArray.

Ett IOError-fel returneras om enheten inaktiveras när den här metoden anropas.

Parametrar

Hämtar en specifik kontroll från en enhet.

GameInputDevice lagrar kontroller på en enhet i en lista. Du kan komma åt de enskilda kontrollerna på en enhet med hjälp av metoden getControlAt().

Ordningen för kontrollerna i indexet kan förändras när en enhet läggs till eller tas bort. Du kan kontrollera egenskapen id i ett GameInputControl-objekt för att matcha en särskild kontroll.

Du kan hämta kontroller även om en enhet inte är aktiverad. Du kan emellertid inte läsa kontrollvärden i en inaktiverad enhet. Den här funktionen gör det möjligt att läsa en kontrolls egenskaper innan du aktiverar enheten som kontrollen tillhör. Du använder den här möjligheten för att bestämma om en enhet är lämplig för ditt program innan du aktiverar enheten.

Parametrar

Begär att en enhet ska börja behålla cache-lagrade samplingsvärden. Egenskapen sampleInterval bestämmer samplingsfrekvensen. Parametern numSamples anger antalet sampel som ska cache-lagras. Parametern controls anger ID-värdena för kontrollerna som samplas.

Kontrollvärden cache-lagras i den angivna ordningen. Du hämtar de samplade värdena genom att anropa metoden getCachingSamples.

Om minnet som krävs för att cache-lagra värdena är större än det värde som angetts i konstanten MAX_BUFFER_SIZE i den här klassen, returnerar metoden ett MemoryError-fel. Ett IOError-fel returneras om enheten inte har aktiverats innan den här metoden anropas.

Parametrar

Stoppar cache-lagring av sampel. Trots att ändringshändelser på kontroller fortfarande skickas, kommer inga fler sampel att lagras i cache-minnet. Värden hämtas fortfarande i den takt som anges i sampleInterval, men dessa värden lagras inte i cache-minnet. Därför kan du bara hämta de senaste värdena.

Anger den största storleken på bufferten som används för att cache-lagra samplade kontrollvärden. Du kommer att få ett minnesfel om startCachingSamples returnerar sampel som kräver mer minne än vad du anger.