libcurl 基本使用

libcurl，在HLS流媒体播放终端上提供HTTP下载的相关接口。具体的使用方式可以参见http://curl.haxx.se/libcurl/c/libcurl-tutorial.html，或博客http://www.cppblog.com/tx7do/archive/2012/02/19/166011.html。

代码：

1. m_pCurl = curl_easy_init();
2. if (m_pCurl == NULL)
3. break;
4. curl_easy_reset(m_pCurl);
5. curl_easy_setopt(m_pCurl, CURLOPT_URL, url.c_str());
6. curl_easy_setopt(m_pCurl, CURLOPT_FOLLOWLOCATION, 1);
7. curl_easy_setopt(m_pCurl, CURLOPT_CONNECTTIMEOUT, 3);
8. //curl_easy_setopt(m_pCurl, CURLOPT_TIMEOUT, 30);
9. curl_easy_setopt(m_pCurl, CURLOPT_NOSIGNAL, 1L);
10. //curl_easy_setopt(m_pCurl, CURLOPT_LOW_SPEED_LIMIT, 1);
11. //curl_easy_setopt(m_pCurl, CURLOPT_LOW_SPEED_TIME, 120);    // 120s的时间内速度小于1byte/s,则取消下载
12. curl_easy_setopt(m_pCurl, CURLOPT_WRITEFUNCTION, writeTsData_Local);
13. curl_easy_setopt(m_pCurl, CURLOPT_WRITEDATA, (LPVOID)this);
14. m_downloadThreadFlag = true;
15. retCode = curl_easy_perform(m_pCurl);
16. double downloadTotalTime;   // 记录下载的时间长度
17. double downloadSpeed;// 记录下载速度
18. CURLcode re = curl_easy_getinfo(m_pCurl, CURLINFO_SPEED_DOWNLOAD, &downloadSpeed);  // 获取下载速度
19. curl_easy_getinfo(m_pCurl, CURLINFO_TOTAL_TIME, &downloadTotalTime);
20. curl_easy_cleanup(m_pCurl);

1、void curl_easy_reset(CURL *handle );  重置CURL

2、CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);

CURLOPT_URL，添加下载的URL

CURLOPT_WRITEFUNCTION， 设置回调存储数据函数

CURLOPT_CONNECTTIMEOUT， 设置连接超时时间

CURLOPT_LOW_SPEED_LIMIT， 设置最低下载速度

CURLOPT_LOW_SPEED_TIME， 设置最低下载速度持续的时间

CURLOPT_FOLLOWLOCATION， 设置为1，否则会导致回调函数只执行一次

3、CURLcode curl_easy_perform(CURL * handle );   启动下载

4、CURLcode curl_easy_getinfo(CURL *curl, CURLINFO info, ...); 可以获取下载的相关信息，如下载时长、下载速度等。

5、void curl_easy_cleanup(CURL *curl); 关闭CURL

主要使用的就是这五个函数。建议在connectTimeOut不要设置时间过长。如果设置太长后，有时会导致退出时程序挂起现象。获取下载相关信息getInfo是必要的，可以通过它来判断程序网络连接情况。如下载时长远远大于片段播放时长，且缓存中存储的量过少时，则需要调用Pause进行数据缓冲。当下载速度为0 b/s时，则需要提示用户检测网络。

以下是数据接收的回调函数：

1. size_t TsDataThread::writeTsData_Local(void *buffer, size_t size, size_t nmemb, void *userp)
2. {
3. if (false == downloadflag || true == isStop)
4. return 0;
5. if (elementSize >= preElementSize)
6. {
7. TsDataThread* pUDPReader = (TsDataThread*)userp;
8. pUDPReader->addBuff(buffer, size, nmemb, userp);
9. elementSize += nmemb;
10. }
11. return size*nmemb;
12. }

要注意如果用户中途退出，且下载线程仍再继续时，不能强制关闭CURL。通过回调中返回0值，使其正常退出CURL。还有就是如果第一次下载片度在elementSize位置处，下载失败。则在第二次下载时一定要从elementSize位置存储数据。否则播放效果将有很大的影响。