# Client-SDK

**Repository Path**: cwinging/Client-SDK

## Basic Information

- **Project Name**: Client-SDK
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-02-01
- **Last Updated**: 2021-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

* minihttpd-libcurl 之前基于这个测试修改
* libevent-libcurl  确定新的架构及基础类库，@zitao后续代码提交到此目录下


### Bug fix
* [evhttp_send_reply_chunk do not send chunk until calling evhttp_send_reply_end](https://github.com/libevent/libevent/issues/536)
* 不能一次接收所有数据

```
size_t get_json_cb(char *buffer, size_t size, size_t nitems, void *userdata) {
    strcpy(userdata, buffer);
    return 1; ---> return size*nitems;
}
```

### Android API 参考（https://www.agora.io/cn/）

```
RtcEngine rtcEngine = RtcEngine.create(mContext, appId, mEngineEventHandler.mRtcEventHandler);
rtcEngine.joinChannel(null, channel, "Extraoptional data", uid);
mRtcEngine.leaveChannel();
```

## 基于HTTP/HTTPS多源P2P流媒体播放器


### 整体架构

客户端整体架构及流程如下：通过一个本地的HTTP Server(127.0.0.1),播放器端所有的数据请求都经过本地服务(至少要Hook HEAD GET请求，GET请求要支持Range参数)，客制化的HTTP Server去后台请求数据数据喂给播放器，最大程度的解耦各个模块。

![client architecture](fig/client_architecture.png)



### REST API

1. 登录返回Token,请求节点的时候需要此Token做为安全验证。通过调用我们提供的API接口（/v1/customer/login）并传入用户名和密码， 我们已经为访客提供了测试帐号（用户名：test　密码：123456），获取token的示例代码如下:

```
r=`curl  -X POST https://api.webrtc.win:6601/v1/customer/login \
  -H "Content-Type:application/json" \
  -d '{
    "user": "test",
    "password":  "123456"
   }'`
```

2. 请求节点列表，后台服务器会返回N个有效节点

请求节点：

```
r=`curl -X GET "https://api.webrtc.win:6601/v1/customer/nodes?client_ip=127.0.0.1&host=qq.webrtc.win&uri=${file}&md5=ab340d4befcf324a0a1466c166c10d1d" \
  -H "X-Pear-Token: ${token}" \
  -H "Content-Type:application/json"`
```

返回节点：

```
{
  "nodes": [
    {
      "protocol": "https",
      "host": "000c29d049f4.webrtc.win:65526",
      "type": "node"
    },
    {
      "protocol": "https",
      "host": "2076933cdd51.webrtc.win:34038",
      "type": "node"
    },
    {
      "protocol": "https",
      "host": "5254005d31ff.webrtc.win:4582",
      "type": "server"
    }
  ]
}
```

### 下载策略和流程(First-Aid算法，@xt补充)

* 获取节点列表，视频文件大小，算出文件固定码率(动态计算需要下载的部分文件)
* 根据码率和buffer大小算出窗口大小
* 向后台请求http节点和data channel
* 节点按照节点质量排序，抛弃不能连通的节点
* 优质节点下载紧急部分，其它部分依次排序
* 触发下一个下载周期
    * 剩余播发时间超过阈值
    * 用户拖动播放条（支持seek）
    * 定时器
* 支持节点打分和淘汰机制
* 所有节点的失效的情况，直接回源请求该视频文件或者重新请求节点列表(此情况极端情况下发生)
* 支持本地PC 浏览器和ffplay
* 移植到Android/Iphone,支持ijkplay播放
* 集成WebRTC datachannel通道，需要wulei配合。(janus <--> janus之间的连接)


参考Browser流程图：
![流程](http://git.oschina.net/FogVDN/general-doc/raw/master/%E7%B3%BB%E7%BB%9F%E6%9E%B6%E6%9E%84%E5%92%8CVisio%E5%8E%9F%E5%9B%BE/PearPlayer%E6%9E%B6%E6%9E%84%E5%8F%8A%E6%B5%81%E7%A8%8B.png)


具体原理图参考：
![First-Aid](fig/firstaid.png)

参考Browser端达到的效果（Chrome测试结果）：
![First-Aid](fig/pearplayer.png)