Skip to main content

InitLIP

AndroidiOSWindows
Available from: LI PASS V1.16
If you were looking for the method for use with Unreal Engine, see InitLIP for Unreal Engine SDK.
note

It is recommended to call InitLIP to initialize LI PASS when starting the game.

Function definition

public static void InitLIP(Font font, string appVersion = "appVersion", string langType = "en");
note

Starting from LI PASS V1.28.00, the parameter appVersion is optional, with a default value of "appVersion." If the business does not provide appVersion or provides appVersion="appVersion", LI PASS will automatically handle the related logic.

LI PASS initialization consists of the following steps:

  1. Obtain hotfix information for resource package version
  2. Download resources for new version
  3. Load resources
  4. After loading is complete, trigger the GN_READY event from LIEventObserver
note

The callback timeout for GN_READY in the case of a network exception is 60s*3. Games can call AutoLogin, OpenLoginPanel, or LoginChannelWithLIPass directly after initialization to provide the player with a timely response, without having to wait for the GN_READY event.

Obtain Hotfix Information for Resource Package Version

Request Information

Search gnconfig to locate the request URL:

2023-06-08 09:54:20.948 25151-26800 INTL                    com.intlgame.demo                    I  [INTL][1806][A.I.A][2023-06-08 09:54:20.948][25151, 26800, 539607522480][ (intl_http_manager.cpp:328) OnHTTPClientCallBack] : 
[http] request url : https://test-vas.intlgame.com/v2/gnconfig/acquire_config?area_id=0&channelid=131&gameid=11&openid=FFFFFFFFFFFFFF&os=1&sdk_version=1.3.00&seq=11-7a08fc1d06ea8e62b6ea3e626ed61c8f2398c981bc6d8d0dfa30681a3d05616e-1686189260-717&source=37&token=&ts=1686189260&sig=6dc2bb8968cfe28fab5138e2342f327d ,

Response Information

caution

If LI PASS does not perform according to expectations, verify the version information to confirm that the correct version of resources have been loaded.

If a rule is matched, search rule_id to locate the response information:

response_body : {
"ret":0,
"msg":"",
"rule_id":"1063",
"resource_list":"[{\"dependency\":[],\"file_list\":[{\"md5\":\"968F1A3E16AB6041F504E29DEFB348DD\",\"size\":1747648,\"url\":\"https://sg-gamenative001-1300342648.file.myqcloud.com/gamenative-files/11/LI_107_UE_Android/1686187421509627102/LevelInfinite_Android.pak\"}],\"is_public\":0,\"name\":\"LI_107_UE_Android\"}]",
"sdk_enable":1,
"sdk_debug_enable":1,
"report_log_enable":1,
"log_level":1,
"inner_seq":"ac097e19-772b-4069-948d-78e21821ac15",
"seq":"11-7a08fc1d06ea8e62b6ea3e626ed61c8f2398c981bc6d8d0dfa30681a3d05616e-1686189260-717"
}

If no rules are matched:

response_body : {
"ret":23111202,
"msg":"no matched config error( [match logic]no match )",
"rule_id":"",
"resource_list":"",
"sdk_enable":0,
"sdk_debug_enable":0,
"report_log_enable":0,
"log_level":0,
"inner_seq":"ca3fa94a-0be7-4325-aa90-a5bc36d7c502",
"seq":"11-7a08fc1d06ea8e62b6ea3e626ed61c8f2398c981bc6d8d0dfa30681a3d05616e-1686189018-705"
}

Input parameters

ParameterTypeDescriptionRemark
fontFontThe font used for LI PASS UIRequired
appVersionstringGame app version, space characters cannot be usedStarting from LI PASS V1.28.00, this parameter is optional with a default value of "appVersion"; it was required parameter in previous versions.
langTypestringLI PASS UI display languageOptional, default value: "en."
note

If you wish to use font that is not included with LI PASS, contact the Player Network representative.

Code sample

Font font = GetFont();
string appVersion="appVersion"
LevelInfinite.InitLIP(font, appVersion, "en");