Questa guida descrive come eseguire la migrazione del tuo gioco Unity per utilizzare l'SDK di input più recente. L'SDK 1.0.0-beta presenta miglioramenti sostanziali rispetto alla precedente anteprima 0.0.4. Devi eseguire la migrazione dalle anteprime precedenti il prima possibile. L'SDK 0.0.4 continuerà a funzionare fino a marzo 2023.
Aggiorna riferimenti
Le classi hanno ricevuto il prefisso Play
per evitare conflitti di denominazione con Unity.
Ogni volta che viene visualizzato un messaggio di errore simile al seguente:
errore CS0246: Impossibile trovare il nome del tipo o dello spazio dei nomi "InputMappingProvider" (manca un'istruzione di utilizzo o un riferimento all'assemblaggio?)
devi aggiungere il prefisso Play
al nome della classe. Ad esempio, InputMappingProvider
diventa PlayInputMappingProvider
.
Aggiorna ogni InputAction
InputAction
viene ora creato con una chiamata a PlayInputAction.Create
anziché
con la creazione di un nuovo struct
con campi denominati.
Individua il codice che chiama new InputAction
:
var driveAction = new InputAction
{
ActionLabel = "Drive",
UniqueId = (int)InputEventIds.DRIVE,
InputControls = new InputControls
{
AndroidKeycodes = new[] { AndroidKeyCode.KEYCODE_SPACE }
}
};
Sostituiscilo con una chiamata a PlayInputAction.Create
:
var driveAction = PlayInputAction.Create(
"Drive",
(int)InputEventIds.DRIVE,
PlayInputControls.Create(
new[] { AndroidKeyCode.KEYCODE_SPACE },
null
)
);
Aggiorna ogni gruppo di input
Come InputAction
, ora InputGroup
ha una chiamata PlayInputGroup.Create
anziché compilare manualmente un struct
.
Ciò significa che dovresti individuare le chiamate a new InputGroup
:
var gameInputGroup = new InputGroup
{
GroupLabel = "Game controls",
InputActions = new List<InputAction>
{
driveAction,
turboAction,
openGarageAction,
openStoreAction
}
};
Sostituiscilo con una chiamata a PlayInputGroup.Create
:
var gameInputGroup = PlayInputGroup.Create(
"Game controls",
new List<PlayInputAction>
{
driveAction,
turboAction,
openGarageAction,
openStoreAction
}
);
Aggiorna InputMap
InputMap
utilizza anche PlayInputMap.Create
anziché creare un nuovo struct.
Individua le chiamate a new InputMap
:
return new InputMap
{
InputGroups = new List<InputGroup>
{
gameInputGroup,
menuInputGroup
},
MouseSettings = new MouseSettings
{
AllowMouseSensitivityAdjustment = false,
InvertMouseMovement = false
}
};
Sostituiscilo con una chiamata a PlayInputMap.Create
:
return PlayInputMap.Create(
new List<PlayInputGroup>
{
gameInputGroup,
menuInputGroup
},
PlayMouseSettings.Create(false, false)
);
Rinomina i metodi PlayInputMappingClient
Per PlayInputMappingClient
, RegisterInputMappingProvider
è stato rinominato in
SetInputMappingProvider
.
Quindi individua le chiamate al numero RegisterInputMappingProvider
:
Input.GetInputMappingClient().RegisterInputMappingProvider(_inputMappingProvider);
Sostituiscile con una chiamata al numero SetInputMappingProvider
:
PlayInputMappingClient inputMappingClient =
Google.Play.InputMapping.PlayInput.GetInputMappingClient();
inputMappingClient.SetInputMappingProvider(_inputMapProvider);
Anche UnregisterInputMappingProvider
è stato rinominato come ClearInputMappingProvider
e non richiede più il parametro InputMappingProvider
registrato in precedenza.
Individua le chiamate a UnregisterInputMappingProvider
:
Input.GetInputMappingClient().UnregisterInputMappingProvider(_inputMapProvider);
Sostituiscile con ClearInputMappingProvider
:
PlayInput.GetInputMappingClient().ClearInputMappingProvider();