Skip to content
hutuyingxiong edited this page Mar 11, 2019 · 5 revisions

UCDMediaPlayer iOS SDK使用手册

阅读对象

本文档面向开发人员、测试人员及对此感兴趣的其他用户,使用该 SDK 需具备基本的 iOS 开发能力。

1. 概述

UCDMediaPlayer基于IJKPlayer二次开发音视频媒体播放SDK,SDK提供了开放的音视频播放、控制接口和完整的开源调用示例,极大地降低开发门槛,并且支持客户快速接入发布产品。
UCDMediaPlayer_iOS为iOS开发者提供简单、快捷的接口,帮助开发者实现iOS平台上的多媒体播放应用。

2. 功能特性

  • 支持 RTMP、HLS、HTTP-FLV、RTSP 等协议
  • 支持speex音频播放
  • 支持累积延迟消除(RTMP和HTTP+FLV),降低观看直播的观众延迟
  • 支持H.265/HEVC播放
  • 本地全媒体格式支持, 并对主流的媒体格式(mp4, flv, mkv, mov, rmvb 等 )进行优化;
  • 包含armv7、arm64、i386、x86_64指令集
  • 支持直播首屏秒开
  • 支持直播、点播播放
  • 支持软解、硬解切换
  • 支持点播多清晰度切换
  • 支持画幅调整
  • 支持全屏、非全屏切换
  • 支持屏幕亮度调节
  • 支持音量调节
  • 支持播放进度拖拽操作

相比于直播,点播支持了更丰富的封装格式和音视频编解码格式,二者支持的具体功能如下:

直播 点播
流协议 HLS, RTMP, HTTP, HTTPS, RTSP HLS, RTMP, HTTP, RTSP, HTTPS
封装格式 FLV, TS, MPEG, MOV, M4V, MP3 FLV, TS, MPEG, MOV, M4V, MP3, GIF, MKV
视频编码格式 H264, H265, MPEG4 H263, H264, H265, MPEG2, MPEG4, MJPEG
音频编码格式 AAC, MP3, SPEEX AAC, MPEG(MP1/MP2/MP3), AC3, PCM, OGG, WMA, SPEEX

3 开发准备

3.1 运行环境

  • 最低支持iOS版本:iOS 7.0
  • 最低支持iPhone型号:iPhone 4
  • 运行设备: iPhone/iPod Touch/iPad
  • 支持CPU架构: armv7,arm64(和i386,x86_64模拟器)

3.2 下载工程

git clone https://github.com/umdk/UCDMediaPlayer_iOS.git --depth 1

目录结构:

  • demo : UCDMediaPlayer演示demo,展示本SDK的主要接口使用
  • docs/docset : appleDoc风格接口文档,安装后可在Xcode中直接查看,亦可在Dash APP上查看使用
  • docs/html : appleDoc风格网页版接口文档,可直接点击index.html查看
  • lib/Player : 播放器静态库和相关头文件
  • PlayerUI : 播放器UI及其管理器类,用户可自行修改使用

4. 快速集成

快速集成中提供了集成播放SDK的基本方法。 具体可以参考demo工程中的相应文件。

5. 注意

  • 本静态库可能与其他使用了FFmpeg的静态库冲突,可使用动态库解决问题
  • 本SDK为静态库,虽然库的大小为20M+,但是最后生成的APP增量只有3M+。

6. 反馈与建议