Przejdź na pakiet SDK do wprowadzania danych w wersji 1.0.0 w wersji beta

Z tego przewodnika dowiesz się, jak przenieść grę, aby korzystała z najnowszego pakietu Input SDK. Pakiet SDK w wersji 1.0.0-beta zawiera znaczące ulepszenia w porównaniu z poprzednią wersją przedpremierową 0.0.4. Jak najszybciej przenieś grę z wcześniejszych wersji przedpremierowych. Pakiet SDK w wersji 0.0.4 będzie działać do marca 2023 r.

Zaktualizuj zależność

Usuń bibliotekę w wersji 0.0.4 z katalogu libs, ponieważ jest ona teraz dostępna w Maven. Następnie znajdź ten wiersz w pliku build.grade na poziomie modułu:

implementation files('libs/inputmapping-0.0.4.aar')

Zastąp go tym kodem:

implementation 'com.google.android.libraries.play.games:inputmapping:1.0.0-beta'

Zaimplementuj nowy interfejs InputMappingProvider

W wersji 1.0.0-beta poprzednia klasa abstrakcyjna InputMappingProvider została przekształcona w interfejs. Metoda onProvideInputMap() nadal jest częścią interfejsu.

Kotlin

Usuń () z definicji klasy, ponieważ w InputMappingProvider nie ma konstruktora do wywołania.

Znajdź implementację InputMappingProvider:

class MyInputMapProvider : InputMappingProvider() {
    override fun onProvideInputMap(): InputMap {
        TODO("Not yet implemented")
    }
}

I zaktualizuj ją do tej postaci:

class MyInputMapProvider : InputMappingProvider {
    override fun onProvideInputMap(): InputMap {
        TODO("Not yet implemented")
    }
}

Java

Zastąp extends ciągiem implements, aby wskazać, że implementujesz interfejs, a nie rozszerzasz klasę.

Znajdź miejsce, w którym rozszerzasz InputMappingProvider:

public class MyInputMapProvider extends InputMappingProvider {
    @NonNull
    @Override
    public InputMap onProvideInputMap() {
        // TODO: return an InputMap
    }
}

I zmień je tak, aby implementowało InputMappingProvider:

public class MyInputMapProvider implements InputMappingProvider {
    @NonNull
    @Override
    public InputMap onProvideInputMap() {
        // TODO: return an InputMap
    }
}

Użyj nowego InputClient

registerInputMappingProvider i unregisterInputMappingProvider zostały zastąpione przez setInputMappingProvider i clearInputMappingProvider. Ponadto funkcja clearInputMappingProvider nie przyjmuje już argumentu, więc nie musisz już przechowywać odniesienia do dostawcy, aby później go wyrejestrować.

Kotlin

Aby zarejestrować dostawcę mapy wejściowej, znajdź wywołanie funkcji registerInputMappingProvider:

private val myInputMapProvider by lazy {
    MyInputMapProvider()
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val inputMappingClient = Input.getInputMappingClient(this)
    inputMappingClient.registerInputMappingProvider(myInputMapProvider)
}

I zastąp je funkcją setInputMappingProvider:

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    val inputMappingClient = Input.getInputMappingClient(this)
    inputMappingClient.setInputMappingProvider(MyInputMapProvider())
}

Aby wyczyścić mapę wejściową, znajdź wywołanie funkcji unregisterInputMappingProvider:

override fun onDestroy() {
    val inputMappingClient = Input.getInputMappingClient(this)
    inputMappingClient.unregisterInputMappingProvider(myInputMapProvider)

    super.onDestroy()
}

I zastąp je funkcją clearInputMappingprovider:

override fun onDestroy() {
    val inputMappingClient = Input.getInputMappingClient(this)
    inputMappingClient.clearInputMappingProvider()

    super.onDestroy()
}

Java

Aby zarejestrować dostawcę mapy wejściowej, znajdź wywołanie funkcji registerInputMappingProvider:

private final MyInputMapProvider myInputMapProvider = new MyInputMapProvider();

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    InputMappingClient inputMappingClient = Input.getInputMappingClient(this);
    inputMappingClient.registerInputMappingProvider(myInputMapProvider);
}

I zastąp je funkcją setInputMappingProvider:

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    InputMappingClient inputMappingClient = Input.getInputMappingClient(this);
    inputMappingClient.setInputMappingProvider(new MyInputMapProvider());
}

Aby wyczyścić dostawcę mapy wejściowej, znajdź wywołanie funkcji unregisterInputMappingProvider:

@Override
protected void onDestroy() {
    InputMappingClient inputMappingClient = Input.getInputMappingClient(this);
    inputMappingClient.unregisterInputMappingProvider(myInputMapProvider);

    super.onDestroy();
}

I zastąp je funkcją clearInputMappingProvider:

@Override
protected void onDestroy() {
    InputMappingClient inputMappingClient = Input.getInputMappingClient(this);
    inputMappingClient.clearInputMappingProvider();

    super.onDestroy();
}