修訂記錄版本修訂內(nèi)容日期作者審核1SDK配游戲rootViewController方向2、支持ios最低版本由6.0升級為UI適配 簡 SDK包功能簡 兼容 軟硬件支 接入步 成為開發(fā) 創(chuàng)建游 添加游 添加游戲 添加分 開發(fā)測 添加 初始化 適配銀聯(lián)卡支 實現(xiàn)SDK的 接入PP用戶系 接入PP充值系 針對ios9的對接說 打包方式說 提交審 游戲更 接入過程中常見問 PPPPPPPP【SDKDEMO源代碼】。支持iOS5.0以上的系統(tǒng)。其他系統(tǒng)需要進試。（支持arm64、硬件：macbook或者蘋果。蘋果移動設備，ipad，ipod。軟件：安裝XCode6.0以上版本，其他版本可能會有些許不同。開發(fā)者到ht 通過 /?act=dev申請開發(fā)者賬號注：注：提交申請后請聯(lián)系PP商務人員進行審核，審核通過后用開發(fā)者賬號登錄 /）sdk，獲取公鑰，并添加游戲應用。錄才 SDK，普通PP賬號無 到SDK用開發(fā)者賬號登錄PP選擇“游戲管理”選項卡，進入“游戲添加”填寫游戲基本信息。如圖2-1所示：2-1注注己提供（CFBundleIdentifier起名規(guī)范看《PP助手SDK對接測試規(guī)范》）。、通知地址是接收3、提交后可以獲得appid和appkey，這是游戲應用的唯一標識，需要在初始化SDK的時候設置，否則 為剛剛添加的游戲應用添加相應的游戲包，如圖2-2所示。2-2如果是第一次添加的游戲包，則游戲版本號格式可以自定義（如：1.00.0）。如果是游戲端E32位瀏覽器。注注：每一次在開發(fā) 添加的游戲包的游戲版本一定要和ipa包的BundleVersion一致，（即圖2-2“游戲版本”的值==圖2-4“游戲版本”的值==圖2-4中Version的值==圖2-4中Build的值），否則將可能造成游戲無法正常更新。ipa包的BundleVersion設置方法如下圖2-3，圖2-4所示：2-3在info.plistBundle2-4在GeneralBundle0圖2-5：傳傳添加PPApp tformKit.framework及依賴庫將SDK包中的 tformKit.framework拷到項目開 下，然后 tformKit.framework拖拽到工程導航視圖的Frameworks 框（注意勾選），點擊Finish。完成后SDK就被加入到了工程中，依賴庫添加如圖2-6所示（注意：為了適配IOS5，AdSupport.framework庫的狀態(tài)選擇圖2-6添加 tformKit.framework及依賴將PPApp tformKit.bundle加入工程中在BuildPhases項中，展開“CopyBundleResources”一欄，同樣點擊左下角的“+”，然后在彈出的框里點擊左下角的“AddOther”按鈕，打開PPApp tformKit.bundle所在的目錄，選擇PPApp tformKit.bundle點擊“Open”，即可將PPApp tformKit.bundle加入到項目中（每次升級必須更換最新的 tformKit.bundle）。如下圖2-10所示：圖2-10添加 設置OtherLinkerFlags為-ObjCall_load設置URLSchemes因為充值系統(tǒng)集成了支付寶快捷支付充值方式，該充值方式需要跳轉(zhuǎn)App，所以需要增加以下配置，否則充值過程中跳出游戲之后無法返回（還需要設置支付寶回調(diào)，詳見2.3.2初始化找到項目下的Supportingfiles，打開該下的XXX-Info.plist文件，在InformationPropertyList項下添加一個URLTypes節(jié)點；然后打開該節(jié)點，在Item0下再添加一個URLSchemes節(jié)點打開該節(jié)點，添加一個Item，把值設置為teiron+appid。如下圖2-12所示（demo中的appid為76，所以設置為2-12設置URL將頭文件PPApptformKith引入到工程中。注注：SDK將所有接口封裝在 tformKit中，故以下未做特殊說明的API均表示在 tformKit類中，具體使用方法詳見SDKDEMO設置啟動務必添加5.5和4.7寸的啟動，否則在6 問題。如下圖所示（圖2-13設置啟動圖在使用SDK之前需要先進行初始化，初始化SDKAPPID，APPKEY等信息，這些信息都是創(chuàng)建應用時填寫或者返回的。接口信息如下表2-1所2-1初始化SDK對應SDK必選（startPPSDK）appid可選（0:未登錄1:登錄注注1、必須初始化[[UIWindowkeyWindow]rootViewController]。 (BOOL)application:(UIApplication*)applicationhandleOpenURL:(NSURL*)url{ tformKitshare]alixPayResult:url];returnYES;}(BOOL)application:(UIApplication*)application*)urlsourceApplication:(NSString*)sourceApplication{ tformKitshare]alixPayResult:url];returnYES;}由于銀聯(lián)只支持豎屏,如果游戲只支持橫屏,需要將工程的info.plist文件中supportedinterfaceorientations(和supportedinterfaceorientations(iPad))設置成支持4個方向,而游戲的橫屏在代碼中控制即可。SDK為了獲得SDK的回調(diào)通知，需要實現(xiàn)PPApp tformKitDelegate，并實現(xiàn)以下表2-2中表2-2 tformKitDelegate中的方對應SDK錄成功有效，驗證之后一定要回調(diào)驗證成功傳入YES或NO，否則會影響回調(diào)信息如下表2-3表2-3回調(diào)信息01未收到商品請聯(lián)系PP： 長時間未收到商品請聯(lián)系PP：您的賬戶存在異常，PP幣余額無法正常使用，建議您聯(lián)系PP 游戲必須先登錄PP賬號，才能進入游戲。接口信息如下表2-4所示：對應SDK用戶名擊登，系用戶正確了防第錄，如果用戶信息正確，系統(tǒng)會發(fā)送一個token_key到客戶端。廠商在登錄回調(diào)中獲取到token_key后，需要將這個token_key原樣發(fā)送到廠商業(yè)務服務器，再由廠商業(yè)務服務器發(fā)送該token_key到PP服務器進行驗證，token_key驗證成功之后才能返回creator，accountId，nickName（具體參考服務端對接文檔），再返回給游戲客戶端。token_key驗證成功回調(diào)Block（如果驗證成功請傳YES|如果驗證成功請傳NO，傳值錯誤會影響后續(xù)流程的正常使用）,也規(guī)定只有token_key驗證成功后才可以進入游戲。游戲端如需綁定游戲角色，請盡量使用creator+accountId。creator+accountId具有唯一性。注注：token_key不可模擬，不可重復驗證，有效期30s 游戲必須接入PP充值系統(tǒng)。接口信息如下表2-5所示：對應SDK商品兌換分為兩種情況：一種是PP幣余額大于等于商品價格的情況（即兌換或者），另一種是PP幣余額小于商品價格的情況。注1、接入PP充值平臺的游戲分為測試狀態(tài)和正式狀態(tài)，新游戲默認情況下是測試狀態(tài)。在測試狀態(tài)下，只能查詢和使用測試幣，只能測試兌換，不可測試充值和充值兌換；在正式狀態(tài)下只能查詢和使用RMB，不能使用測試幣，可測試全部流程。游戲狀態(tài)調(diào)整和測試幣請聯(lián)系PP運營。2、如需要測試需自行申請一個帶中文、數(shù)字、英文的普通PP賬號。3、illite（￥”，“%），可能導致充值失敗。PP第一種情況兌換成功后會有通知回調(diào)給客戶端（ 回調(diào)會返回“成功編碼”）和廠商業(yè)務服務器（回調(diào)給PP配置地址第二種情況會先提示充值（回調(diào)會返回“進入充值并兌換流程注1、接入PP充值平臺的游戲分為測試狀態(tài)和正式狀態(tài)，新游戲默認情況下是測試狀態(tài)。在測試狀態(tài)下，只能查詢和使用測試幣，只能測試兌換，不可測試充值和充值兌換；在正式狀態(tài)下只能查詢和使用RMB，不能使用測試幣，可測試全部流程。游戲狀態(tài)調(diào)整和測試幣請聯(lián)系PP運營。2、如需要測試需自行申請一個帶中文、數(shù)字、英文的普通PP賬號。3、illite（￥”，“%），可能導致充值失敗。PP要在ios9系統(tǒng)下正常打開游戲，游戲必須支持64ios9下網(wǎng)絡失敗，原因是ios9下蘋果要求App內(nèi)的網(wǎng)絡必須使用HTTPS協(xié)議。sdk內(nèi)部是http，現(xiàn)階段不能馬上改成https。最終找到以下解決辦法：在Info.plist中添加NSAppTransportSecurity類型Dictionary在NSAppTransportecurity下添加NSAowsArbtraryLoads類型Boolean,值設為YES如下圖：xcodearchiveitunesipa：xcodebuildxxx.app-搜索xxx.appitunes-再從itunes廠商將接入SDK的游戲包上傳到PP，其他素材按照以下打包規(guī)范打包后通過郵件發(fā)送給PP運營或商務人員。然后等待審核通過上線。IPA包。支持 或IPAD的，請在命名時說明，例如游戲只支持 為XXX. .IPA；IPAD同理；如果是通用包，命名為XXX.ALL.IPA。(具體情況請參照《PP助手SDK注注：通用包 和IPAD自動適配全屏應用截圖，4-10張，jpg格式（320*480，ipad：480*360112、第4ICONPPLOGO 配置的版本號必須和游戲包（ipa包）的BundleVersion一致，ipa包的Bundle，Version設置方法見本文檔圖2-3，圖2-43IE32AppDelegatewindow.rootViewController。再初始化SDK。否則可能導致頁面SDK頁面顯示失敗。UndefinedUndefinedsymbolsforarchitecture_GLOBAL_I_ain“std::ios_base::Init::Int()”,referenced_GLOBAL_I_a_GLOBAL_I_ain將XCode工程中BuildSetting->AppleLLVMcompilerLanguage下的C++LanguageDialect和C++StandardLibrary屬性值修改為CompilerDefault即可；如果遇到一些工程，改變了AppleLLVMcompilerLanguage會導致其他的編譯錯誤，所以還有一種解決辦法是在BuildPhases->LinkbinarywithLibraries中加一個libstdc++.6.dylib就