后端寫好API接口和接口文檔
成都創(chuàng)新互聯(lián)一直在為企業(yè)提供服務(wù),多年的磨煉,使我們在創(chuàng)意設(shè)計(jì),成都全網(wǎng)營銷到技術(shù)研發(fā)擁有了開發(fā)經(jīng)驗(yàn)。我們擅長傾聽企業(yè)需求,挖掘用戶對產(chǎn)品需求服務(wù)價值,為企業(yè)制作有用的創(chuàng)意設(shè)計(jì)體驗(yàn)。核心團(tuán)隊(duì)擁有超過10余年以上行業(yè)經(jīng)驗(yàn),涵蓋創(chuàng)意,策化,開發(fā)等專業(yè)領(lǐng)域,公司涉及領(lǐng)域有基礎(chǔ)互聯(lián)網(wǎng)服務(wù)多線BGP機(jī)房、app軟件定制開發(fā)、手機(jī)移動建站、網(wǎng)頁設(shè)計(jì)、網(wǎng)絡(luò)整合營銷。
iOS客戶端開發(fā)查看文檔
在客戶端發(fā)送API請求,獲取數(shù)據(jù),展示數(shù)據(jù)。
核對數(shù)據(jù)是否符合邏輯、有誤,這就是調(diào)配。
1.接入前準(zhǔn)備
1.1導(dǎo)入SuperSdk庫
導(dǎo)入SuperSdk庫SuperSdk.framework
將SuperSdk.framework拷貝到項(xiàng)目開發(fā)目錄下,然后將SuperSdk.framework拖拽到工程的Frameworks目錄下,彈出如 下圖對話框所示(注意勾選),點(diǎn)擊Finish。
1.2 添加SuperSdk.Framework版本號
在項(xiàng)目的info.plist文件里,增加一項(xiàng)用于標(biāo)識SuperSDK版本號的值, key為sp_version,對應(yīng)的value值為當(dāng)前接入SuperSdk.framework的版本。
SuperSdk.framework的版本號請查看下載的資源包中的README.txt
1.3在工程中添加依賴庫
在Xcode → Target → Build Phrases →Link Binary WithLibraries中添加以下依賴庫
Foundation.framework
UIKit.framework
AdSupport.framework
SystemConfiguration.framework
CoreTelephony.framework
libstdc++.6.dylib
libsqlite3.dylib
注:將AdSupport.framework的status改為optional
1.4 修改工程配置,添加庫的鏈接參數(shù)
在工程配置里面,找到Linking部分,修改Other Linker Flags,添加以下內(nèi)容
-ObjC
1.5 引用SuperSdk
#import SuperSdk/SuperSdkOpenApi.h//接口
#import SuperSdk/SuperSdkGameData.h//游戲數(shù)據(jù)類
#importSuperSdk/SuperSdkDefines.h//接口回調(diào)方法以及參數(shù)和錯誤碼說明
1.6接入母包SDK
為方便游戲開發(fā)聯(lián)調(diào),SuperSDK iOS開發(fā)包中有母包SDK,具備登錄、支付等功能。游戲只需接入母包SDK即可聯(lián)調(diào)登錄、支付、注銷、懸浮框等所有功能,只要保證SuperSDK母包正確接入,即可用打包工具一鍵生成各渠道工程。
1.6.1 添加母包SDK和資源
將從SuperSDK官網(wǎng)下載的iOS開發(fā)包解開,找到母包SDK,如下圖所示。然后將libs文件夾下的文件(SuperSdkImp.a)和res文件下的文件SuperSdk.bundle拖動到xcode工程目錄下并引用到工程中。
1.6.2 配置母包參數(shù)
打開打包工具,將支付通知地址和母包自定義參數(shù)配置好,自定義參數(shù)可向運(yùn)營獲取,支付通知地址為游戲的服務(wù)器地址,可向游戲后端獲取,然后下載母包配置文件并將引用到工程中的SuperSdk.bundle里的spsdk_config.json和sp_config.json文件替換成母包的配置文件(覆蓋)。
1.6.3 增加測試賬號和支付金額
(1)打開管理后臺,輸入賬號和密碼,登陸到管理后臺
(2)添加測試賬號,并給測試賬號增加測試金額。測試賬號是母包登陸的時候使用,測試金額是母包支付時使用。
1.6.4 工程配置(Xcode7環(huán)境需要設(shè)置)
(1)關(guān)閉AppTransportSecurity。在 Info.plist 添加字段如下
(2)需關(guān)閉Bitcode,在Target → Build Settings → Build Options → Enable Bitcode
2.SuperSdk基礎(chǔ)接口(必接)
2.1創(chuàng)建單例
接口定義
+ (SuperSdkOpenApi*)sharedInstance;
調(diào)用示例
[SuperSdkOpenApi sharedInstance];
2.2初始化
(1)調(diào)用初始化接口:
注:調(diào)用初始化回調(diào)接口,調(diào)用之前游戲必須暫停, 等待初始化成功回調(diào),SDK初始化成功后會緊接著進(jìn)行整包更新檢查,會有一個整包更新檢查回調(diào)。游戲自身初始化和版本檢查請放在SDK對游戲進(jìn)行整包更新檢查回調(diào)后執(zhí)行。
接口定義
-(void)initPlatformWithDeleagte:(idSuperSdkOpenApiDelegate) delegate withSuperSdkUrlType:(SuperSdkUrlType)type;
參數(shù)含義
delegate 被委托對象,用于實(shí)現(xiàn)回調(diào)
type 用于區(qū)分訪問域名的類型,SuperSDK與SuperSDK服務(wù)器交互的域名類型及順序。目前取值范圍:SuperSdkUrlTypeDomestic 對應(yīng)值為0 表示國內(nèi);SuperSdkUrlTypeForeign 對應(yīng)值為1 表示國外,請求北美域名優(yōu)先;SuperSdkUrlTypeForeignTW 對應(yīng)值為2 表示國外,請求臺灣域名優(yōu)先;SuperSdkUrlTypeForeignUK 對應(yīng)值為3 表示國外,請求歐洲域名優(yōu)先。
調(diào)用示例
|[[SuperSdkOpenApi sharedInstance] initPlatformWithDeleagte:self withSuperSdkUrlType:SuperSdkUrlTypeDomestic];|
(2)初始化回調(diào)
回調(diào)方法
|- (void) OPInitFinish:(int)ret withParam:(NSString *)param;|
回調(diào)參數(shù)含義
ret OP_SUCCESS表示初始化成功,其他表示失敗 SDK初始化成功。游戲需要等待SDK對游戲進(jìn)行整包更新檢查的回調(diào),SDK初始化失敗,游戲需要給出玩家初始化失敗的提示
param 初始化返回的額外數(shù)據(jù),一般為空
回調(diào)示例
- (void) OPInitFinish:(int)ret withParam:(NSString *)param
{
if (ret == OP_SUCCESS) {
//初始化成功
} else {
//初始化失敗
}
}
(3)檢查版本回調(diào)
初始化成功后會緊接著進(jìn)行版本檢查,版本檢查完畢會有版本檢查回調(diào)。
回調(diào)方法
- (void) OPCheckVersion:(int)ret withParam:(NSString *)param;
回調(diào)參數(shù)含義
ret OP_CHECK_WITH_NEW_VERSION表示表示調(diào)用了SDK整包更新檢查接口,并且檢測到游戲有新版本,游戲應(yīng)該停住等待游戲整包更新結(jié)束
- OP_CHECK_WITHOUT_NEW_VERSION表示調(diào)用了SDK整包更新檢查接口,并且檢測到游戲沒有新版本,游戲繼續(xù)執(zhí)行
- OP_CHECK_WITHOUT_CHECK_VERSION表示無SDK整包更新檢查接口,游戲做自己的版本更新邏輯
param 額外返回?cái)?shù)據(jù),一般為空
回調(diào)示例
- (void) OPCheckVersion:(int)ret withParam:(NSString *)param
{
switch (ret) {
case OP_CKECK_WITH_NEW_VERSION:
str = @"有更新";
break;
case OP_CHECK_WITHOUT_NEW_VERSION:
str = @"沒有新版本";
break;
case OP_CHECK_WITHOUT_CHECK_VERSION:
str = @"沒有更新接口";
break;
default:
break;
}
}
你可以用蘋果原生的方法,NSUrl,request,...四個步驟 當(dāng)然實(shí)際的開發(fā)中可能這么寫的 隨著XML格式的不更新 json格式廣泛應(yīng)用 AFNetWorking框架廣泛應(yīng)用,在Github上面搜索 下載安裝 之后按照文檔就能調(diào)取api接口 實(shí)際開發(fā)中 項(xiàng)目量非常大 舉個例子:如果你做的是電商項(xiàng)目 一個借口中有500商品 每個商品有20個屬性 你不可能去一一的根據(jù)索引進(jìn)行查找,以為數(shù)據(jù)量太大了 這是我們就應(yīng)該用json-》model這種思想 把json編程對象里面的屬性 方便我們?nèi)〔檎? 這就是實(shí)際開發(fā)中網(wǎng)絡(luò)框架的思想
查一下FMDB的文檔,里面有這一個例子:
[quote]
FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
int totalCount = [s intForColumnIndex:0];
}
[/quote
這不就有了。
一、網(wǎng)絡(luò)各個協(xié)議:TCP/IP、SOCKET、HTTP等
網(wǎng)絡(luò)七層由下往上分別為物理層、數(shù)據(jù)鏈路層、網(wǎng)絡(luò)層、傳輸層、會話層、表示層和應(yīng)用層。
其中物理層、數(shù)據(jù)鏈路層和網(wǎng)絡(luò)層通常被稱作媒體層,是網(wǎng)絡(luò)工程師所研究的對象;
傳輸層、會話層、表示層和應(yīng)用層則被稱作主機(jī)層,是用戶所面向和關(guān)心的內(nèi)容。
http協(xié)議對應(yīng)于應(yīng)用層
tcp協(xié)議對應(yīng)于傳輸層
ip協(xié)議對應(yīng)于網(wǎng)絡(luò)層
三者本質(zhì)上沒有可比性。 何況HTTP協(xié)議是基于TCP連接的。
TCP/IP是傳輸層協(xié)議,主要解決數(shù)據(jù)如何在網(wǎng)絡(luò)中傳輸;而HTTP是應(yīng)用層協(xié)議,主要解決如何包裝數(shù)據(jù)。
我 們在傳輸數(shù)據(jù)時,可以只使用傳輸層(TCP/IP),但是那樣的話,由于沒有應(yīng)用層,便無法識別數(shù)據(jù)內(nèi)容,如果想要使傳輸?shù)臄?shù)據(jù)有意義,則必須使用應(yīng)用層 協(xié)議,應(yīng)用層協(xié)議很多,有HTTP、FTP、TELNET等等,也可以自己定義應(yīng)用層協(xié)議。WEB使用HTTP作傳輸層協(xié)議,以封裝HTTP文本信息,然 后使用TCP/IP做傳輸層協(xié)議將它發(fā)送到網(wǎng)絡(luò)上。Socket是對TCP/IP協(xié)議的封裝,Socket本身并不是協(xié)議,而是一個調(diào)用接口(API),通過Socket,我們才能使用TCP/IP協(xié)議。
二、Http和Socket連接區(qū)別
相信不少初學(xué)手機(jī)聯(lián)網(wǎng)開發(fā)的朋友都想知道Http與Socket連接究竟有什么區(qū)別,希望通過自己的淺顯理解能對初學(xué)者有所幫助。
2.1、TCP連接
要想明白Socket連接,先要明白TCP連接。手機(jī)能夠使用聯(lián)網(wǎng)功能是因?yàn)槭謾C(jī)底層實(shí)現(xiàn)了TCP/IP協(xié)議,可以使手機(jī)終端通過無線網(wǎng)絡(luò)建立TCP連接。TCP協(xié)議可以對上層網(wǎng)絡(luò)提供接口,使上層網(wǎng)絡(luò)數(shù)據(jù)的傳輸建立在“無差別”的網(wǎng)絡(luò)之上。
建立起一個TCP連接需要經(jīng)過“三次握手”:
第一次握手:客戶端發(fā)送syn包(syn=j)到服務(wù)器,并進(jìn)入SYN_SEND狀態(tài),等待服務(wù)器確認(rèn);
第二次握手:服務(wù)器收到syn包,必須確認(rèn)客戶的SYN(ack=j+1),同時自己也發(fā)送一個SYN包(syn=k),即SYN+ACK包,此時服務(wù)器進(jìn)入SYN_RECV狀態(tài);
第三次握手:客戶端收到服務(wù)器的SYN+ACK包,向服務(wù)器發(fā)送確認(rèn)包ACK(ack=k+1),此包發(fā)送完畢,客戶端和服務(wù)器進(jìn)入ESTABLISHED狀態(tài),完成三次握手。
握
手過程中傳送的包里不包含數(shù)據(jù),三次握手完畢后,客戶端與服務(wù)器才正式開始傳送數(shù)據(jù)。理想狀態(tài)下,TCP連接一旦建立,在通信雙方中的任何一方主動關(guān)閉連
接之前,TCP
連接都將被一直保持下去。斷開連接時服務(wù)器和客戶端均可以主動發(fā)起斷開TCP連接的請求,斷開過程需要經(jīng)過“四次握手”(過程就不細(xì)寫了,就是服務(wù)器和客
戶端交互,最終確定斷開)
2.2、HTTP連接
HTTP協(xié)議即超文本傳送協(xié)議(HypertextTransfer Protocol ),是Web聯(lián)網(wǎng)的基礎(chǔ),也是手機(jī)聯(lián)網(wǎng)常用的協(xié)議之一,HTTP協(xié)議是建立在TCP協(xié)議之上的一種應(yīng)用。
HTTP連接最顯著的特點(diǎn)是客戶端發(fā)送的每次請求都需要服務(wù)器回送響應(yīng),在請求結(jié)束后,會主動釋放連接。從建立連接到關(guān)閉連接的過程稱為“一次連接”。
1)在HTTP 1.0中,客戶端的每次請求都要求建立一次單獨(dú)的連接,在處理完本次請求后,就自動釋放連接。
2)在HTTP 1.1中則可以在一次連接中處理多個請求,并且多個請求可以重疊進(jìn)行,不需要等待一個請求結(jié)束后再發(fā)送下一個請求。
由
于HTTP在每次請求結(jié)束后都會主動釋放連接,因此HTTP連接是一種“短連接”,要保持客戶端程序的在線狀態(tài),需要不斷地向服務(wù)器發(fā)起連接請求。通常的
做法是即時不需要獲得任何數(shù)據(jù),客戶端也保持每隔一段固定的時間向服務(wù)器發(fā)送一次“保持連接”的請求,服務(wù)器在收到該請求后對客戶端進(jìn)行回復(fù),表明知道客
戶端“在線”。若服務(wù)器長時間無法收到客戶端的請求,則認(rèn)為客戶端“下線”,若客戶端長時間無法收到服務(wù)器的回復(fù),則認(rèn)為網(wǎng)絡(luò)已經(jīng)斷開。
三、SOCKET原理
3.1、套接字(socket)概念
套接字(socket)是通信的基石,是支持TCP/IP協(xié)議的網(wǎng)絡(luò)通信的基本操作單元。它是網(wǎng)絡(luò)通信過程中端點(diǎn)的抽象表示,包含進(jìn)行網(wǎng)絡(luò)通信必須的五種信息:連接使用的協(xié)議,本地主機(jī)的IP地址,本地進(jìn)程的協(xié)議端口,遠(yuǎn)地主機(jī)的IP地址,遠(yuǎn)地進(jìn)程的協(xié)議端口。
應(yīng)
用層通過傳輸層進(jìn)行數(shù)據(jù)通信時,TCP會遇到同時為多個應(yīng)用程序進(jìn)程提供并發(fā)服務(wù)的問題。多個TCP連接或多個應(yīng)用程序進(jìn)程可能需要通過同一個
TCP協(xié)議端口傳輸數(shù)據(jù)。為了區(qū)別不同的應(yīng)用程序進(jìn)程和連接,許多計(jì)算機(jī)操作系統(tǒng)為應(yīng)用程序與TCP/IP協(xié)議交互提供了套接字(Socket)接口。應(yīng)
用層可以和傳輸層通過Socket接口,區(qū)分來自不同應(yīng)用程序進(jìn)程或網(wǎng)絡(luò)連接的通信,實(shí)現(xiàn)數(shù)據(jù)傳輸?shù)牟l(fā)服務(wù)。
3.2 、建立socket連接
建立Socket連接至少需要一對套接字,其中一個運(yùn)行于客戶端,稱為ClientSocket,另一個運(yùn)行于服務(wù)器端,稱為ServerSocket。
套接字之間的連接過程分為三個步驟:服務(wù)器監(jiān)聽,客戶端請求,連接確認(rèn)。
服務(wù)器監(jiān)聽:服務(wù)器端套接字并不定位具體的客戶端套接字,而是處于等待連接的狀態(tài),實(shí)時監(jiān)控網(wǎng)絡(luò)狀態(tài),等待客戶端的連接請求。
客戶端請求:指客戶端的套接字提出連接請求,要連接的目標(biāo)是服務(wù)器端的套接字。為此,客戶端的套接字必須首先描述它要連接的服務(wù)器的套接字,指出服務(wù)器端套接字的地址和端口號,然后就向服務(wù)器端套接字提出連接請求。
連
接確認(rèn):當(dāng)服務(wù)器端套接字監(jiān)聽到或者說接收到客戶端套接字的連接請求時,就響應(yīng)客戶端套接字的請求,建立一個新的線程,把服務(wù)器端套接字的描述發(fā)給客戶
端,一旦客戶端確認(rèn)了此描述,雙方就正式建立連接。而服務(wù)器端套接字繼續(xù)處于監(jiān)聽狀態(tài),繼續(xù)接收其他客戶端套接字的連接請求。
3.3、SOCKET連接與TCP連接
創(chuàng)建Socket連接時,可以指定使用的傳輸層協(xié)議,Socket可以支持不同的傳輸層協(xié)議(TCP或UDP),當(dāng)使用TCP協(xié)議進(jìn)行連接時,該Socket連接就是一個TCP連接。
3.4、Socket連接與HTTP連接
由
于通常情況下Socket連接就是TCP連接,因此Socket連接一旦建立,通信雙方即可開始相互發(fā)送數(shù)據(jù)內(nèi)容,直到雙方連接斷開。但在實(shí)際網(wǎng)絡(luò)應(yīng)用
中,客戶端到服務(wù)器之間的通信往往需要穿越多個中間節(jié)點(diǎn),例如路由器、網(wǎng)關(guān)、防火墻等,大部分防火墻默認(rèn)會關(guān)閉長時間處于非活躍狀態(tài)的連接而導(dǎo)致
Socket 連接斷連,因此需要通過輪詢告訴網(wǎng)絡(luò),該連接處于活躍狀態(tài)。
而HTTP連接使用的是“請求—響應(yīng)”的方式,不僅在請求時需要先建立連接,而且需要客戶端向服務(wù)器發(fā)出請求后,服務(wù)器端才能回復(fù)數(shù)據(jù)。
很
多情況下,需要服務(wù)器端主動向客戶端推送數(shù)據(jù),保持客戶端與服務(wù)器數(shù)據(jù)的實(shí)時與同步。此時若雙方建立的是Socket連接,服務(wù)器就可以直接將數(shù)據(jù)傳送給
客戶端;若雙方建立的是HTTP連接,則服務(wù)器需要等到客戶端發(fā)送一次請求后才能將數(shù)據(jù)傳回給客戶端,因此,客戶端定時向服務(wù)器端發(fā)送連接請求,不僅可以
保持在線,同時也是在“詢問”服務(wù)器是否有新的數(shù)據(jù),如果有就將數(shù)據(jù)傳給客戶端。
這里我們使用Socket實(shí)現(xiàn)一個聊天室的功能,關(guān)于服務(wù)器這里的就不介紹了
@interfaceViewController (){
NSInputStream *_inputStream;//對應(yīng)輸入流
NSOutputStream *_outputStream;//對應(yīng)輸出流
}
@property (weak, nonatomic) IBOutlet NSLayoutConstraint *inputViewConstraint;
@property (weak, nonatomic) IBOutlet UITableView *tableView;
@property (nonatomic, strong) NSMutableArray *chatMsgs;//聊天消息數(shù)組
@end
懶加載這個消息數(shù)組
//從主運(yùn)行循環(huán)移除
//1.建立連接
//定義C語言輸入輸出流
//把C語言的輸入輸出流轉(zhuǎn)化成OC對象
//設(shè)置代理
//把輸入輸入流添加到主運(yùn)行循環(huán)
//不添加主運(yùn)行循環(huán) 代理有可能不工作
//打開輸入輸出流
//登錄
//發(fā)送用戶名和密碼
//在這里做的時候,只發(fā)用戶名,密碼就不用發(fā)送
//如果要登錄,發(fā)送的數(shù)據(jù)格式為 "iam:zhangsan";
//如果要發(fā)送聊天消息,數(shù)據(jù)格式為 "msg:did you have dinner";
//登錄的指令11NSString *loginStr =@"iam:zhangsan";
//把Str轉(zhuǎn)成NSData
//建立一個緩沖區(qū) 可以放1024個字節(jié)
//返回實(shí)際裝的字節(jié)數(shù)
//把字節(jié)數(shù)組轉(zhuǎn)化成字符串
//從服務(wù)器接收到的數(shù)據(jù)
//聊天信息
//刷新表格
//發(fā)送數(shù)據(jù)
//發(fā)送完數(shù)據(jù),清空textField
//數(shù)據(jù)多,應(yīng)該往上滾動
}
//監(jiān)聽鍵盤
//獲取窗口的高度
//鍵盤結(jié)束的Frm
//獲取鍵盤結(jié)束的y值
工具/原料
電腦
EyeKey人臉識別接口服務(wù)
方法/步驟
訪問EyeKey 。進(jìn)入“開發(fā)中心”,注冊EyeKey賬號并登陸。
進(jìn)入“開發(fā)中心”后,可通過“快速開始”向?qū)?,了解接口調(diào)用流程及說明;
通過“API文檔”查看所有人臉識別接口文檔;
通過“SDK下載”下載所需的SDK開發(fā)包
了解基本流程說明后,即可正式調(diào)用接口進(jìn)行開發(fā)。首先要創(chuàng)建一個應(yīng)用
應(yīng)用創(chuàng)建成功后,會得到一組唯一的APP ID和APP KEY。這將是你調(diào)用接口進(jìn)行開發(fā)的通行證。
接口文檔中的所有人臉識別接口都可以調(diào)用,這里以人臉檢測的checking接口為例——
!DOCTYPE html
html
head
meta charset="utf-8"
title人臉檢測/title
meta name="keywords" content="關(guān)鍵字" /
meta name="description" content="此網(wǎng)頁描述" /
/head
body
form action=" /face/Check/checking" method="post"
!-- 注意這里需要配置調(diào)用接口的地址,同時method要標(biāo)示出請求的方式,根據(jù)接口定義這里是post方式 --
input type="text" name="app_id" size="80" value="獲取的appID" /br/
input type="text" name="app_key" size="80" value="獲取的appKEY" /br/
input type="text" name="img" size="80" value="經(jīng)過base64編碼的圖片" /
br/
input type="submit" value="提交"/
/form
/body
/html
文章題目:ios開發(fā)接口文檔,ios開發(fā)基礎(chǔ)
本文網(wǎng)址:http://aaarwkj.com/article22/dsspjjc.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供網(wǎng)站內(nèi)鏈、網(wǎng)站排名、建站公司、域名注冊、微信小程序、品牌網(wǎng)站建設(shè)
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)