מעבר ל-SDK לקליטת נתונים בגרסת 1.0.0 בטא

במדריך הזה מוסבר איך להעביר את המשחק כדי להשתמש בגרסה העדכנית ביותר קלט SDK. ל-SDK 1.0.0-beta יש שיפורים משמעותיים תצוגה מקדימה של 0.0.4 הקודם. צריך לעבור מהתצוגה המקדימה הקודמת ברגע ככל האפשר. ערכת ה-SDK 0.0.4 תמשיך לפעול עד מרץ 2023.

עדכון התלות

מוחקים את ספריית 0.0.4 מספריית libs כי הספרייה נמצאת עכשיו זמינים ב-Maven. לאחר מכן מאתרים את השורה הזו ברמת המודול build.grade file:

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

מחליפים אותה בקוד הבא:

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

הטמעת הממשק החדש של InfoMappingProvider

הכיתה המופשטת הקודמת InputMappingProvider הפכה לממשק גרסה 1.0.0-beta. השיטה onProvideInputMap() היא עדיין חלק גרפי.

Kotlin

צריך להסיר את () מהגדרת הכיתה כי אין constructor שאפשר להפעיל בו InputMappingProvider.

מוצאים את ההטמעה של InputMappingProvider:

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

ומעדכנים אותה כך:

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

Java

מחליפים את extends ב-implements כדי לציין שאתם מיישמים במקום להרחיב כיתה.

איתור המקום שבו מרחיבים את InputMappingProvider:

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

ולשנות אותו כדי להטמיע את InputMappingProvider:

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

שימוש ב-inputClient החדש

registerInputMappingProvider ו-unregisterInputMappingProvider הם הוחלף ב-setInputMappingProvider וב-clearInputMappingProvider. בנוסף, clearInputMappingProvider כבר לא מקבל ארגומנט לא צריך יותר לשמור הפניה לספק כדי לבטל את הרישום מאוחר יותר.

Kotlin

כדי לרשום את ספק מפת הקלט, אתר את השיחה אל 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)
}

ומחליפים אותו בsetInputMappingProvider:

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

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

כדי לנקות את מפת הקלט, מאתרים את השיחה אל unregisterInputMappingProvider:

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

    super.onDestroy()
}

ומחליפים אותו בclearInputMappingprovider:

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

    super.onDestroy()
}

Java

כדי לרשום את ספק מפת הקלט, אתר את השיחה אל 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);
}

ומחליפים אותו בsetInputMappingProvider:

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

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

כדי להסיר את הספק של מיפוי הקלט, צריך לאתר את הקריאה unregisterInputMappingProvider:

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

    super.onDestroy();
}

ומחליפים אותו בclearInputMappingProvider:

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

    super.onDestroy();
}