You need to enable JavaScript to run this app.
文档中心
视频直播

视频直播

复制全文
下载 pdf
SDK API 参考
错误码
复制全文
下载 pdf
错误码

VeLivePlayerError
public class com.ss.videoarch.liveplayer.VeLivePlayerError

拉流 SDK 错误。

成员变量

类型

默认值

名称

int

-

mErrorCode

String

-

mErrorMsg

int

-1

mSubCode

成员函数

返回

名称

VeLivePlayerError

VeLivePlayerError

变量说明

mErrorCode

public int com.ss.videoarch.liveplayer.VeLivePlayerError.mErrorCode

拉流 SDK 错误码。

mErrorMsg

public String com.ss.videoarch.liveplayer.VeLivePlayerError.mErrorMsg

拉流 SDK 错误信息。

mSubCode

public int com.ss.videoarch.liveplayer.VeLivePlayerError.mSubCode = -1

拉流 SDK 子错误码。

函数说明

VeLivePlayerError

public com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerError(
    int errorCode,
    int subCode,
    String errorMsg
)

创建一个包含错误码、子错误码和错误消息的 VeLivePlayerError 实例。
传入参数

参数名

类型

说明

errorCode

int

错误码。

subCode

int

子错误码。

errorMsg

String

错误消息。

返回值
VeLivePlayerError 实例。

VeLivePlayerErrorCode
public static class com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode

拉流 SDK 错误码。

成员变量

类型

默认值

名称

int

0

VeLivePlayerNoError

int

-1

VeLivePlayerInvalidLicense

int

-2

VeLivePlayerInvalidParameter

int

-3

VeLivePlayerErrorRefused

int

-4

VeLivePlayerErrorLibraryLoadFailed

int

-100

VeLivePlayerErrorPlayUrl

int

-101

VeLivePlayerErrorNoStreamData

int

-102

VeLivePlayerErrorInternalRetryStart

int

-103

VeLivePlayerErrorInternalRetryFailed

int

-200

VeLivePlayerErrorDnsParseFailed

int

-201

VeLivePlayerErrorNetworkRequestFailed

int

-300

VeLivePlayerErrorDemuxFailed

int

-301

VeLivePlayerErrorDecodeFailed

int

-302

VeLivePlayerErrorAVOutputFailed

int

-303

VeLivePlayerErrorSRDeviceUnsupported

int

-304

VeLivePlayerErrorSRResolutionUnsupported

int

-305

VeLivePlayerErrorSRFpsUnsupported

int

-306

VeLivePlayerErrorSRInitFail

int

-307

VeLivePlayerErrorSRExecuteFail

int

-308

VeLivePlayerLicenseUnsupportedH265

int

-309

VeLivePlayerErrorSharpenDeviceUnsupported

int

-310

VeLivePlayerErrorSharpenResolutionUnsupported

int

-312

VeLivePlayerErrorSharpenFpsUnsupported

int

-313

VeLivePlayerErrorSharpenInitFail

int

-314

VeLivePlayerErrorLicenseUnsupportedH266

int

-315

VeLivePlayerErrorLicenseUnsupportedABR

int

-316

VeLivePlayerErrorLicenseUnsupportedDRM

int

-317

VeLivePlayerErrorLicenseUnsupportedSEI

int

-318

VeLivePlayerErrorLicenseUnsupportedSuperResolution

int

-319

VeLivePlayerErrorLicenseUnsupportedSharpen

int

-320

VeLivePlayerErrorLicenseUnsupportedQUIC

int

-323

VeLivePlayerErrorLicenseUnsupportedRTM

int

-324

VeLivePlayerErrorLicenseUnsupportedMainBackup

int

-325

VeLivePlayerErrorLicenseUnsupportedFLVLowLatency

int

-510

VeLivePlayerErrorNotSupportResolutionSwitch

int

-999

VeLivePlayerErrorInternal

变量说明

VeLivePlayerNoError

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerNoError = 0

没有错误。

VeLivePlayerInvalidLicense

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerInvalidLicense = -1

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

VeLivePlayerInvalidParameter

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerInvalidParameter = -2

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

VeLivePlayerErrorRefused

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorRefused = -3

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

VeLivePlayerErrorLibraryLoadFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLibraryLoadFailed = -4

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

VeLivePlayerErrorPlayUrl

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorPlayUrl = -100

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

VeLivePlayerErrorNoStreamData

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorNoStreamData = -101

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

VeLivePlayerErrorInternalRetryStart

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorInternalRetryStart = -102

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

VeLivePlayerErrorInternalRetryFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorInternalRetryFailed = -103

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

VeLivePlayerErrorDnsParseFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorDnsParseFailed = -200

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

VeLivePlayerErrorNetworkRequestFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorNetworkRequestFailed = -201

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

VeLivePlayerErrorDemuxFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorDemuxFailed = -300

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

VeLivePlayerErrorDecodeFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorDecodeFailed = -301

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

VeLivePlayerErrorAVOutputFailed

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorAVOutputFailed = -302

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

VeLivePlayerErrorSRDeviceUnsupported

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSRDeviceUnsupported = -303

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

VeLivePlayerErrorSRResolutionUnsupported

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSRResolutionUnsupported = -304

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

VeLivePlayerErrorSRFpsUnsupported

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSRFpsUnsupported = -305

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

VeLivePlayerErrorSRInitFail

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSRInitFail = -306

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

VeLivePlayerErrorSRExecuteFail

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSRExecuteFail = -307

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

VeLivePlayerLicenseUnsupportedH265

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerLicenseUnsupportedH265 = -308

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

VeLivePlayerErrorSharpenDeviceUnsupported

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSharpenDeviceUnsupported = -309

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

VeLivePlayerErrorSharpenResolutionUnsupported

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSharpenResolutionUnsupported = -310

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

VeLivePlayerErrorSharpenFpsUnsupported

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSharpenFpsUnsupported = -312

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

VeLivePlayerErrorSharpenInitFail

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorSharpenInitFail = -313

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

VeLivePlayerErrorLicenseUnsupportedH266

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedH266 = -314

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

VeLivePlayerErrorLicenseUnsupportedABR

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedABR = -315

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

VeLivePlayerErrorLicenseUnsupportedDRM

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedDRM = -316

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

VeLivePlayerErrorLicenseUnsupportedSEI

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedSEI = -317

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

VeLivePlayerErrorLicenseUnsupportedSuperResolution

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedSuperResolution = -318

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

VeLivePlayerErrorLicenseUnsupportedSharpen

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedSharpen = -319

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

VeLivePlayerErrorLicenseUnsupportedQUIC

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedQUIC = -320

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

VeLivePlayerErrorLicenseUnsupportedRTM

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedRTM = -323

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

VeLivePlayerErrorLicenseUnsupportedMainBackup

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedMainBackup = -324

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

VeLivePlayerErrorLicenseUnsupportedFLVLowLatency

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorLicenseUnsupportedFLVLowLatency = -325

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

VeLivePlayerErrorNotSupportResolutionSwitch

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorNotSupportResolutionSwitch = -510

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

VeLivePlayerErrorInternal

public static final int com.ss.videoarch.liveplayer.VeLivePlayerError.VeLivePlayerErrorCode.VeLivePlayerErrorInternal = -999

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

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