Microsoft Word - iOS媒体播放器深度开发版SDK文档.05301736.docx

ios 媒 体 播 放 器 SDK 参 考 手 册 深 度 开 发 版 v0.1

目 录 1. 简 介... 3 1.1 功 能 说 明... 3 1.2 安 装 包 说 明... 3 1.3 播 放 器 性 能... 3 1.4 注 意 事 项... 4 2. 系 统 框 架... 4 2.1 系 统 框 架 图... 4 2.2 系 统 框 架 图... 4 3. 使 用 说 明... 4 3.1 开 发 环 境 配 置... 4 3.2 设 置 用 户 权 限... 7 3.3 SDK 包 添 加... 8 3.4 开 发 步 骤... 8 3.5 Demo 示 例... 8 4. 接 口 说 明... 9 4.1 SDK 接 口... 9 4.2 播 放 器 通 知 发 送 逻 辑... 18 4.3 播 放 器 接 口 调 用 流 程... 19 5. 注 意 事 项... 20 6. 版 权 声 明... 20 2

文 档 说 明 本 文 档 面 向 所 有 使 用 该 SDK 的 开 发 人 员 测 试 人 员 以 及 对 此 感 兴 趣 的 用 户, 要 求 开 发 者 对 播 放 器 的 基 本 功 能 有 一 定 的 了 解 1. 简 介 ios 媒 体 播 放 器 SDK 是 在 ios 平 台 上 使 用 的 软 件 开 发 工 具 包 (Soft Development Kit), 为 ios 开 发 者 提 供 简 单 易 用 的 接 口, 帮 助 开 发 者 实 现 iphone/ipad/ipod 等 平 台 上 的 媒 体 播 放 应 用 开 发 1.1 功 能 说 明 1. 方 便 快 捷 低 门 槛 实 现 媒 体 播 放 功 能 用 户 无 须 关 心 内 部 实 现 细 节, 只 需 要 自 定 义 界 面 既 可 以 实 现 专 业 级 的 播 放 应 用 2. 流 媒 体 格 式 支 持 HLS RTMP HTTP FLV 3. 文 件 媒 体 格 式 支 持 mp4 4. 视 频 压 缩 格 式 支 持 h264, 音 频 压 缩 格 式 支 持 aac 1.2 安 装 包 说 明 播 放 器 SDK 的 完 整 下 载 包 中 包 含 demo doc lib inc 等 : 1. demo: 主 要 存 放 了 调 用 SDK 的 示 例 工 程, 可 以 帮 助 用 户 了 解 如 何 使 用 该 SDK 2. lib: 播 放 器 SDK 开 发 包, 包 含 播 放 器 framework 文 件, 需 要 在 您 的 工 程 中 进 行 引 用 3. inc: 播 放 器 SDK 接 口 头 文 件 AliVcMediaPlayer.h 4. doc: 存 放 SDK 相 关 接 口 文 档 1.3 播 放 器 性 能 1. 目 前 播 放 器 SDK 对 H.264 AAC 的 视 频 流 采 用 硬 件 解 码, 播 放 1080P 视 频 CPU 占 用 在 10-20% 之 间 2. SDK 的 大 小 : 使 用 SDK 库 安 装 之 后 的 程 序 大 小 在 1.3M 左 右 即 为 你 的 3

程 序 增 加 1.3M 左 右 的 大 小 1.4 注 意 事 项 1. 播 放 器 SDK 目 前 只 支 持 单 实 例 播 放, 不 能 够 同 时 开 2 个 或 以 上 的 播 放 器 实 例 需 要 另 开 实 例 的 时 候, 必 须 关 闭 之 前 存 在 的 实 例 2. 操 作 系 统 版 本 要 求 ios8.0 以 上 2. 系 统 框 架 2.1 系 统 框 架 图 2.2 系 统 框 架 图 无 3. 使 用 说 明 3.1 开 发 环 境 配 置 1. 需 要 准 备 ios 的 运 行 环 境 (XCode6.0 以 上 版 本,iOS SDK8.0 以 上 版 本 ), 以 及 硬 件 CPU 支 持 ARMv7 ARMv7s 或 ARM64 的 ios 设 备 4

2. 在 阿 里 云 官 网 上 注 册 云 帐 号, 并 开 通 视 频 点 播 或 视 频 直 播 服 务 视 频 点 播 服 务 开 通 视 频 直 播 服 务 开 通 3. 通 过 访 问 控 制 服 务 创 建 播 放 器 专 用 子 帐 号 及 其 AccessKey: a. 登 陆 访 问 控 制 服 务 控 制 台 b. 在 用 户 管 理 中 新 建 用 户 : 注 意 勾 选 为 该 用 户 自 动 生 成 AccessKey 选 项 : 5

创 建 子 帐 号 成 功, 注 意 保 存 好 该 帐 号 的 AccessKey: c. 为 子 帐 号 分 配 调 用 播 放 器 权 限 : 点 击 授 权 链 接 : 6

在 可 选 授 权 策 略 名 称 中 搜 索 mts, 将 AliyunMTSPlayerAuth, 授 予 此 子 帐 号 : 3.2 设 置 用 户 权 限 将 用 户 申 请 的 AccessKeyID 和 AccessKeySecret 进 行 设 置, 播 放 器 才 能 够 使 用 用 户 需 要 实 现 以 下 AliVcAccessKeyProtocol 协 议 来 获 取 用 户 的 AccessKeyID 和 AccessKeySecret [AliVcMediaPlayer setaccesskeydelegate:self]; 验 证 会 每 个 小 时 进 行 一 次 验 证, 用 户 需 要 实 现 该 协 议 的 getaccesskeyidsecret 接 口 来 获 取 用 户 的 AccessKeyID 和 AccessKeySecret NSString* accesskeyid = @"QxJIh3GFRL926hFX"; NSString* accesskeysecret = @"hiphjkptotdznqg2j4doevsavrh7mr"; -(AliVcAccesskey*)getAccessKeyIDSecret { AliVcAccesskey* accesskey = [[AliVcAccesskey alloc] init]; accesskey.accesskeyid = accesskeyid; accesskey.accesskeysecret = accesskeysecret; 7

return accesskey; } 3.3 SDK 包 添 加 请 参 考 以 下 步 骤, 将 播 放 器 SDK 添 加 到 XCode 工 程 中 : 1. XCode 创 建 一 个 ios 应 用 工 程 2. 将 SDK 中 的 framework 添 加 到 工 程 中 : 3. 将 SDK 中 的 头 文 件 包 含 到 工 程 中 3.4 开 发 步 骤 使 用 ios 媒 体 播 放 器 SDK 的 调 用 顺 序 为 : 1. alloc 播 放 器 后, 调 用 create 创 建 播 放 器, 并 传 入 view 显 示 窗 口 2. 注 册 通 知 响 应 函 数 3. 调 用 preparetoplay 准 备 开 始 播 放, 传 入 要 播 放 的 视 频 地 址 4. 调 用 play 接 口 进 行 播 放 3.5 Demo 示 例 在 SDK 中 提 供 了 Demo, 此 Demo 是 用 播 放 器 SDK 开 发 了 一 个 完 整 的 视 频 播 放 器, 用 户 可 以 参 考 Demo 进 行 播 放 器 的 开 发 下 面 给 出 了 部 分 重 要 的 Demo 中 调 用 SDK 的 代 码 : -(void) playvideo { // 新 建 播 放 器 player = [[AliVcMediaPlayer alloc] init]; // 创 建 播 放 器, 传 入 显 示 窗 口 8

[player create:mshowview]; // 注 册 准 备 完 成 通 知 [[NSNotificationCenter defaultcenter] addobserver:self selector:@selector(onvideoprepared:) name:alivcmediaplayerloaddidpreparednotification object:player]; // 注 册 错 误 通 知 [[NSNotificationCenter defaultcenter] addobserver:self selector:@selector(onvideoerror:) name:alivcmediaplayerplaybackerrornotification object:player]; // 授 权 验 证 [player getuserpriority:@"wvyz1rvw3ejm2bxj" keysecret:@"twdczszk00iebh0yhlvp7utbimkv2g&"]; // 传 入 播 放 地 址, 初 始 化 视 频, 准 备 播 放 [player preparetoplay:murl]; // 开 始 播 放 [player play]; } - (void) OnVideoPrepared:(NSNotification *)notification { // 收 到 完 成 通 知 后, 获 取 视 频 的 相 关 信 息, 更 新 界 面 相 关 信 息 [self.playslider setminimumvalue:0]; [self.playslider setmaximumvalue:player.duration]; } - (void)onvideoerror:(nsnotification *)notification { AliVcMovieErrorCode error_code = player.errorcode; } 4. 接 口 说 明 4.1 SDK 接 口 SDK 中 提 供 了 类 AliVcMediaPlayer 来 实 现 播 放 器 各 种 功 能 接 口, 同 时, 我 们 对 播 放 器 的 各 种 通 知 进 行 了 定 义, 并 且 定 义 播 放 器 的 各 种 错 误 代 码 9

播 放 器 功 能 接 口 create preparetoplay play pause stop reset destroy seekto view videoheight videowidth duration currentposition errorcode getsdkversion setuserid setbussinessid 创 建 播 放 器 初 始 化 视 频, 准 备 播 放 开 始 播 放 视 频 暂 停 视 频 播 放 停 止 视 频 播 放 重 置 播 放 器 销 毁 播 放 器 跳 转 到 指 定 位 置 设 置 播 放 显 示 窗 口 获 取 视 频 高 度 获 取 视 频 宽 度 获 取 视 频 长 度 获 取 当 前 视 频 播 放 位 置 播 放 器 错 误 代 码 获 取 播 放 器 版 本 号 设 置 用 户 ID 设 置 业 务 ID 播 放 器 通 知 事 件 AliVcMediaPlayerLoadDidPreparedNotification AliVcMediaPlayerPlaybackDidFinishNotification AliVcMediaPlayerStartCachingNotification AliVcMediaPlayerEndCachingNotification AliVcMediaPlayerPlaybackErrorNotification AliVcMediaPlayerSeekingDidFinishNotification 准 备 完 成 通 知 播 放 结 束 通 知 开 始 缓 冲 通 知 结 束 缓 冲 通 知 播 放 错 误 通 知 跳 转 结 束 通 知 播 放 器 错 误 代 码 AliVcMovieErrorCode ALIVC_SUCCESS ALIVC _ERR_ILLEGALSTATUS 10 无 错 误 非 法 的 播 放 流 程

ALIVC _ERR_NO_NETWORK ALIVC _ERR_FUNCTION_DENIED ALIVC _ERR_UNKOWN ALIVC _ERR_NO_INPUTFILE ALIVC _ERR_NO_VIEW ALIVC _ERR_INVALID_INPUTFILE ALIVC _ERR_NO_SUPPORT_CODEC ALIVC _ERR_NO_MEMORY ALIVC _ERR_NO_MEMORY 无 网 络 下 播 放 网 络 视 频 权 限 验 证 失 败 未 知 错 误 无 输 入 文 件 没 有 设 置 显 示 窗 口 无 效 的 输 入 文 件 视 频 格 式 编 解 码 不 支 持 没 有 足 够 的 内 存 没 有 足 够 的 内 存 下 面 详 细 介 绍 一 下 各 个 成 员 函 数 的 具 体 使 用 : 1. - (AliVcMovieErrorCode) create: (UIView*)view 功 能 : 创 建 播 放 器, 并 设 置 播 放 器 显 示 窗 口 播 放 器 内 部 会 新 建 各 个 播 放 器 变 量 并 初 始 化, 并 启 动 播 放 器 内 部 流 水 线 线 程 等 参 数 :UIView* view, 播 放 器 显 示 窗 口 备 注 : 如 果 创 建 播 放 器 的 时 候 view 没 有, 则 可 以 传 递 nil, 可 以 在 后 续 需 要 设 置 view 2. - (AliVcMovieErrorCode) preparetoplay: (NSURL*)dataSource 功 能 : 根 据 视 频 文 件 内 容 初 始 化 播 放 器 实 例, 包 括 读 取 视 频 头, 解 析 视 频 和 音 频 信 息, 并 根 据 视 频 和 音 频 信 息 初 始 化 解 码 器, 创 建 下 载 ( 或 读 取 本 地 文 件 ) 解 码 显 示 线 程 等 参 数 :(NSURL*)dataSource, 当 前 播 放 视 频 的 文 件 名 或 URL 返 回 值 : 若 播 放 器 初 始 化 成 功, 返 回 ALIVC_SUCCESS; 否 则 返 回 失 败 下 图 为 函 数 的 逻 辑 框 图 : 11

权 限 验 证 失 败 ALIVC_ERR_FUNCTION_DENIED 成 功 datasource 有 效 失 败 ALIVC_ERR_NO_INPUTFILE 成 功 ALIVC_SUCCESS 成 功 播 放 器 状 态 验 证 ALIVC_ERR_ILLEGALSTATUS 成 功 LoadDidPreparedNotification 成 功 视 频 初 始 化 失 败 PlaybackErrorNotification 播 放 器 处 于 准 备 完 成 状 态 具 体 过 程 为 : 1. 验 证 用 户 是 否 有 权 限 调 用 该 函 数 2. 验 证 参 数 datasource 是 否 为 空 3. 如 果 播 放 器 是 正 在 播 放 或 者 正 在 暂 停 状 态, 则 不 能 够 进 行 prepare, 此 时 返 回 非 法 的 播 放 流 程 错 误 ALIVC_ERR_ILLEGALSTATUS, 如 果 播 放 器 状 态 是 已 经 是 准 备 完 成 状 态, 则 返 回 ALIVC_SUCCESS 4. 对 视 频 进 行 初 始 化, 如 果 成 功, 则 会 发 送 LoadDidPreparedNotification 通 知, 表 示 视 频 初 始 化 完 成 如 果 失 败 则 会 发 送 PlaybackErrorNotification 通 知, 在 错 误 通 知 中 可 以 获 取 到 错 误 代 码 备 注 : 该 函 数 是 异 步 函 数, 需 要 等 待 准 备 完 成 通 知 AliVcMediaPlayerLoadDidPreparedNotification, 收 到 该 通 知 后 代 表 视 频 初 始 化 完 成, 视 频 准 备 完 成 后 可 以 获 取 到 视 频 的 相 关 信 息 如 :duration videowidth videoheight 12

3. - (AliVcMovieErrorCode) play 功 能 : 播 放 当 前 视 频 返 回 值 : 当 播 放 视 频 成 功, 返 回 ALIVC_SUCCESS, 否 则 返 回 失 败, 具 体 失 败 代 码 见 下 述 逻 辑 : 权 限 验 证 失 败 ALIVC_ERR_FUNCTION_DENIED 成 功 播 放 器 停 止 ALIVC_ERR_ILLEGALSTATUS 播 放 器 状 态 验 证 正 在 播 放 ALIVC_SUCCESS 视 频 播 放 Play 播 放 器 处 于 播 放 状 态 具 体 过 程 为 : 1. 验 证 是 否 有 权 限 调 用 该 函 数 2. 如 果 播 放 器 是 停 止 的 状 态, 则 直 接 返 回 ALIVC_ERR_ILLEGALSTATUS 错 误, 如 果 此 时 播 放 器 为 播 放 的 状 态, 直 接 返 回 ALIVC_SUCCESS 3. 如 果 播 放 器 在 暂 停 或 者 准 备 完 成 的 状 态, 则 直 接 启 动 视 频 播 放 备 注 : 播 放 器 调 用 play 进 行 播 放, 必 须 在 播 放 器 状 态 为 准 备 完 成 的 状 态 或 者 暂 停 的 状 态 才 能 进 行 播 放, 其 他 情 况 都 不 能 够 将 视 频 播 放 起 来 4. - (AliVcMovieErrorCode) pause 功 能 : 暂 停 当 前 视 频 播 放 返 回 值 : 暂 停 视 频 播 放 成 功 ALIVC_SUCCESS 否 则 返 回 失 败 具 体 逻 13

辑 如 下 : 权 限 验 证 失 败 ALIVC_ERR_FUNCTION_DENIED 成 功 播 放 器 暂 停 状 态 ALIVC_SUCCESS 播 放 器 状 态 验 证 播 放 器 停 止 或 者 准 备 完 状 态 ALIVC_ERR_ILLEGALSTATUS 视 频 暂 停 pause 播 放 器 处 于 暂 停 状 态 具 体 过 程 为 : 1. 验 证 是 否 有 权 限 调 用 该 函 数 2. 如 果 此 时 播 放 器 为 暂 停 状 态, 直 接 返 回 ALIVC_SUCCESS 3. 如 果 播 放 器 状 态 为 停 止 或 者 准 备 完 成 状 态 则 返 回 错 误 的 播 放 器 状 态 ALIVC_ERR_ILLEGALSTATUS 4. 其 他 情 况 则 暂 停 视 频 播 放, 并 将 播 放 器 状 态 设 置 为 暂 停 状 态 备 注 : 播 放 器 调 用 pause 暂 停 视 频 播 放, 一 般 是 在 视 频 播 放 的 情 况 下 调 用 此 函 数 5. - (AliVcMovieErrorCode) stop 功 能 : 停 止 当 前 视 频 播 放, 调 用 此 函 数 则 是 结 束 视 频 播 放, 视 频 显 示 为 黑 屏, 并 回 到 视 频 播 放 起 始 点 返 回 值 : 停 止 视 频 播 放 成 功 ALIVC_SUCCESS 否 则 返 回 失 败 具 体 逻 辑 如 下 : 14

权 限 验 证 失 败 ALIVC_ERR_FUNCTION_DENIED 成 功 播 放 器 状 态 验 证 播 放 器 为 停 止 状 态 ALIVC_SUCCESS 视 频 停 止 播 放 器 状 态 设 置 为 停 止 状 态 发 送 视 频 结 束 播 放 通 知 1. 验 证 是 否 有 权 限 调 用 该 函 数 2. 如 果 此 时 播 放 器 的 状 态 为 停 止 状 态, 直 接 返 回 ALIVC_SUCCESS 3. 其 他 情 况 则 停 止 视 频 播 放, 并 将 播 放 器 状 态 设 置 为 停 止 状 态, 视 频 停 止 后 会 发 送 视 频 结 束 通 知 备 注 : 该 函 数 会 停 止 掉 内 部 音 视 频 解 码 线 程, 如 果 需 要 重 新 进 行 播 放, 则 需 要 再 调 用 preparetoplay 进 行 重 新 对 视 频 进 行 初 始 化 6. - (AliVcMovieErrorCode) seekto: (NSTimeInterval) newpos 功 能 : 跳 转 视 频 到 新 的 播 放 位 置 参 数 :newpos, 单 位 为 毫 秒 返 回 值 : 跳 转 成 功 ALIVC_SUCCESS 否 则 返 回 失 败 具 体 逻 辑 如 下 : 15

权 限 验 证 失 败 ALIVC_ERR_FUNCTION_DENIED 成 功 播 放 器 状 态 验 证 状 态 为 停 止 或 准 备 完 成 ALIVC_ERR_ILLEGALSTATUS 视 频 跳 转 发 送 视 频 跳 转 结 束 通 知 1. 验 证 是 否 有 权 限 调 用 该 函 数 2. 如 果 此 时 播 放 器 的 状 态 为 停 止 或 准 备 完 成 状 态, 返 回 错 误 的 播 放 器 状 态 ALIVC_ERR_ILLEGALSTATUS 3. 其 他 情 况 则 进 行 视 频 跳 转, 跳 转 完 成 后 会 发 送 视 频 跳 转 结 束 通 知 AliVcMediaPlayerSeekingDidFinishNotification 备 注 : 该 函 数 为 异 步 函 数, 调 用 此 函 数 后 并 不 会 立 即 进 行 视 频 跳 转, 需 要 等 待 视 频 跳 转 结 束 通 知 参 数 的 范 围 为 [0,duration], 如 果 传 入 的 参 数 小 于 0, 则 播 放 器 内 部 会 自 动 跳 转 到 0, 如 果 传 入 参 数 大 于 duration, 则 会 跳 转 到 duration 最 后 位 置 7. - (AliVcMovieErrorCode) reset 功 能 : 重 置 播 放 器, 其 目 的 是 将 播 放 器 所 有 状 态 恢 复 到 最 初 位 置, 当 播 放 器 内 部 出 现 错 误 或 其 它 问 题 时, 调 用 此 函 数 来 进 行 恢 复 返 回 值 : 如 果 权 限 验 证 通 过, 则 会 返 回 ALIVC_SUCCESS 备 注 : 该 函 数 和 stop 函 数 的 区 别 是,reset 也 能 够 实 现 stop 的 功 能, 但 是 reset 会 去 销 毁 播 放 器 内 部 的 各 种 变 量, 并 且 调 用 create 重 新 初 始 化 播 放 器 内 部 各 个 变 量 8. - (AliVcMovieErrorCode) destroy 功 能 : 销 毁 播 放 器, 该 函 数 用 来 释 放 播 放 器 内 部 的 所 有 变 量, 退 出 所 有 16

线 程 备 注 : 在 退 出 播 放 器 的 时 候 必 须 调 用 该 函 数, 用 来 进 行 内 存 释 放, 否 则 会 存 在 内 存 泄 露 9. UIView *view 功 能 : 包 含 视 频 内 容 的 view 备 注 : 需 要 在 调 用 preparetoplay 之 前 设 置 view, 当 前 view 只 有 视 频 帧 图 像, 没 有 相 关 控 制 组 件, 相 当 于 ios 系 统 播 放 器 MPMoviePlayerController 的 控 制 方 式 controlstyle 为 MPMovieControlStyleNone 的 效 果 10. NSTimeInterval currentposition 功 能 : 获 取 当 前 视 频 播 放 位 置, 只 读 属 性, 获 取 单 位 为 毫 秒 备 注 : 当 播 放 器 状 态 为 正 在 播 放 或 暂 停 的 状 态, 能 够 获 取 到 有 效 值, 否 则 获 取 值 为 无 效 0 11. int videowidth 功 能 : 获 取 视 频 宽 度, 只 读 属 性 备 注 : 当 调 用 了 preparetoplay 后, 并 不 能 立 即 获 得 videowidth 的 值, 只 有 当 播 放 器 发 送 了 prepared 通 知 后,videoWidth 的 值 才 有 效, 否 则 为 默 认 值 0 12. int videoheight 功 能 : 获 取 视 频 高 度, 只 读 属 性 备 注 : 当 调 用 了 preparetoplay 后, 并 不 能 立 即 获 得 videoheight 的 值, 只 有 当 播 放 器 发 送 了 prepared 通 知 后,videoHeight 的 值 才 有 效, 否 则 为 默 认 值 0 13. NSTimeInterval duration 功 能 : 获 取 视 频 时 长, 只 读 属 性, 单 位 为 毫 秒 备 注 : 当 调 用 了 preparetoplay 后, 并 不 能 立 即 获 得 duration 的 值, 只 有 当 播 放 器 发 送 了 prepared 通 知 后,duration 的 值 才 有 效, 否 则 为 默 认 值 0 14. AliVcMovieErrorCode errorcode 17

功 能 : 播 放 器 错 误 代 码, 只 读 属 性 备 注 : 当 播 放 器 出 现 错 误 时, 可 以 通 过 获 取 这 个 属 性 来 获 取 到 错 误 的 代 码, 通 过 错 误 代 码 可 以 了 解 到 具 体 的 错 误 原 因 15. - (NSString *) getsdkversion; 功 能 : 获 取 SDK 版 本 号 返 回 值 : 返 回 NSString 类 型 的 版 本 号 备 注 : 当 开 发 者 反 馈 问 题 时, 请 使 用 该 方 法 获 得 SDK 版 本 号 并 随 同 问 题 一 起 反 馈 4.2 播 放 器 通 知 发 送 逻 辑 下 图 是 播 放 器 发 送 通 知 逻 辑 : preparetoplay Play LoadDidPreparedNotification Pause PlaybackDidFinishNotification stop/reset PlaybackErrorNotification seekto SeekingDidFinishNotification 具 体 逻 辑 : 1. 调 用 preparetoplay 成 功 后 发 送 LoadDidPreparedNotification 通 知, 失 败 则 会 发 送 PlaybackErrorNotification 2. 调 用 play pause stop reset seekto 和 preparetoplay 失 败 后 发 送 PlaybackErrorNotification 通 知 3. 调 用 stop/reset 成 功 后 播 放 视 频 结 束 发 送 PlaybackDidFinishNotification 通 知 4. 调 用 seekto 成 功 后 发 送 SeekingDidFinishNotification 通 知 18

备 注 : 同 时 还 有 StartCachingNotification 和 EndCachingNotification 通 知, 这 个 是 在 网 络 视 频 缓 冲 数 据 不 足 以 够 播 放 后 会 发 送 此 通 知, 一 般 网 络 视 频 在 调 用 seekto 后 会 发 送 此 通 知 另 外, 当 收 到 播 放 器 错 误 通 知 后, 可 以 获 取 到 错 误 代 码, 我 们 将 错 误 代 码 分 成 了 两 个 级 别, 一 种 错 误 时 播 放 器 产 生 的 严 重 错 误, 需 要 用 户 来 调 用 stop 或 reset 来 进 行 重 置 播 放 器 根 据 ALIVC_ERR_RESET_LINE 来 区 分, 如 果 大 于 ALIVC_ERR_RESET_LINE 则 播 放 器 需 要 重 置 4.3 播 放 器 接 口 调 用 流 程 create 创 建 播 放 器 getuserpriority 授 权 验 证 preparetoplay 初 始 化 视 频, 准 备 播 放 play 播 放 视 频 pause/stop 暂 停 / 停 止 视 频 destroy 销 毁 播 放 器 上 图 是 播 放 器 播 放 视 频 的 流 程, 播 放 器 内 部 会 记 录 播 放 器 的 状 态, 状 态 的 转 换 逻 辑 如 下 图 : 19

准 备 完 成 状 态 preparetoplay 停 止 状 态 play stop/reset 播 放 状 态 pause 暂 停 状 态 5. 注 意 事 项 无 6. 版 权 声 明 版 权 所 有, 切 勿 盗 版 20