You need to enable JavaScript to run this app.
文档中心
文档备案控制台
视频直播

视频直播

请输入
  • 文档首页
    • 视频直播客户端 SDK拉流 SDKiOSSDK API 参考错误码
复制全文
下载 pdf
我的收藏
SDK API 参考
错误码
复制全文
下载 pdf
我的收藏
错误码

VeLivePlayerError 
@interface VeLivePlayerError : NSError

拉流 SDK 错误。

成员变量

类型

名称

NSInteger

errorCode

NSInteger

subErrorCode

NSString*

errorMsg

变量说明

errorCode 

@property (nonatomic, readonly) NSInteger errorCode;

拉流 SDK 错误码。

subErrorCode 

@property (nonatomic, readonly) NSInteger subErrorCode;

拉流 SDK 子错误码。

errorMsg 

@property (nonatomic, readonly, nullable) NSString* errorMsg;

拉流 SDK 错误信息。

VeLivePlayerErrorCode 
typedef NS_ENUM(
    NSInteger,
    VeLivePlayerErrorCode
)

拉流 SDK 错误码。

枚举值

类型

值

说明

VeLivePlayerNoError

0

没有错误。

VeLivePlayerInvalidLicense

-1

License 无效。可能是 License 集成错误或已过期导致。
请检查 License 的集成方式和有效期。如果问题仍然存在，请联系火山引擎 技术支持。

VeLivePlayerInvalidParameter

-2

传入参数不符合规范。
请检查并重试。

VeLivePlayerErrorRefused

-3

调用时机错误导致调用被拒绝。
请检查调用时机并重试。建议在开发阶段处理该错误。

VeLivePlayerErrorLibraryLoadFailed

-4

加载库文件失败。可能是 SDK 集成错误导致。
请检查 SDK 的集成方式并重试。建议在开发阶段处理该错误。

VeLivePlayerErrorPlayUrl

-100

拉流地址不存在或无效。可能是传入的拉流地址为空、格式不合法或长度超限导致。
在开发阶段，你可以通过监控该错误，排查使用问题。如果线上出现该错误，建议通过强提示告知观众播放器不可用，并提醒观众重启播放器。

VeLivePlayerErrorNoStreamData

-101

流数据不存在或网络请求数据失败。可能是直播流不存在、直播流中断、直播已结束导致。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。

VeLivePlayerErrorInternalRetryStart

-102

播放器内部重试。可能是播放器内部错误导致。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。

VeLivePlayerErrorInternalRetryFailed

-103

播放器内部重试失败。由于重试次数已达到最大限制，播放器已停止重试。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。

VeLivePlayerErrorDnsParseFailed

-200

DNS 解析失败。可能是拉流地址异常或客户端网络异常导致。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。

VeLivePlayerErrorNetworkRequestFailed

-201

网络请求失败。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。

VeLivePlayerErrorDemuxFailed

-300

解封装失败。可能是使用了播放器不支持的流格式或协议，或音视频流错误导致。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。

VeLivePlayerErrorDecodeFailed

-301

视频解码失败。可能是使用了播放器不支持的直播流音视频格式或解码器出错导致。
建议更换有效的拉流地址、切换到低码率流或提示网络问题。如果问题仍然存在，请联系火山引擎 技术支持。

VeLivePlayerErrorAVOutputFailed

-302

渲染失败。可能是音视频输出设备异常导致。
如果线上出现该错误，建议通过强提示告知观众播放器不可用，并提醒观众重启播放器。

VeLivePlayerErrorSRDeviceUnsupported

-303

当前设备不在超分机型白名单内，不支持超分功能。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSRResolutionUnsupported

-304

当前分辨率超出超分限制。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSRFpsUnsupported

-305

当前帧率超出超分限制。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSRInitFail

-306

超分初始化失败。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSRExecuteFail

-307

超分执行失败。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerLicenseUnsupportedH265

-308

你使用的基础版 License 不支持 H.265 硬解和软解功能。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorSharpenDeviceUnsupported

-309

当前设备不支持视频锐化功能。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSharpenResolutionUnsupported

-310

当前分辨率超出锐化限制。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSharpenFpsUnsupported

-312

当前帧率超出锐化限制。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorSharpenInitFail

-313

锐化初始化失败。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorLicenseUnsupportedABR

-315

你使用的基础版 License 不支持自适应码率（Adaptive Bit-Rate，简称 ABR）功能。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedDRM

-316

你使用的基础版 License 不支持播放 DRM（Digital Rights Management）加密流。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedSEI

-317

你使用的基础版 License 不支持 SEI（Supplemental Enhancement Information，补充增强信息）消息接收功能。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedSuperResolution

-318

你使用的基础版 License 不支持超分功能。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedSharpen

-319

你使用的基础版 License 不支持视频锐化功能。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedQUIC

-320

你使用的基础版 License 不支持 QUIC 协议。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedRTM

-323

你使用的基础版 License 不支持播放 RTM 流。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedMainBackup

-324

你使用的基础版 License 不支持主备流切换功能。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerErrorLicenseUnsupportedFLVLowLatency

-325

你使用的基础版 License 不支持播放 FLV 低延时流（延时 2-3 秒）。
请购买使用高级版 License。有关如何获取高级版 License，详见获取 SDK License。

VeLivePlayerDRMFetchCKCFailed

-400

DRM 鉴权失败。
如果线上出现该错误，建议通过强提示告知观众播放器不可用，并提醒观众重启播放器。

VeLivePlayerDRMFetchSPCFailed

-401

SPC（Server Playback Context，即服务器播放上下文）生成失败。
如果线上出现该错误，建议通过强提示告知观众播放器不可用，并提醒观众重启播放器。

VeLivePlayerErrorNotSupportResolutionSwitch

-510

播放器不支持清晰度档位切换。
在开发阶段，你可以通过监控该错误，排查使用问题。请联系火山引擎 技术支持 了解详情。

VeLivePlayerErrorInternal

-999

内部错误。
请联系火山引擎 技术支持 了解详情。

最近更新时间：2026.04.29 17:41:52
这个页面对您有帮助吗？
有用
有用
无用
无用