SMSSDK的Unity3D外掛主要為使用者提供了兩種整合的方式:
一種是通過橋接檔案直接呼叫SMSSDK的原生API,
另外一種是使用SMSSDKGUI中的UI。
這兩種方式的整合,方便使用者按需選擇。在進行整合之前,需要到Mob官網獲取使用的appKey和appSerect。
開啟Github下載SMSSDK-For-Unity3D專案。將專案中的Unity3DForSMSSDK/Assets/Plugins目錄拷貝到您的專案的Assets目錄中,或雙擊SMSSDK.unitypackage匯入相關檔案。
注意該操作可能會覆蓋您原來已經存在的檔案!
選擇好需要掛接的GameObject(例如Main Camera),在右側欄中點選Add Component,選擇SMSSDK 進行掛接。如果需要使用Demo.cs檔案,也需要進行掛接主相機。方法同掛接SMSSDK相同。
呼叫SDK介面
首先,要先引入名稱空間,using cn.SMSSDK.Unity,並宣告SMSSDK.cs的例項,如下:
private SMSSDK smssdk;
並且進行設定:
smssdk = gameObject.GetComponetn();
其次,初始化SDK,在初始化SDK的方法的中,需要使用者appKey和appSerect(可從Mob官網上面獲得),如下:
smssdk.init(“114d7a34cf7ea”,”678ff550d7328de446585757c4e5de3f”,false);
再次,實現SMSSDKHandler並將它設定給SMSSDK,用來處理回撥,如下圖:
現在你就可以使用我們提供的API實現自己的功能了,如下:
a、獲取驗證碼:
1 |
smssdk.getCode (CodeType.TextCode, phone, zone, tempCode); |
注:tempcode,是模板編號,如還未申請傳null即可;
b、提交驗證碼:
1 |
smssdk.commitCode (“186********”, "86",code); |
c、獲取通訊錄好友資訊:
1 |
smssdk.getFriends(); |
d、獲取國家支援列表:
1 |
smssdk.getSupportedCountryCode (); |
e、提交使用者資料:
1 |
smssdk.submitUserInfo (userInfo); |
f、獲取SDK版本號:
1 |
smssdk.getVersion (); |
j、設定訪問通訊錄許可權
1 |
smssdk.enableWarn (true) |
關於回撥資料的處理
有些API將會把回撥資料發到你設定的SMSSDKHandler。回撥資料(resp)是一個json字串。你可以使用任意的JSON庫進行處理。其中action是你呼叫的API的型別。
onComplete(int action, object resp)
onError(int action, object resp)
關於UI 部分
以上幾個介面是單純的使用API,並沒有牽涉到相關介面,如果開發者需要使用Mob官網中SMSSDK Demo中UI部分,我們也提供了使用UI的相關方法,如下:
showRegisterPage(CodeType getCodeMethodType, string tempCode) // 模板編號tempCode可以為空
showContactsPage()
至此,Unity3D外掛部分的工作已經完成。
我們預設整合了Android 的SMSSDKGUI,如果你不需要(即不使用上面的兩個UI方法),可以將 Assets/Plugins/Android/ShortMessageSDKGUI資料夾刪除。如果你想自定義這個GUI,你可以在SMSSDK-for-Android中找到這個GUI開源庫,你可以任意修改它,然後打包成Unity能使用的外掛。
如還有任何問題,請聯絡技術支援:
聯絡QQ 4006852216