最近更新时间:2023.08.24 19:49:14
首次发布时间:2022.07.13 16:53:43
用于监听 TVULiveRoomServer
实例的回调类,您可以在回调中做相应处理。
public interface com.bytedance.live.sdk.player.listener.ITVULiveRoomServerListener
该回调在 TVULiveRoomServer.start
方法执行完成、成功获取服务端数据时触发。
void onGetRoomDataSuccess(ActivityResult activityResult)
参数
名称 | 类型 | 说明 |
---|---|---|
activityResult | ActivityResult | 返回的服务端直播间数据。 |
该回调在TVULiveRoomServer.start
方法执行完成、获取服务端数据失败时触发。
void onGetRoomDataFailed(int errCode, String errMsg)
参数
名称 | 类型 | 说明 |
---|---|---|
errCode | Integer | 错误码。
|
errMsg | String | 失败的原因。 |
播放器全屏、退出全屏图标点击回调。您可以在该回调中实现横竖屏切换、状态栏的显示或隐藏等,并调用 adjustPlayer
方法自定义播放器尺寸。
void onFullScreenChange()
直播状态变化回调。
void liveRoomStatusChange(int value)
参数
名称 | 类型 | 说明 |
---|---|---|
value | Integer | 当前直播状态。
|
播放状态变化回调。
void playerStatusChange(int playerStatus)
参数
名称 | 类型 | 说明 |
---|---|---|
playerStatus | Integer | 当前播放器的状态。
|
播放器倍速按钮点击回调。
void onSpeedButtonDidTouch()
播放器重放按钮点击回调。
void onReplayButtonDidTouch()
点击多语言切换图标的回调类。
public interface LanguageListener
多语言切换图标点击回调。观众点击多语言切换图标时,SDK 调用该回调通知您的 App 该点击事件。
void onSelectLanguage(Activity activity, ArrayList<LanguageManager.LANGUAGE> languages, LanguageManager.LANGUAGE curLanguage, SelectLanguageCallBack callBack)
参数
名称 | 类型 | 说明 |
---|---|---|
activity | Activity | 直播间 Activity。 |
languages | ArrayList<LanguageManager.LANGUAGE> | 当前支持的语言列表。
|
curLanguage | LanguageManager.LANGUAGE | 当前选中的语言。 |
callBack | SelectLanguageCallBack | 语言选中的回调类。 |
语言选中的回调类。
interface SelectLanguageCallBack
语言选中回调。您可以在您的 App 中自定义一个多语言选择对话框,并在观众选择语言后,调用该回调通知 SDK 切换语言。
void onLanguageSelected(LanguageManager.LANGUAGE language)
参数
名称 | 类型 | 说明 |
---|---|---|
language | LanguageManager.LANGUAGE | 要切换的语言。 |
直播间页面生命周期的回调类。
public interface LiveRoomStatusListener
直播间创建回调。
void onLiveRoomCreate(Activity activity)
横屏直播间页面 ViewBinding
实例初始化完成回调。
default void onLandLiveRoomBindingAvailable(TvuLivePlayerLayoutBinding binding, LanguageManager languageManager)
参数
名称 | 类型 | 说明 |
---|---|---|
binding | TvuLivePlayerLayoutBinding | 直播间页面的 |
languageManager | LanguageManager | 多语言管理器。 |
直播间切换到后台回调。
void onLiveRoomPause(Activity activity)
直播间切换到前台回调。
void onLiveRoomResume(Activity activity)
直播间 Activity 配置变化回调。
default void onActivityConfigurationChanged(Activity activity, Configuration configuration)
参数
名称 | 类型 | 说明 |
---|---|---|
activity | Activity | 直播间 Activity。 |
configuration | Configuration | 直播间 Activity 的配置。 |
直播间销毁回调。
void onLiveRoomDestroy(Activity activity)
公开鉴权模式下登录自有账号系统的回调类。
public interface CustomLoginListener
公开鉴权模式下登录自有账号系统回调。观众以公开模式进入直播间后,在评论或点赞等需要登录的场景下,SDK 调用该回调通知您的 App 观众需进行登录。您可以通过自有账号体系实现观众的登录。
void onCustomLoginStart(Context context, long activityId, LoginStateCallBack callBack)
参数
名称 | 类型 | 说明 |
---|---|---|
context | Context | 直播间 Activity。 |
activityId | long | 直播间活动 ID。 |
callBack | LoginStateCallBack | 观众登录结果的回调类。 |
观众登录结果的回调类。
interface LoginStateCallBack
观众登录结果回调。观众登录您的自有账号体系后,调用该回调告知 SDK 观众的登录结果。
void onLoginFinished(String token)
参数
名称 | 类型 | 说明 |
---|---|---|
token | String | 用户 Token。
说明 在传入前,确保调用
|
抽奖图标的回调类。
public interface Listener
抽奖状态变化回调。抽奖状态变化时,SDK 触发该回调通知您更新图片。
void onUpdateAwardIcon(ImageView icon, int awardStatus);
参数
名称 | 类型 | 说明 |
---|---|---|
icon | ImageView | 抽奖图标的 ImageView。 |
awardStatus | Integer | 当前的抽奖状态。
|
独立播放器的回调类。
public interface SinglePlayerListener
直播状态变化回调。
public void liveRoomStatusChanged(int status);
参数
名称 | 类型 | 说明 |
---|---|---|
status | Integer | 当前直播状态:
|
资源可播放状态回调。
public void playableStatusChanged(int playableStatus);
参数
名称 | 类型 | 说明 |
---|---|---|
playableStatus | Integer | 当前资源可播放状态:
|
播放状态变化回调。
public void playStatusChanged(int playStatus);
参数
名称 | 类型 | 说明 |
---|---|---|
playStatus | Integer | 当前播放状态:
|
视频画面尺寸变化回调。
public void sizeChanged(int width, int height);
参数
名称 | 类型 | 说明 |
---|---|---|
width | Integer | 视频宽度。 |
height | Integer | 视频高度。 |
卡顿状态变化回调。您可以自行配置是否显示自定义加载动画。
public void stallingStatusChanged(boolean isStalling);
参数
名称 | 类型 | 说明 |
---|---|---|
isStalling | Boolean | 当前视频是否卡顿。
|
点播发生错误回调。
public void (Error error);
参数
名称 | 类型 | 说明 |
---|---|---|
error | Error | 错误详情。 |
视频播放发生错误回调。包括点播发生错误和直播发生错误。此时播放处于暂停状态,您可以自行配置重试画面,引导观众点击重试播放。
public void playErrorStatusChanged(boolean isPlayError);
参数
名称 | 类型 | 说明 |
---|---|---|
isPlayError | Boolean | 当前是否发生播放错误。
|
点播视频已准备完毕回调。您可以调用 seekVodTime 方法。
public void vodPrepared();
点播视频画面渲染开始回调。
public void vodRenderStarted();
点播视频当前播放进度变化回调。每秒更新一次。
public void (int curTimeInMills);
参数
名称 | 类型 | 说明 |
---|---|---|
curTimeInMills | Integer | 当前播放进度。单位:ms |
点播视频总时长变化回调。此回调通常在视频切换时触发。
public void (int durationInMills);
参数
名称 | 类型 | 说明 |
---|---|---|
durationInMills | Integer | 当前视频的总时长。单位:ms |
视频播放完成回调。
public void vodCompletion();
直播已准备完毕回调。
public void livePrepared();
直播渲染开始回调。
public void liveFirstFrameRendered(boolean isFirstFrame);
参数
名称 | 类型 | 说明 |
---|---|---|
isFirstFrame | Boolean | 是否为真正渲染的第一帧。直播过程中可能会发生重试导致多次触发此回调。
|
直播结束回调。
public void liveCompletion();
封面可见状态回调。视频播放时封面不可见,无视频播放时封面可见。
public void coverImageVisibleChanged(boolean isVisible);
参数
名称 | 类型 | 说明 |
---|---|---|
isVisible | Boolean | 封面是否可见。
|
视频分辨率信息改变回调。此回调通常在视频切换时触发。
public void resolutionInfoChanged(String[] resolutions, String defaultResolution);
参数
名称 | 类型 | 说明 |
---|---|---|
resolutions | String[] | 当前支持的分辨率列表。 |
defaultResolution | String | 当前默认选中的分辨率。 |
点播视频自动断点续播回调。
void vodAutoSeekPreviousTime(int seekTimeInMills)
参数
名称 | 类型 | 说明 |
---|---|---|
seekTimeInMills | Integer | 自动断点续播后跳转到的视频播放位置。单位:ms |
当前正在播放的点播视频 Vid 改变回调。在观看页播放的点播视频变更时或者直播间状态发生变化时会触发该回调。
void onCurVodVidChanged(String vid)
参数
名称 | 类型 | 说明 |
---|---|---|
vid | String | 当前正在播放的点播视频 Vid。如果当前未播放点播视频,则返回空字符串。 |
当前直播间的回放改变回调。在上下架回放时或者直播间状态发生变化时会触发该回调。
void onCurReplayListChanged(List<Replay> replayList)
参数
名称 | 类型 | 说明 |
---|---|---|
replayList | List | 直播间的回放列表。如果当前直播间没有回放视频,则返回空数组。 |
当前直播线路 ID 改变回调。
void onCurLiveLineIdChanged(long lineId)
参数
名称 | 类型 | 说明 |
---|---|---|
lineId | Long | 当前直播线路 ID。如果当前直播间并非直播中状态,则返回 |
当前直播线路列表改变回调。
void onCurLiveLineListChanged(List<PullStreamUrl> liveLineList)
参数
名称 | 类型 | 说明 |
---|---|---|
liveLineList | List | 当前直播线路列表。如果当前直播间并非直播中状态,则返回空数组。 |
TVUSinglePlayerView
实例初始化结果回调。
public void initFinished(boolean initSuccess);
参数
名称 | 类型 | 说明 |
---|---|---|
initSuccess | Boolean | 初始化是否成功。
|
注意
该方法自 1.26.0 版本开始不再支持使用,您可以使用 setListener 方法替代之。
跳转完成回调类。
public interface SeekCompletionListener
跳转完成回调。
void onCompletion(boolean success);
参数
名称 | 类型 | 说明 |
---|---|---|
success | Boolean | 跳转是否成功。
|
直播间内链接点击的回调类。
public interface RedirectPageListener
链接点击回调。用户点击直播间内某一 URL 或评论区用户昵称时,SDK 会触发此回调。
public void redirectPage(RedirectInfo redirectInfo)
参数
名称 | 类型 | 说明 |
---|---|---|
redirectInfo | 实现跳转所需的信息。 |
自定义图标数组的回调类。
public interface ITVUMultipleDrawableListener
自定义图标数组回调。当 SDK 内部需要图标数组时,会调用该回调。您需要自行实现该回调并返回自定义的图标数组。
Drawable[] onGetMultipleDrawable()
返回结果
类型 | 说明 |
---|---|
Drawable[] | 您自定义的图标数组。 |
悬浮窗点击事件的回调类。
public interface FloatViewActionListener
观众点击悬浮窗主体时,SDK 会触发该回调,但不会触发原来默认的点击行为。
说明
默认的点击行为指关闭悬浮窗并返回完整直播间。
public void onClickFloatView()
观众点击悬浮窗的关闭按钮时,SDK 会触发该回调,但不会触发原来默认的点击行为。
说明
默认的点击行为指关闭悬浮窗。
public void onClickFloatViewExitBtn()
直播间操作事件的回调类。
public interface LiveRoomActionListener
观众点击退出按钮或物理返回键退出完整直播间时,SDK 会触发该回调,但不会触发原来默认的点击行为。
说明
默认的点击行为指退出完整直播间,如正在播放直播或点播视频且在移动端开启了悬浮窗权限,则会在退出完整直播间的同时展示悬浮窗。
public void onClickExitLiveRoom(Activity activity)
参数
名称 | 类型 | 说明 |
---|---|---|
activity | Activity | 直播间 Activity。 |