360SDK FAQ

1.網(wǎng)游sdk接入FAQ

1.1 登錄FAQ

Q1：登錄報錯invalid param appid 400c

A1：后臺加白機制，出現(xiàn)該頁面后請等待10分鐘后加白完成，就可以恢復。并且不會在出現(xiàn)該問題。此類報錯一個應用只會報錯1次。如10分鐘后還會報錯，

請確定一下問題

<meta-data android:name="QHOPENSDK_APPID" android:value="201994551"/>
<meta-data android:name="QHOPENSDK_APPKEY" android:value="694a05558e1e8ab4cbbc0f89de22834b"/>
<meta-data android:name="QHOPENSDK_PRIVATEKEY" android:value="04daccefc14033ed3d18f157a9f6d1d8"/>

這3個字段的位置不對，必須再application里面，作為application的子元素存在。

如果還有此報錯，請聯(lián)系360技術人員，或者對接游戲運營。

Q2：{"error":"auth code不可用（OAuth2）","error_code":"4010203"}

A2：去掉CODE換TOKEN的部分，直接接收TOKEN 獲取用戶信息就行了

Q3：返回{"error_code":"4010201","error":"access token不可用（OAuth2）"}

A3：這個是TOKEN過期了，TOKEN作廢了，重新登錄即可。

Q4：TOKEN指的是什么意思？

A4：開放平臺頒發(fā)的TOKEN指的是access_token和refresh_token,access_token是調用所有接口的token，refresh_token只有一個作用，就是用來刷新access_token和自身(refresh_token),默認情況下說token，指的是access_token。

Q5：使用TOKEN調用服務器端接口時失敗, 顯示TOKEN已失效或者過期

• 檢查用戶是否在線很長時間, 以至于TOKEN失效. 這樣的話需要刷新TOKEN或者引導用戶再登錄一下 (目前，一次TOKEN時效10小時)

• 檢查用戶是否在多臺設備上用同一賬號多次登錄. 只有最后一次的TOKEN是可用的

• 上述兩個都不是, 聯(lián)系360開放平臺手機SDK技術支持.

Q6：報錯：請到開放平臺獲取您的appid

A6：需要在AndroidManifest.xml中配置QHOPENSDK_APPID。

Q7：調用了sdk的登錄接口，但是sdk的登錄界面沒有彈出來，而是直接通過回調返回了這樣的json串：{"data":{"state":"test_state111","access_token":""},"errno":-1}

A7：把“可選參數(shù)：自動登錄過程中是否不展示任何UI”這句代碼去掉。

Q8：Activity初始化未完成，浮窗無法顯示

A8：請排查以下3點

• 未接入銷毀方法Matrix.destroy()

• Matrix.init(Activity activity) 未傳入主activity，常駐的activity

• activity的oncreate被多次調用，或360SDK的初始化接口被多次調用

Q9：getAccessToken onError

A9：登錄驗證出錯，服務器地址配置錯誤

1.2 支付FAQ

Q1：關于支付回調問題：

• 支付回調地址：回調地址需要研發(fā)同學自己配置，為安全起見，支付回調地址不在后臺填寫，請在調用支付接口時填寫notify_url字段。詳情見接入文檔支付接口部分。

• 支付未收到回調：先保證支付通知接口是可訪問的. 在瀏覽器上訪問一下就知道了. 用  IP地址的話注意不要是內網(wǎng)IP記錄完整的請求日志, 把未經(jīng)處理的請求參數(shù)串, 記在日志里. 直接回應ok.

• 修改回調地址：客戶端在下單時，傳入新回調地址就可以。

• 支付400錯誤：400錯誤都是因為參數(shù)缺少或者APP KEY / APP SECRET值不對，解決方案對照文檔看缺什么參數(shù)。

• 支付401錯誤：不要通過程序去請求 而是在服務器上直接CURL查看返回的原始錯誤。

Q2：關于簽名：

• 客戶端：如果是客戶端報 invalid Signature，或者簽名錯誤之類。 請檢查客戶端的appKey和privateKey是否匹配。 以及privateKey是否正確計算(md5(appSecret+'#'+appKey))。 具體計算方式也請參考文檔。

• 服務端簽名不對：重點檢查2個方面的問題： 1) 請確保加密使用的是當前應用的appSecret,和客戶端private Key不一樣。  2) 加密時是否計算了不必要的參數(shù)，比如應用自己在鏈接中定義了額外的參數(shù)。具體哪些參數(shù)參與簽名請參考文檔。 Demo代碼僅供參考。

Q3：變更測試的回調地址，在平臺游戲管理中心的編輯與更新沒有找到界面，要如何操作？

A3：客戶端在下單時，有個回調地址參數(shù)。 傳入新回調地址就可以。

Q4： 關于 360先玩后付 這種支付方式，信用余額的問題。

A4：mo9是信用支付，就是先消費，后還款，每個用戶初始信用額度一般為30塊錢，支付過一次之后，要在一周之內還款，否則有可能會被拉黑，造     成下次用mo9支付時顯示信用額度不足?？梢月?lián)系360技術支持人員查詢信用額度問題。

Q5：支付這塊，服務端的PayAppInterface接口里的isValidOrder方法是必須的嗎？

A5：這個是Demo里的代碼，是為了檢查返回值是否正確，這個需要開發(fā)者自己決定用不用

Q6：報錯：app_uid is needed 

A6：以下參數(shù)有缺失：APP_NAME，APP_USER_NAME，APP_USER_ID，APP_ORDER_ID

Q7：余額查詢失敗

A7：余額查詢失敗先看下能不能用支付寶下單。 只測試下單，不用支付。 如果下單報簽名錯誤，請檢查客戶端privateKey是否正確。

Q8: 為什么登錄是好用的，但是支付功能卻無法正常使用

A8: 出現(xiàn)這種情況，請首先檢查Mainifest.xml文件中，PRIVATEKEY是否已經(jīng)正確的配置。

    <meta-data 　　android:name="QIHOO_SDK_PRIVATEKEY" 　　android:value="4e04fe9ac8e2a73cbb27ba52ac076eb9" > </meta-data>.

Q9：

A9：access token失效，token有效期為10小時，若用戶在線時間過久需游戲引導用戶重新登陸，重新進行支付步驟。

1.3 社交FAQ

Q1：究竟哪些好友是可以邀請的？

A1：手機游戲SDK會根據(jù)用戶的本地通訊錄、360游戲平臺中其他社交游戲中的好友進行計算，返回給用戶那些是可以邀請的好友。friendship.png

Q2：好友已經(jīng)收到了我的邀請短信，在游戲中為什么沒有成為好友？

A2：短信發(fā)送成功后，SDK會向360的邀請服務發(fā)送“邀請短信已經(jīng)發(fā)送成功”的消息；如果這個時候網(wǎng)絡狀況不佳時，就會出現(xiàn)邀請失敗的情況；     即使被邀請收到短信，好友關系依然沒有建立。建議開發(fā)者根據(jù)接口返回結果來提示用戶邀請是否成功。

    FUNC_CODE    接口

    FUNC_CODE_INVITE_FRIEND_BATCH   邀請好友接口返回結果示例

    { 　　errno: 0, 　　errmsg: "ok", 　　time: 1363155828, 　　data: { 　　　status: "1" //0：邀請失敗，1：邀請成功 　　} }

Q3：除了默認的排行榜，游戲方如何自定義游戲的排行榜。

Q3：游戲可以定義多個不同排行榜，在上傳對應排行數(shù)值的時候指定對應排行榜id即可（最多自定義10個排行榜，id為1~10）。

   游戲自定義的排行榜需要者發(fā)郵件到360box@#提交申請游戲的資料。包括：“游戲名稱”“游戲包名”“appid”“排行榜編號”“更新頻率”“每天更新時間（精確到秒）”“起止時間”“默認排序（升，降序）”例如

郵件標題
游戲添加自定義排行榜  游戲名“某某游戲”
郵件正文：
游戲包名：“xxx.xxxx”
appid：XXXXXXXXX
排行榜編號：3（1-10）
更新頻率：每周
每天更新時間：00:00（精確到秒）
起止時間:2014.11.1
默認排序：降序排列（升，降序）

1.4 數(shù)據(jù)FAQ

Q1：支持哪些數(shù)據(jù)統(tǒng)計？

A1：目前可支持開發(fā)者自定義數(shù)據(jù)統(tǒng)計：如關卡、道具、任務、玩家、角色統(tǒng)計等。

Q2：接入過程中有什么需要特別注意的?

• .需在應用“啟動Activity”的onCreate方法中調用Matrix.init(this)；

• 若應用退出時調用了android.os.Process.killProcess(android.os.Process.myPid())或System.exit(0) 方法，則需在調用這兩個方法前調用QHStatDo.OnExit()方法，確保數(shù)據(jù)不丟失，能正常上報。 
   

Q3：在哪里可以查到統(tǒng)計結果？

A3：由于統(tǒng)計平臺仍在限量測試中，“聯(lián)運游戲”查看統(tǒng)計結果需要聯(lián)系對應運營負責人。 

1.5 推送FAQ

Q1：360推送服務有哪些優(yōu)勢？

• 多達15種標配推送維度且支持開發(fā)者自定義推送維度。

• 優(yōu)異的不同接入網(wǎng)絡連接自動設配能力，消息的實時到達率業(yè)內領先 

• 采用優(yōu)于競品的SDK雙服務綁定架構，支持多路復用，節(jié)約用戶流量和電量

Q2：目前支持哪些維度的推送消息？

A2：可根據(jù)應用版本、用戶自定義標簽、用戶所在地、活躍度、應用投放渠道、運營商、網(wǎng)絡接入類型、設備機型、品牌、屏幕分辨率、系統(tǒng)語音、版本、用戶百分比、360用戶畫像及開發(fā)者自定義共15個維度進行推送。
 

Q3：在哪里可以進行推送操作？

A3：由于360推送仍在限量測試中，我們將逐步對所有開發(fā)者開放，請您關注360開放開放平臺的消息和公眾賬號，獲取最新進展。 

1.6 其他FAQ

Q1：自檢顯示assets下資源丟失如何處理？

• 不要混淆、不要加固，重新自檢

• 沒有把assets下的文件拷貝到工程assets下

• 請將Unity、Cocos工程先導入Eclipse，使用Eclipse出包

• 請將編譯環(huán)境調到Android-22，4.4以上

Q2：token去換qid，必須是開發(fā)者的服務器去換么？開發(fā)者時候可以客戶端發(fā)個HTTP請求換呢？

A2：如果沒有服務器可以這么做，但為了帳號安全，最好是從服務端發(fā)起。

Q3：服務端簽名不對的情況？請按照以下說明檢查。

A3：簽名不對，重點檢查2個方面的問題： 

    1) 請確保加密使用的是當前應用的appSecret,和客戶端private Key不一樣。

    2) 加密時是否計算了不必要的參數(shù)，比如應用自己在鏈接中定義了額外的參數(shù)。具體哪些參數(shù)參與簽名請參考文檔。 Demo代碼僅供參考。

Q4：客戶端簽名不正確，請按以下方法檢查

A4：如果是客戶端報 invalid Signature，或者簽名錯誤之類。 請檢查客戶端的appKey和privateKey是否匹配。 以及privateKey是否正確計算                           (md5(appSecret+'#'+appKey))。 具體計算方式也請參考文檔。

Q5：懸浮窗在什么情況下會消失掉，已經(jīng)調用atrix.destroy()方法

A5：退出游戲之前要調用，浮窗消失是SDK 判斷游戲沒有運行在前臺才會消失

Q6：1.0.4版本是否可以設置背景。

A6：UI_BACKGROUND_PICTRUE這個參數(shù)是改背景的。bundle.putString(ProtocolKeys.UI_BACKGROUND_PICTRUE, "");這樣設置會顯示默認背景。

Q7：游戲退出的返回按鈕

A7：只有返回值為0的時候不需要做操作，其他情況都要執(zhí)行退出游戲。

Q8：接入sdk退出出現(xiàn)了問題，出現(xiàn)退出彈窗后點退出游戲，調用了android.os.Process.killProcess(android.os.Process.myPid()); 退出游戲，結果游戲直接重啟？

A8：在退出回調后，調用 killprocess 游戲重啟的問題，要在killprocess之前調用 finish() 方法.

2.單機sdk接入FAQ

Q1：單機SDK是否支持登錄及登錄用戶信息獲取功能？
A1：V0.1.3(9014)及之前版本不支持登錄功能；V0.1.4(9016)版本支持登錄功能，但登錄不返回用戶個人信息，僅在用戶進行聯(lián)網(wǎng)支付時向應用服務器返回用戶登錄信息，不支持單獨獲取用戶登錄信息；V0.1.4(9018)版本支持登錄及用戶信息獲取。

Q2：50元等大額商品是否可以使用運營商短代計費？

A2：不可以，僅通過申請的計費點可使用短代計費。由于30元以上商品暫無對應計費點，故無需進行計費點申請。用戶支付時，直接跳轉至聯(lián)網(wǎng)支付。

Q3：在什么情況SDK會調起話費支付，什么情況會調起聯(lián)網(wǎng)支付？

A3：同時滿足以下所有條件則調起話費支付；若一項或多項不滿足，則調起聯(lián)網(wǎng)支付。

1.所支付商品已成功申請計費點；

2.用戶手機有sim卡且可判斷sim卡歸屬運營商；

3.最近一次聯(lián)網(wǎng)獲取到的sim卡對應運營商計費通道未關閉；

4.支付amount參數(shù)（單位分）的值是否和goodInputId對應的金額一致。

Q4：為何無法正常調起話費支付？
A4：請按以下步驟進行檢查。
1.檢查手機是否已插入移動、聯(lián)通或電信sim卡；
2.檢查是否已在360開放平臺申請短信支付通道且所支付商品包含在申請的計費文件中；
3.檢查計費文件是否放到assets下；
4.檢查應用傳的goodinputid是否與計費文件中對應一致；
5.檢查計費文件的包名和appkey是否與工程中填寫一致；
6.檢查支付amount參數(shù)（單位分）的值是否和goodInputId對應的金額一致。

Q5：支付結果服務器通知接口是否必接？會通知哪些信息？

A5：非必接，有服務器的cp可選接。會通知用戶聯(lián)網(wǎng)支付的結果，短代支付不做通知。具體通知字段詳見接入文檔。

Q6：道具發(fā)放以服務器通知還是sdk通知為準？

A6：短代支付必須以sdk通知為準。

聯(lián)網(wǎng)支付未接應用服務器通知則必須以sdk通知為準，已接應用服務器通知可自行選擇以sdk通知或服務器通知為準。

sdk通知不區(qū)分短代支付及聯(lián)網(wǎng)支付方式。

Q7：扣費成功，下行扣費短信正常，但SDK出現(xiàn)錯誤碼129返回碼1214的報錯。

A7：確認廣播接收器中是否包含以下示例加粗行通知優(yōu)先級代碼，若不包含自行添加或在dev.#重新下載SDK即可。

<receiver

android:name="mm.yp.purchaseSDK.sms.SMSReceiver"

android:exported="false" >

<intent-filter android:priority="10000" >

<action android:name="aspire.iap.SMS_SEND_ACTIOIN" />

<action android:name="aspire.iap.SMS_DELIVERED_ACTION" />

</intent-filter>

</receiver>

3.開發(fā)者自定義浮窗FAQ

3.1 代碼部分

注意：此部分用于開發(fā)者自定義主動調用浮窗，如不需要主動調用，浮窗不需要單獨接入，使用360浮窗默認展示邏輯，開發(fā)者不需要接入此步驟。

在主UI線程調用此代碼

代碼如下：

Intent i = new Intent();
i.putExtra(ProtocolKeys.FUNCTION_CODE, ProtocolConfigs.FUNC_CODE_PERSONAL_CENTER_ACTIVITY);
Matrix.invokeActivity(this, i, null);

3.2 注意事項（請仔細閱讀）

3.2.1 如果游戲想屏蔽掉SDK自帶浮窗，需要提交游戲包名和游戲版本號給  yangzhongyi@# ,在后臺進行黑名單配置。

3.2.2 必須在登錄成功的狀態(tài)下調用，否則不會顯示。建議是用戶登錄。點擊是展示個人主頁界面。

調用效果如下：

3.2.3如果能成功調起福利界面，游戲不會收到回調。所以，回調參數(shù)傳空就可以。

3.2.4.返回錯錯誤碼信息

當360SDK處于未初始化狀態(tài)時，調用其任何接口都會返回錯誤，錯誤碼為-101。{“errno”:-101,“errmsg”:”…”}，

如果360SDK未處于登錄狀態(tài)，會直接返回錯誤，錯誤碼為-100。{“errno”:-100, “errmsg”:”…”}