无卡DRM终端SDK接口使用手册.docVIP

航天数字传媒无卡DRM终端SDK接口使用手册  项目经理： 赵海丽 合作厂家： 文档作者： 杨永 版本号： V1.2 审 核： 日 期： 2015-03-12  文档说明 本文档详细描述了无卡DRM客户端SDK接口，旨在双方顺利实现集成提供指导和依据。 本文档仅限于在航天数字传媒有限公司及授权的终端厂商内部公开，任何人不得擅自向外公开。任何其他人员因特殊需要得到此文档之后，不得擅自传递，否则将追究法律责任。 本文档的解释权属于航天数字传媒有限公司。 历史记录 序号 变更（+/-）说明 作者 版本号 日期 审核 1 新建 杨永 V0.1 2014.06.30 2 修改 杨永 V0.2 2014.11.23 3 修改成纯互联网环境版本 杨永 V1.0 2015.03.12 注：初始版本号定为0.1，审核通过基线版本为1.0，可进行归档。1.0及以上版本修改需要进行审批。目 录 文档说明 3 历史记录 3 目录 4 1 接口形式 5 2 使用环境要求 5 3 数据类型约定 5 4 接口说明 6 5 相关数据说明 18 6 错误码定义 19 7 时间格式说明 20 8 附录 21 1.接口形式 本SDK采用C语言开发，SDK以SO库以及头文件的形式向外发布，厂商需要加载SO库并实现OEM部分接口，方可调用DBS接口实现无卡DRM客户端功能。 2.使用环境要求 目前SDK使用环境为linux平台与windows平台。 移植终端自身为linux系统，终端厂商需要提供交叉编译环境，由我方交叉编译之后提供库以及对应头文件。 移植终端为android平台，我方默认采用必威体育精装版android ndk编译，终端厂商也可以提供交叉编译环境，由我方编译后提供库文件以及头文件。 移植终端为windows平台，我方直接提供库文件以及头文件。 我方提供的SDK不论什么平台都需要openssl的支持，目前使用0.9.8版本。 3.数据类型约定 UINT8 8位无符号整型数据 UINT16 16位无符号整型数据 UINT32 32位无符号整形数据 UINT64 64位无符号整形数据 CHAR 8位字符型数据 INT16 16位有符号整形数据 INT32 32位有符号整形数据 INT64 64位有符号整形数据 VOID 32位空类型 4.接口说明 以下接口为OEM接口，厂商必须实现。 获取设备ID 【原型】 INT32 OemGetSN(VOID * vOem, UINT8 * sn) 【功能要求】 获取设备ID号，该号码为设备出厂时烧写序列号，作为设备的唯一标志，该序列为6字节，每个字节取值范围均为0-255。在SDK库调用该接口之前，sn内存已经分配，函数实现只需找到设备的ID，拷贝给sn为起始地址的连续6个字节即可。 如果码值过长或过短，请自行截断，或者补0。 该接口必须实现，不同的设备调用该函数返回的值必须不同。 【参数】 vOem - 输入参数，OEM厂商自行定义的结构体，见相关数据说明章节。 SN - 输出参数，SN长度固定为16字节，内存已经分配，只需对其赋值。 【返回值】 返回值整数类型，如果返回0代表成功，非0代表失败。 打开主加密文件 【原型】 INT32 OemOpen(VOID * vOem) 【功能要求】 打开主加密文件。 【参数】 vOem - 输入参数，OEM厂商自行定义的结构体，见相关数据说明章节。 【返回值】 返回值整数类型，成功返回0，失败返回非0。 读主加密文件 【原型】 INT32 OemRead(VOID * vOem, UINT8 * pbBuf, INT32 iBufLen) 【功能要求】 读取主加密文件内容。 【参数】 vOem - 输入参数，OEM厂商自行定义的结构体，见相关数据说明章节。 pbBuf - 输出参数，读取文件数据存放的首地址。 iBufLen - 输入参数，要读取的文件数据的长度。 【返回值】 返回值整数类型，返回实际读取数据数据长度。 设置主加密文件指针偏移位置 【原型】 INT64 OemSeek(VOID * vOem , INT64 lPos , INT32 FromWhere) 【功能要求】 偏移主加密文件的文件指针。 【参数】 vOem - 输入参数，OEM厂商自行定义的结构体，见相关数据说明章节。 lPos - 输入参数，加密媒体文件指针偏移量。 FromWhere -