05/15/2024 15:19:45

Solution

I. Overview

The corresponding backend data storage mechanisms of MSDKV3 version and MSDKV5 version are inconsistent. When MSDKV3 version is upgraded to MSDKV5 version, you need to migrate the player data of MSDKV3 version. The main migration data are:

(1)Guest account: iOS only;

(2)QQ/ WeChat channel's login openid uses MSDKV3 version's openid;

(3)Registration channel;

Dependencies: support MSDKV5.7 and higher versions.

II. Guest migration process for upgrading V3 to V5

The client guest login and migration process is as shown in the figure below.

III. Necessary configuration (Important! Required!)

V3 Special Reminder for Guest Migration

(1)[Platform ID] Do not change QQ-AppId and WeChat-AppId parameters of the original project;
(2)[Project parameter] Do not change the original XCode project Keychain Sharing parameter configuration of iOS;
(3)[Client configuration] In the configuration file MSDKConfig.ini in MSDKAppSetting.bundle, make sure that the migration configuration switch is enabled;
A.Enable the guest data migration of MSDKV3, 1 indicates "enabled", 0 indicated "disabled".

MSDK_MIGRA_GUEST_FROMV3_ENABLE = 1
B.At the same time, for the configuration switch for that iTOP1 is upgraded to MSDKV5, keep the disabled status.

MSDK_MIGRA_GUEST_FROM_ITOP1_ENABLE = 0
(4)[Console configuration] Confirm: Feiying system console [MSDK V3 is upgraded to V5] select [Yes] (the figure below is MSDKDemo example's configuration)

(5)[Console configuration] Confirm: the channel real-name authentication configuration is enabled (enabled by the project team administrator), path: [Feiying system] (http: //dev.ied.com/) ->My Game ->Login Information

IV. Test Verification

1. QQ/ WeChat

(1)The gopenid value used for QQ/ WeChat channel login is the same as the openid of V3 version, and the login, relationship, sharing, and other functions of the corresponding V3 version are normal.
(2) The value of pf is the same when QQ/ WeChat channel uses V3 version and V5 version to log in the game.

2. Guest

(1)Preconditions

a) The test mobile phone has never installed V5 version's corresponding app;
b) Each mobile phone device can only be tested once The first upgrade process;

(2) Result verification

The guest openid of V5 version is the same as the guest openid of V3 version.

(3) Test process

a) Device A does not install the corresponding app of V5;
b) Device A installs the corresponding app of V3 and performs guest login. openid returned by login is a;
c) Use the corresponding app version of V5 to overwrite V3 version, and perform the first guest login of V5. openid returned by login is expected to be a;

When V5 is installed for the first time, the log of performing guest login is as follows: (Open the MSDK log switch to view)

Where:
upgrade_from: 3 marks the first migration of guest from V3 to V5
msdk_v3_guestid、msdk_v3_access_token、msdk_v3_request_id、msdk_v3_hid msdk_v3_guestid, msdk_v3_access_token, msdk_v3_request_id, msdk_v3_hid All are V3's guest device id and other data. The game does not need to care about them

{
    "channel_info": {
        "uuid": "B782B6EC-E1B5-4664-85A7-56CFF18A124B",
        "upgrade_from":3,
        "msdk_v3_guestid": "G_e93d14c46032656e9143bf55e1ec0ba3",
        "msdk_v3_access_token": "a7W9DrbqnKZWxly5Vlmoy9elzvmb2NIMhTB_l8TWru0=",
        "msdk_v3_request_id": "38CDF073571C14187CD1FAE403C5057DF105BA6B4CF9F1F59DDCB9F69F309ECAC4D98CBA302EE74C",
        "msdk_v3_hid": "AB750C9F-18B1-480E-8179-7A7665D347F5"
    },
    "device_info": {
        "uuid": "B782B6EC-E1B5-4664-85A7-56CFF18A124B",
        "device_language": "English",
        "app_version": "1.1.4(100076)",
        "screen_dpi": 2.0,
        "resolution": "828*1792",
        "trade_mark": "iPhone",
        "manufacturer": "APPLE",
        "model": "iPhone 11",
        "apn": "unkown",
        "ram_info": "3844",
        "rom_info": "59",
        "cpu_info": "16777228-2",
        "hw_machine": "iPhone12,1",
        "idfa": "5D49E066-6998-42E0-9BE0-5FEC8ADD64DA"
    },
    "channel_dis": "1001"
}

After V5 is installed for the first time and the app is started, the log of every subsequent guest login is as follows. Later on, there will be no mark like "upgrade_from: 3", but other V3's device id and other data.

Log is as follows:

{
    "channel_info": {
        "uuid": "B782B6EC-E1B5-4664-85A7-56CFF18A124B",
        "msdk_v3_guestid": "G_e93d14c46032656e9143bf55e1ec0ba3",
        "msdk_v3_access_token": "a7W9DrbqnKZWxly5Vlmoy9elzvmb2NIMhTB_l8TWru0=",
        "msdk_v3_request_id": "38CDF073571C14187CD1FAE403C5057DF105BA6B4CF9F1F59DDCB9F69F309ECAC4D98CBA302EE74C",
        "msdk_v3_hid": "AB750C9F-18B1-480E-8179-7A7665D347F5"
    },
    "device_info": {
        "uuid": "B782B6EC-E1B5-4664-85A7-56CFF18A124B",
        "device_language": "English",
        "app_version": "1.1.4(100076)",
        "screen_dpi": 2.0,
        "resolution": "828*1792",
        "trade_mark": "iPhone",
        "manufacturer": "APPLE",
        "model": "iPhone 11",
        "apn": "unkown",
        "ram_info": "3844",
        "rom_info": "59",
        "cpu_info": "16777228-2",
        "hw_machine": "iPhone12,1",
        "idfa": "5D49E066-6998-42E0-9BE0-5FEC8ADD64DA"
    },
    "channel_dis": "1001"
}