# P2P接入文檔說明文件 V0.1
## :books:iOS SDK 概述

[](https://i.imgur.com/5gaXOsz.jpg "P2P_SDK")

:::info
從上圖可以了解，P2P SDK包括2個部分，本地HTTP Server，與P2P接口。綠色部分是播放器通過本地HTTP Server請求本地視頻資源，紅色部分是P2P點對點接口進行資源下載與上傳（需 透過資源服務器發布的資源網址），由P2P下載視頻資源至本地存儲空間。再由播放器向HTTP Server請求的視頻資源，達到資源下載的同時可即時播放視頻。
:::

## :closed_book:iOS SDK 集成指南
### SDK 說明

#### 資源文件
包名為 libs-{==版本号==}-sdk-ios-full.zip 例如:libs-v.1.8.18.26-sdk-ios-full.zip
解壓縮後產生libp2p.framework，包含以下目錄或檔案：
1. `_CodeSignature 目錄：mac自動產生的文件`
2. `Headers 目錄：主要頭文件`
3. `Info.plist：plist檔案`
4. `libptp：主要封裝的library`

#### 創建應用
> 輸入相關AppKey才可以進行試用 ==doxstarthttpd(key輸入trial的APP_KEY值)==

### 配置工程
#### 導入SDK方式：`手動導入`

> 請到 WithVideo SDK 網站下載[最新的SDK](http://sdk.xtsdy.com/download.html?LANG=zh-tw "最新的SDK")

- 添加Framework，拉到以下位置
[](https://imgur.com/kSyOt2i.png)

#### 啟動p2p服務
在以下function添加此code

- (BOOL)application:(UIApplication*)applicationdidFinishLaunchingWithOptions:(nullable NSDictionary<UIApplicationLaunchOptionsKey, id> *)launchOptions {

  NSString *dir = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];
  NSString *keyStr = @"APP KEY";
  const char *key = [keyStr UTF8String];
  const char *szdir = [dir UTF8String];
  int http_port = doxstarthttpd((char*)key,(char*)szdir );
  doxsetloglevel(0);
}

#### 下載P2P檔案

NSStringEncoding gbkEncoding = CFStringConvertEncodingToNSStringEncoding (kCFStringEncodingGB_18030_2000);
const char *url = [url cStringUsingEncoding:gbkEncoding];
doxadd(url);

dispatch_group_t group = dispatch_group_create();       
dispatch_group_async(group, dispatch_get_global_queue(0, 0), ^{
  int videoId = doxdownload(url);
});

#### 播放P2P視頻

NSString *urlString = @"ftp://xxxx/xxxxx/xxxxx.mp4";

dispatch_group_t group = dispatch_group_create();
dispatch_group_async(group, dispatch_get_global_queue(0, 0), ^{
  int p2pVid = [p2papi doxstart:urlString];
});

NSString *vod_name = [urlString lastPathComponent];
NSString *localfile = [[[NSMutableString alloc]initWithFormat:@"http://127.0.0.1:%d/",[p2papi getport]] stringByAppendingString:vod_name];

NSStringEncoding gbkEncoding = CFStringConvertEncodingToNSStringEncoding
(kCFStringEncodingGB_18030_2000);

NSURL *url = [NSURL URLWithString:[localfile stringByAddingPercentEscapesUsingEncoding:gbkEncoding]];

ijkplayr.assetURL = url;

## :mag:iOS SDK 接口說明

==int doxstarthttpd(const char * key, const char* content);==

`SDK初始化調用需先啟動HTTP Server才能進行播放下載`

**參數說明**

* key : API KEY值

* content : 資料夾路徑

* int : 本地 http port

---

==int doxadd（const char * url）;==

`下載或播放前視頻都必須加到SDK下載對列，調用此方法才能進行P2P資源分享`

**參數說明**

* url : 視頻的原始網址

* int : 視頻的隊列ID

---

==int doxdownload（const char * url）;==

`下載資源不播放調用此方法，主要在下載列表或清單此方法（需異步調用)`

**參數說明**

* url : 視頻的原始網址

* int : 視頻的隊列ID

---

==int doxstart（const char * url）;==

`播放視頻前調用此方法播放器才能對本地HTTP請求視頻播放，此方法同時會進行資源下載（需異步調用）`

**參數說明**

* url : 視頻的原始網址

* int : 視頻的隊列ID

---

==int doxdel（const char * url）;==

`刪除特定視頻的本地緩存如手機空間不足可調用`

**參數說明**

* url : 視頻的原始網址

* int : 視頻的隊列ID

---

==int doxdelall（void）;==

`清除所有下載的視頻緩存`

---

==getspeed（int t）;==

`獲取視頻下載速度`

**參數說明**

* t : 視頻的隊列 ID

---

==int doxsave（）;==

`保存視頻的進度與狀態 在離開App時調用`

**參數說明**

* int : 視頻的隊列 ID

---

==void dosetupload（int limit）;==

`設置P2P最大上傳速度 需在初始化時調用`

**參數說明**

* int : 最大上傳速度

---

==int doxpause（const char * url）;==

`暫停視頻的下載`

**參數說明**

* url : 視頻的原始網址

* int : 視頻的隊列 ID

---

==int doxcheck（const char * url）;==

`檢查視頻是否已完全下載至本地`

**參數說明**

* url : 視頻的原始網址

* int : 視頻的隊列 ID

---

==std :: string doxgettaskstat（int tt）;==

`獲取視頻下載P2P狀態`

**參數說明**

* tt : 視頻的隊列 ID

* std : 視頻下載狀態字串(下載速度 種子數 檔案大小 已下載大小)

---

==void doxsetloglevel（int level）;==

`Log Info 顯示等級`

**參數說明**

* level : 0~7

---

==getdownsize（int t）;==

`獲取視頻已下載大小(需異步調用)`

**參數說明**

* t : 視頻的隊列 ID

---

==getfilesize（int t）==

`獲取視頻檔案大小`

**參數說明**

* t : 視頻的隊列 ID

---

==int getpercent（int t）;==

`獲取視頻已下載百分比(需異步調用)`

**參數說明**

* t : 視頻的隊列 ID

---

==getlocalfilesize（const char * url）;==

`獲取已下載完成視頻檔案大小`

**參數說明**

* url : 視頻的原始網址

---

**以下暫時不使用**

> int doxterminate（）；
>
> int doxsetduration（int dur）；
>
> int doxShare（const char * url，float lng，float lat）；
>
> const char * doxGetShare（float lng，float lat）；
>
> int endhttpd（）;

---