GameInputDevice  - AS3

啟用或停用這個裝置。預設會停用裝置。啟用裝置以存取或取樣它的控制項值。此外，裝置及其個別控制項只會在裝置啟用時傳送事件。

移除裝置時，裝置就會變成停用。您還是可以取得已停用裝置的相關資訊，但是無法存取控制項值或啟動快取。此外，如果裝置已移除，便無法啟用。如果移除裝置，enabled 會永遠傳回 false。

傳回這個裝置的 ID。您可以透過裝置的 ID 來區別裝置。

注意：若是 Android 裝置，裝置製造商會提供裝置 ID。若是 iOS 裝置，ID 可能會在您重新連線裝置時變更。

傳回這個裝置的名稱。名稱有助於識別裝置的類型。

注意：裝置製造商會提供裝置的名稱。

傳回這個裝置中的控制項數目。

指定擷取控制項值的速率 (毫秒)。預設為 0，表示值是每個影格更新一次。設定較高的 sampleValue 會引導 GameInput 以比應用程式影格速率還快的速率取樣控制項值。

雖然值可以更常更新，而非每個影格更新一次，但每個控制項只會傳送一個事件。因此，如果一個影格中的某個值更新了兩次，則只會傳送一個變更事件，並且只能擷取最新的值。

若要擷取不止最新的值，您可以使用這個類別中的快取方法來快取樣本值。當您快取取樣的值時，這個屬性會決定值寫入快取的頻率。

預設值為 0。

將快取的樣本值寫入 ByteArray。快取的樣本值會依照擷取的順序 (最舊的值優先，最新的值最後) 寫入 ByteArray。

這個方法會傳回寫入 ByteArray 之快取樣本值的數目 (而非值本身)。如果 append 參數是 false (預設值)，則寫入樣本值之前會從快取清除 ByteArray。如果 append 為 true，樣本值會附加至 ByteArray，以保留較舊的值。在下列清況附加樣本值：

• 您必須保留特定數目的可用值。
• 您必須保留大於快取的操作記錄。

快取是在樣本值寫入 ByteArray 之後清除的。

如果呼叫這個方法時裝置已停用，則會擲回 IOError。

參數

從裝置擷取特定控制項。

GameInputDevice 會將裝置的控制項儲存在清單中。您可以使用 getControlAt() 方法來存取裝置上的個別控制項。

每當新增或移除裝置時，索引中的控制項順序都會變更。您可以檢查 GameInputControl 物件上的 id 屬性，以比對特定控制項。

即使裝置未啟用，您還是可以取得控制項。不過，您無法讀取已停用裝置中的控制項值。這個功能可讓您先讀取控制項的屬性，然後才啟用所屬的裝置。您可以使用這個功能，在啟用裝置之前，先判斷裝置是否適用於您的應用程式。

參數

要求這個裝置開始保留取樣值的快取。sampleInterval 屬性決定取樣的頻率。numSamples 參數會指定要快取的樣本數。controls 參數會指定要取樣之控制項的 ID 值。

控制項值是依指定的順序來快取。請呼叫 getCachingSamples() 方法來擷取取樣的值。

如果快取取樣的值時所需的記憶體大於 MAX_BUFFER_SIZE 常數中指定的值，則這個方法會擲回 MemoryError。如果呼叫這個方法之前尚未啟用裝置，則會擲回 IOError。

參數

停止樣本快取。雖然仍會傳送控制項上的變更事件，但不會在快取中儲存其他樣本。仍以 sampleInterval 指定的頻率擷取值，但是那些值不會儲存在快取中。因此，您只能擷取最新的值。

指定用來快取取樣之控制項值的緩衝區的大小上限。如果 startCachingSamples 傳回的樣本需要比您指定的記憶體更多，則會擲回記憶體錯誤。