遷移至 1.0.0 Beta Input SDK

本指南會說明如何將您的 Unity 遊戲遷移至最新版的遊戲 Input SDK。與先前的 0.0.4 預先發布版相較，1.0.0 Beta SDK 在功能上有非常實質的改進。您應儘快從先前的預先發布版遷移至新版。「0.0.4」SDK 可持續使用至 2023 年 3 月。

更新參考資料

接收 Play 前置字串，以便避免和 Unity 產生命名衝突的類別。 如果您看到類似以下錯誤訊息的內容：

錯誤 CS0246：類型或命名空間名稱「InputMappingProvider」不可 發現 (您遺漏了使用指令或組件參照？)

您必須為類別名稱加上 Play 前置字串。例如： InputMappingProvider 會變為 PlayInputMappingProvider。

更新各 InputAction

InputAction 現在是透過呼叫 PlayInputAction.Create 的方式建構 以使用已命名欄位建立新的 struct。

找出所有呼叫 new InputAction 的程式碼：

var driveAction = new InputAction
{
    ActionLabel = "Drive",
    UniqueId = (int)InputEventIds.DRIVE,
    InputControls = new InputControls
    {
        AndroidKeycodes = new[] { AndroidKeyCode.KEYCODE_SPACE }
    }
};

並替換為呼叫 PlayInputAction.Create：

var driveAction = PlayInputAction.Create(
    "Drive",
    (int)InputEventIds.DRIVE,
    PlayInputControls.Create(
        new[] { AndroidKeyCode.KEYCODE_SPACE },
        null
    )
);

更新各 InputGroup

和 InputAction 一樣，InputGroup 現在以 PlayInputGroup.Create 呼叫的方式進行呼叫 不必手動填寫 struct

因此您應該找到所有呼叫 new InputGroup 的內容：

var gameInputGroup = new InputGroup
{
    GroupLabel = "Game controls",
    InputActions = new List<InputAction>
    {
        driveAction,
        turboAction,
        openGarageAction,
        openStoreAction
    }
};

並替換為呼叫 PlayInputGroup.Create：

var gameInputGroup = PlayInputGroup.Create(
    "Game controls",
    new List<PlayInputAction>
    {
        driveAction,
        turboAction,
        openGarageAction,
        openStoreAction
    }
);

更新 InputMap

InputMap 也使用 PlayInputMap.Create，不會建構新的 結構體

找到所有呼叫 new InputMap 的內容：

return new InputMap
{
    InputGroups = new List<InputGroup>
    {
        gameInputGroup,
        menuInputGroup
    },
    MouseSettings = new MouseSettings
    {
        AllowMouseSensitivityAdjustment = false,
        InvertMouseMovement = false
    }
};

並替換為呼叫 PlayInputMap.Create：

return PlayInputMap.Create(
    new List<PlayInputGroup>
    {
        gameInputGroup,
        menuInputGroup
    },
    PlayMouseSettings.Create(false, false)
);

重新命名 PlayInputMappingClient 方法

PlayInputMappingClient 的「RegisterInputMappingProvider」已重新命名為 SetInputMappingProvider。

因此，請找出所有呼叫 RegisterInputMappingProvider 的內容：

Input.GetInputMappingClient().RegisterInputMappingProvider(_inputMappingProvider);

並替換為呼叫 SetInputMappingProvider：

PlayInputMappingClient inputMappingClient =
    Google.Play.InputMapping.PlayInput.GetInputMappingClient();
inputMappingClient.SetInputMappingProvider(_inputMapProvider);

UnregisterInputMappingProvider 也已經重新命名為 ClearInputMappingProvider，且不再需要使用先前註冊的 InputMappingProvider 做為參數。

找到所有呼叫 UnregisterInputMappingProvider 的內容：

Input.GetInputMappingClient().UnregisterInputMappingProvider(_inputMapProvider);

並取代為 ClearInputMappingProvider：

PlayInput.GetInputMappingClient().ClearInputMappingProvider();