2026-04-28

1.66.1

问题修复

• 修复了一些已知偶现的崩溃问题。
• 修复部分 Loading 提示无法显示的问题。

2025-11-25

1.65.2

问题修复
修复了一些问题。

2025-11-17

1.65.1

问题修复
修复了一些问题。

2025-11-12

1.65.0

• 新增特性
  • BDLMultiLanguageConfiguration 下新增 preferLanguage 属性，用于设置观看页面优先展示的语言。
  • BDLInteractiveToolConfiguration 下新增 customizeFloatingViewImageViewImage 属性，用于设置浮窗图标中的图片 view。
• 问题修复
  修复了一些问题。

2025-09-26

1.64.0

• 升级必看
  在 BDLFloatingController 中：
  • 删除 floatingCardView（浮窗商品卡片 view）属性，替代 view 为 BDLFloatingControllerViewTag。
  • 更新 customizeFloatingCardView 的返回类型为 BOOL，表示是否显示浮窗商品卡片 view。
• 新增特性
  • 新增 BDLFloatingControllerViewTag（浮窗 view 类型），支持多商品讲解功能。功能开启后，支持同时将 1-3 个商品卡片高优展示在观看页的商品卡片菜单下，并以浮窗形式展示在观看页。配置步骤详见标记商品讲解。
    
  • BDLCardModel 中，新增以下属性，支持隐藏商品价格、售罄商品等。配置步骤详见步骤四：配置商品信息：
    • floatingTime（商品卡片浮窗展示时间）
    • priceHidden（是否隐藏商品价格）
      
    • outOfStock（是否售罄商品）
      
• 优化
  支持拉流的日志上报，增强问题排查能力。

2025-09-09

1.63.0

升级必看

• 删除 BDLTaskAwardRuleContactOptions（中奖观众联系信息类型）和 BDLInteractiveAwardContactOptions（抽奖中奖人填写信息类型），使用 BDLAwardContactOptions 替代。
• 新增 BDLAwardContactOptions，表示抽奖中奖人填写信息类型，支持手机号、收货地址、收件人和邮箱类型。配置步骤详见步骤二：管理奖品。
  

2025-08-26

1.62.1

升级必看

• 删除以下商品卡片点击回调，替代方法为 BDLShoppingCardController 中的商品卡片点击回调 onCardClickBlock。接入代码示例参考商品卡片。
  • BDLCardView 中的 viewTappedBlock
  • BDLShoppingCardView 中的 cardViewTappedBlock
  • BDLFloatingCardView 中的 viewTappedBlock
  • BDLFloatingController 下的 onCardClickBlock
• BDLShoppingCardController 中的商品卡片点击回调 onCardClickBlock，新增参数 clickPosition （商品卡片点击位置），用于区分商品卡片点击位置。

2025-08-12

1.62.0

• 新增特性
  支持展示自定义的实时抽奖图标。配置步骤详见步骤二：配置和发送抽奖。
  
• 问题修复
  修复了一些问题。

2025-07-28

1.61.2

• 升级必看
  废弃或删除部分属性、方法或 view：
  • BDLCommentViewConfiguration(Config) 下，inputBoxPromptColor 属性已废弃，请使用替代属性 inputBoxPromptTextColor。
  • BDLInteractiveToolController 下，删除 customizeAwardContactView（自定义完善中奖信息弹窗 view）方法。
  • BDLAwardWinnersView 下，删除以下属性或方法：
    • emptyHintLabel（“无人参与该抽奖活动”文案的 label）
    • bottomHintLabel（“中奖用户尽快在互动工具-抽奖入口处填写中奖信息，避免错失奖品～”文案的 label）
    • initWithAwardId:（初始化中奖名单 view 实例）
  • 删除 BDLAwardContactView（完善中奖信息弹窗 view）。
• 新增特性
  • 新增 topCommentFontColor 属性，用于设置置顶评论内容的文字颜色。
  • 新增 topCommentBackgroundWidthFitContent 属性，用于设置置顶评论背景的宽度是否跟随内容宽度变化。
  • 新增 topCommentViewCornerRadius 属性，用于设置置顶评论背景的圆角半径。
  • 新增 topCommentNicknameColor 属性，用于设置置顶评论昵称的颜色。
  • 新增 topCommentNicknameFont 属性，用于设置置顶评论昵称的字体和字号。
  • 新增 topCommentContentLineSpacingExtra 属性，用于设置置顶评论内容的行间距。
  • 新增 topCommentBackgroundColor 属性，用于设置置顶评论的背景颜色。
  • 新增 commentContentLineSpacingExtra 属性，用于设置评论内容的行间距。
  • 新增 commentCellCornerRadius 属性，用于设置评论 cell 的圆角半径。
  • 新增 popupInputBoxPromptTextColor 属性，用于设置评论输入框编辑状态（弹出键盘时）的提示文字颜色。
  • 新增 popupInputBoxTextColor 属性，用于设置评论输入框编辑状态（弹出键盘时）输入的文字颜色。
  • 新增 inputBoxPromptTextColor 属性，用于设置评论输入框非编辑状态（未弹出键盘时）的提示文字颜色。
  • 新增 FunctionEntranceButtonCornerRadius 属性，用于设置直播间右下角功能入口按钮（例如购物车、互动工具按钮）的圆角半径。
  • 新增错误码 BDLErrorCodeForceOffline，表示观众已被直播间封禁。 详见错误码。
• 问题修复
  修复了一些问题。

2025-07-15

1.60.0

优化

• 优化直播频道的数据上报。
• 优化观看页实时抽奖的 UI 样式，包括新增支持在抽奖弹窗中展示奖品图，以提升用户体验。

2025-07-01

1.59.0

• 新增特性
  踢出功能变更：观众被踢出直播间后，由原来的无法再次进入当前直播间，变更为可以点击继续观看重新进入当前直播间。如需继续使用踢出功能，必须将 SDK 更新至 1.59.0 及以上版本。
• 问题修复
  修复了一些问题。

2025-06-04

1.58.0

同步开播 SDK 升级版本号。

2025-05-20

1.57.0

优化
完善 SDK 日志上报信息，增强问题排查能力。

2025-04-29

1.56.0

• 升级必看
  • 变更初始化方式。详见步骤四：初始化 BDLive。
  • 方法删除
    在 BDLShoppingCardController 中，删除商品卡片跳转链接加载回调 openUrlBlock。替代方法为 onCardClickBlock。
  • 参数变更
    以下方法中，新增参数 cardModel（商品卡片 Model），从而获取商品信息。
    • BDLCardView 中的 viewTappedBlock
    • BDLShoppingCardView 中的 cardViewTappedBlock
    • BDLFloatingCardView 中的 viewTappedBlock
• 新增特性
  • 商品卡片
    新增以下商品卡片点击回调：
    • BDLFloatingController 下的 onCardClickBlock
    • BDLShoppingCardController 下的 onCardClickBlock
  • 初始化
    • 新增初始化 SDK 方法。详见 startWithAuthInfo:complete:。
    • 支持获取 BDLiveManager 实例。详见 sharedInstance。
  • 观众连麦
    观众连麦期间，主持人开启全员开麦功能后，支持向连麦观众发送开麦申请。
• 问题修复
  修复了一些问题。

2025-04-15

1.55.0

• 升级必看
  • 参数变更
    以下方法的参数 reason 变更为 info：
    • onUserForceOfflineBlock
    • basePlayerView:onUserForceOffline:
    • playerView:onUserForceOffline:
    • floatingPlayer:onUserForceOffline:
  • 枚举值类型变更
    BDLForceOfflineReason 中，BDLiveForceOfflineReasonMultiLogin 变更为 BDLForceOfflineReasonMultiLogin、BDLiveForceOfflineReasonCheckInTimeout 变更为 BDLForceOfflineReasonCheckInTimeout。
• 新增特性
  • BDLForceOfflineReason 中，新增以下观众被强制退出直播间的原因：
    • BDLForceOfflineReasonIPBanned（IP 被封禁）
    • BDLForceOfflineReasonKickOut（被踢出）
  • 支持将观众踢出直播间以及封禁观众 IP 地址。
• 优化
  优化观看页签到的 UI 样式，提升用户体验。
• 问题修复
  修复了一些问题。

2025-04-01

1.54.0

• 升级必看
  • 删除部分方法
    • 删除 textFieldShouldBeginEditing（是否允许观众在评论输入框中输入内容）方法，替代方法为 textViewShouldBeginEditing。
    • BDLCommentInputBaseView 中，删除 customizeTextField（自定义评论输入框）方法，可通过 BDLCommentViewConfiguration(Config)、BDLCommentBaseConfiguration(Config) 或 BDLPrivateChatConfig 下的属性自定义评论输入框的样式等。
    • BDLCommentInputBaseView 中，删除 textField（评论输入框）属性。
    • BDLPrivateChatView 中，删除 sendButton（发送按钮）属性。
    • BDLCommentBaseConfiguration(Config) 中，删除 inputTextIconImage（评论输入框左侧图标）属性。
  • 方法名称变更
    resetTextField:（重置评论输入框）变更为 resetTextView:。
• 新增特性
  • 数据上报
    新增支持数据上报。详见 externalReportConfig。
  • 自定义评论输入框
    • 支持设置评论输入框内输入的文字颜色。详见 inputBoxTextColor。
    • 支持设置评论输入框内的最大字符数限制。详见 commentInputCountLimit。

2025-03-18

1.53.0

• 升级必看
  • 删除部分属性
    在 BDLCommentViewConfiguration(Config) 中，删除 likeIconImage（评论未点赞状态的点赞按钮图片）和 likedIconImage（评论已点赞状态的点赞按钮图片），替代属性为 commentLikeIcon 和 commentLikedIcon。
  • 废弃部分属性
    在 BDLCommentViewConfiguration(Config) 中，welcomeTextColor（聊天欢迎语文字颜色）属性已废弃，替代属性为 systemCommentColor。
  • 适用范围变更
    • commentFont 仅支持设置非主持人评论的字体、字号等。如需设置主持人评论的字体、字号等，请使用 hostCommentFont。
    • hostCommentColor 仅支持设置主持人的评论文字颜色。如需设置主持人标签的颜色，请使用 hostTagColor。
• 新增特性
  • 自定义评论输入框
    • 支持设置是否允许观众在评论输入框中输入内容。详见 textFieldShouldBeginEditing。
    • 在观众进入直播间之前或之后，支持设置评论输入框非编辑状态（未弹出键盘时）的以下属性：
      • 底色，详见 inputBoxBackgroundColor。
      • 圆角半径，详见 inputBoxCornerRadius。
      • 边框宽度，详见 inputBoxBorderWidth。
      • 边框颜色，详见 inputBoxBorderColor。
      • 提示文字颜色，详见 inputBoxPromptColor。
  • 自定义评论区样式
    • 支持设置聊天欢迎语和竖屏模式下直播描述的以下属性：
      • 标签的字体、字号等，详见 systemTagFont。
      • 标签的颜色，详见 systemTagColor。
      • 正文的字体、字号等，详见 systemCommentFont。
      • 正文颜色，详见 systemCommentColor。
    • 支持设置相邻评论单元格之间的间距。详见 distanceBetweenCell。
    • 支持设置评论列表底部与评论输入框顶部的间距。详见 commentListViewBottomMargin。
    • 支持设置下拉刷新组件内容的颜色，例如 ↓ 下拉加载更多评论。详见 commentListPullToRefreshColor。
    • 支持设置主持人标签的颜色和评论的字体、字号等。详见 hostTagColor 和 hostCommentFont。
  • 新增 floatingControllerConfig（浮窗 controller 配置）属性，支持设置是否在弹出键盘时自动隐藏所有浮窗控件，例如浮窗商品卡片、浮标广告、互动工具浮窗等。
• 问题修复
  修复了一些问题。

2025-03-06

1.52.0

• 升级必看
  • 逻辑变更
    更新直播期间遇到卡顿时的处理逻辑。在 isNeedAutoDemote 取值为 YES 时，新增根据 backupDowngradeWhenStall 的取值判断是否直接切换主备流。
  • 删除部分方法
    在 BDLMultiLanguageView 中：
    • 删除方法 show（显示多语言选择弹窗 view），替代方法为 bottomShowInView:completion:。
    • 删除方法 hide（隐藏多语言选择弹窗 view），替代方法为 hideWithCompletion: 或 hideWithAnimation:completion:。
• 新增特性
  • 主播账号
    • 新增支持关注主播。
    • 新增 businessAccountConfig（主播账号配置）属性，支持设置已关注或未关注主播时的按钮文字和背景图片等。
  • 多语言
    新增支持韩语。

2025-02-24

1.51.1

同步开播 SDK 升级版本号。

2025-02-18

1.51.0

• 升级必看
  • 删除部分方法、属性、回调和 view
    • 删除 BDLBottomNoticeView（横屏直播间进场消息 view）、BDLEnterLiveRoomNoticeView（竖屏直播间进场消息 view），替代 view 为 BDLCommentAndNoticeView（评论和通知 view）。
    • 删除 BDLBottomNoticeViewProtocol（底部消息通知 view 的协议）。
    • 在 BDLTopCommentView 中，删除 shouldHandleGestureRecognizerWithTouch:（是否处理手势）方法。
    • 在 BDLFloatingCardView 中，删除属性 containerView（容器 view）、titleLabel（商品名称 label）、highLightBgView（售卖价背景 view）、highLightLabel（售卖价 label）、imageView（商品图）、closeButton（关闭按钮）、goImageView（GO 的 imageView）、explainingButton（讲解中标签）。
    • 在 BDLCommentView 中：
      • 删除 bottomNoticeView（底部消息通知 view）属性。
      • 删除方法 customizeBottomNoticeView（自定义底部消息通知 view），替代方法为 customizeCommentAndNoticeView（自定义横屏直播间的评论和通知 view）和 customizeCommentAndNoticeView（自定义竖屏直播间的评论和通知 view）。
    • 在 BDLLivePullViewController() 中，删除 commentView（评论区 view）属性，替代属性为 commentAndNoticeView（评论和通知 view）。
    • 在 BDLMenuBarView 中：
      • 删除 commentView（横屏直播间菜单栏中的评论 view）属性，替代属性为 commentAndNoticeView（横屏直播间的评论和通知 view）。
      • 删除 customizeCommentView（自定义横屏直播间菜单栏中的评论 view）方法，替代方法为 customizeCommentAndNoticeView（自定义横屏直播间的评论和通知 view）。
    • 由于置顶评论 UI 样式变更，在 BDLCommentViewConfiguration(Config) 中删除 topTagFont（置顶标签字体和字号）属性。
  • 方法位置变更
    • 以下方法从 BDLCommentView 下变更至 BDLCommentAndNoticeView 下。
      • topCommentClickBlock（置顶文字评论点击回调）
      • topCommentNicknameClickBlock（置顶评论昵称点击回调）
      • topCommentImageClickBlock（置顶图片评论点击回调）
    • 以下方法从 BDLLivePullViewControllerConfig 下变更至 BDLCommentAndNoticeViewConfiguration 下：
      • customizePortraitCommentViewHeight（自定义竖屏直播间评论区（包含输入框）的高度）
      • customizeCommentView（自定义竖屏直播间的评论 view）
      • customizeNoticeContainerView（自定义通知的容器 view）
  • 更新 setNickname:complete: 方法的实现逻辑，仅支持在观众进入直播间前调用该方法。如果昵称注册失败，则 SDK 会在下次触发昵称注册时，使用 nickname 的取值完成昵称注册，同时触发昵称注册完成回调。如果依然失败，则会在下次触发昵称注册时继续，直至成功。
  • 默认值变更
    • rowsOfTopComment（置顶评论展示行数）的默认值从 2 变更为 1。
    • 竖屏直播间评论区（包含输入框）的默认高度从完整直播间高度的 0.4 倍变更为 241 pt。详见 customizePortraitCommentViewHeight。
  • 适用范围变更
    backgroundColor 新增支持适用于进场消息。
• 新增特性
  • 商品卡片菜单
    • 新增 productOriginalPriceShowStrikethrough 方法， 支持设置是否显示商品参考价的删除线。
    • 新增 BDLCardReminderType（商品提醒类型）。
    • 新增支持以下功能。
      • 活动标签
        
      • 卖点标签
        
      • 在商品讲解期间，动效展示商品的热卖和库存情况，促进下单
        • 热卖情况
          
        • 库存情况
          
  • 聊天互动菜单
    新增支持在聊天区域展示查看商品消息和下单购买消息。
    • 查看商品消息
      
    • 下单购买消息
      
  • 浮窗商品卡片
    新增 cornerRadius（浮窗商品卡片背景的圆角）属性。
  • 进场消息
    • 新增 joinRoomMsgNicknameColor（进场消息中昵称的文字颜色）属性。
    • 新增 joinRoomMsgContentColor（进场消息中内容的文字颜色）属性。
  • 置顶评论
    新增 topCommentView:didClickComment: 方法。在观众点击置顶评论的文字或空白区域时，SDK 调用该方法。
  • 直播间配置
    新增评论和通知 view 配置。详见 commentAndNoticeViewConfig。
  • 错误码
    新增调用 setNickname:complete: 方法设置用户昵称失败的错误码 BDLErrorCodeUserHasJoinLiveRoom。详见错误码。
• 优化
  优化商品卡片、置顶评论、进场消息等 UI 样式，提升用户体验。

2025-01-21

1.50.0

• 升级必看
  删除属性
  在 BDLPlayerLandscapeConfiguration 中，删除 popularityFont（人气标签文字的字体和字号）和 popularityImage（人气图标）属性。
• 新增特性
  直播间人气
  新增支持配置人气图标，以及人气标签文字的字体、字号和颜色。详见 BDLPeopleCountConfiguration(Config) 和 peopleCountConfig。

2025-01-08

1.49.0

• 升级必看
  删除方法
  在 BDLPlayerViewDelegate 中，删除在观众双击播放器时调用的 playerViewDidDoubleTap: 方法。
• 新增特性
  • 在直播加载遇到错误时，支持通过 liveError 获取具体的错误信息。
  • 新增支持日志查询单点追踪，提升 SDK 问题定位能力。
• 问题修复
  修复了一些问题。

2024-12-24

1.48.0

问题修复
修复了一些问题。

2024-12-10

1.47.3

• 升级必看
  在竖屏直播间中自定义 customizePageAdView 的 frame方式变更：从在 customizeViewConstraints 中通过 mas_remakeConstraints 设置，变更为直接修改 frame，但 frame.origin 会被忽略，即只支持修改 frame.size。
• 新增特性
  支持将自定义悬浮 view 显示在直播间右上方。详见 BDLFloatingControllerInsertPosition。
• 问题修复
  修复了一些问题

2024-11-27

1.47.2

问题修复
修复了一些问题。

2024-11-26

1.47.1

问题修复
修复了一些问题。

2024-11-12

1.47.0

• 新增特性
  • 抽奖和问卷
    新增支持定时发送的实时抽奖和问卷。
  • 渐变蒙层
    支持设置是否在竖屏直播间顶部显示渐变蒙层。如果您的视频画面背景为白色，显示渐变蒙层可使直播间顶部的白色文字更明显。详见 showPortraitRoomTopShadow。
• 问题修复
  修复了一些问题。

2024-11-08

1.46.3

• 新增特性
  • 完整直播间
    新增配置了跳转链接的商品卡片和广告点击事件的默认实现 defaultOpenURLAction:enableFloating:。
  • 商品卡片
    新增 openUrlBlock 方法。在需要加载商品卡片跳转链接时，SDK 会调用该方法。
• 问题修复
  修复了一些问题。

2024-11-06

1.46.2

问题修复
修复了一些问题。

2024-10-31

1.46.1

• 优化
  适配 iOS 18。
• 问题修复
  修复了一些问题。

2024-10-24

1.46.0

• 新增特性
  • 系统媒体中心信息展示
    
    • 新增支持自定义系统媒体中心展示的信息。详见 customizeNowPlayingInfoBlock。
    • 新增支持设置是否响应系统媒体中心的用户操作。详见 shouldHandleRemoteCommand。
  • 观众连麦

    • 在直播屏幕方向为竖屏时，支持观众连麦功能。

    • 连麦模块支持组件化接入。代码示例详见组件化接入连麦模块。

      • 新增 BDLAudienceLinkEntranceView（连麦入口 view），用于展示申请连麦按钮。
      • 新增 BDLAudienceLinkPreviewView（连麦本地画面预览 view），用于展示当前连麦观众的本地视频画面。
      • 新增 BDLAudienceLinkRemoteContainerView（连麦画面容器 view），用于展示当前连麦观众和其他连麦参与者的画面。
      • 新增 BDLAudienceLinkController（连麦 controller），用于设置连麦相关回调、申请连麦、断开连麦等。
      • 新增 customizeAudienceLinkController 方法，用于自定义连麦 controller。
      • 新增 cancelAudienceLinkIfNeededAndClose: 方法，用于在观众连麦期间，断开观众的连麦并关闭直播间。
      • 新增 startAnimating 方法，用于开始展示连麦动画。SDK 会在第一次显示连麦入口 view 时调用该方法。
• 问题修复
  修复了一些问题。

2024-10-15

1.45.0

• 升级必看
  该版本竖屏直播间 UI 变化较大，因此涉及较多方法、属性、回调和 View 的变动。
  • 删除部分方法、属性、回调和 View
    • 删除 BDLPopularityView（人气显示 view）。
    • 删除 BDLPlayerMaskView 下的 popularityView（人气显示 view）属性以及 BDLLivePullViewController() 下的 popularityView（人气显示 view）属性，替代属性为 popularityLabel（人气 label，包含人气值和人气图标）。
    • 删除 BDLMultiLanguageView 下的 titleLabel（标题 label）属性。
    • 删除 BDLLivePullViewControllerConfig 下的自定义竖屏模式下的人气显示方法 customizePopularityView。
    • 删除 BDLMenuBarView 下的自定义商品卡片 view 方法 customizeCardView。
    • 删除 BDLFloatingInteractiveToolView 下的初始化方法 initWithType:，替代方法为 initWithType:isPortrait:，新增传入参数 isPortrait。
    • 删除 BDLCardView 下的商品卡片搜索回调 onSearchButtonClickBlock，替代回调为 onCardSearchClickBlock。
    • 删除 BDLCardView 下的 searchButton（商品卡片搜索按钮）属性。
    • 删除 BDLCommentView 下的以下属性：
      • shoppingCardButton（购物车按钮）
      • interactiveButton（竖屏模式下的互动工具按钮）
      • moreOptionsButton（竖屏模式下的更多选项按钮）
      • privateChatButton（竖屏模式下的私聊互动按钮）
      • imageTextButton（竖屏模式下的图文介绍按钮）
      • embeddedUrlButton（竖屏模式下的内嵌链接按钮）
      • interactiveToolUnreadLabel（竖屏模式下的互动工具未读数量 label）
    • 删除 BDLCardConfiguration(Config) 下的 strikeThroughStyle（划线 style）属性。
    • 删除互动工具菜单配置 BDLInteractiveToolConfiguration(Config) 下的以下属性：
      • nameTextColor（名称文字颜色）
      • textColor（内容文字颜色）
      • contextTitleTextColor（内容标题的颜色）
      • cellBackgroundColor（cell 背景颜色）
      • cellCornerRadius（cell 圆角）
    • 删除 BDLInteractiveVoteModel 下的 deadlineString（由时间戳转换为 yyyy/MM/dd HH:mm 格式的倒计时文字）属性。
  • 属性位置变更
    • 以下商品卡片相关属性从 BDLCardConfiguration(Config) 下变更至 BDLCardConfiguration 下：
      • cardTitleColor（标题颜色）
      • strikeThroughTextColor（划线文字颜色）
      • cardHighLightColor（高亮文字颜色）
      • cardCellColor（cell 颜色）
    • totalCountLabel（“共 x 件商品”文案 label）从 BDLCardView 下变更至 BDLShoppingCardView。
    • shareImage（竖屏模式下的分享按钮图片） 属性从 BDLMoreOptionsViewConfiguration(Config) 下变更至 BDLCommentViewConfiguration(Config) 下。
  • 回调位置变更
    • 以下回调从 BDLCommentView 下变更至 BDLMenuItemsController 下：
      • 互动工具按钮点击回调 interactiveToolClickBlock
      • 购物车按钮点击回调 shoppingCardClickBlock
      • 更多选项按钮点击回调 moreOptionsClickBlock
      • 私聊互动按钮点击回调 privateChatClickBlock
      • 图文介绍按钮点击回调 imageTextClickBlock
      • 内嵌链接按钮点击回调 embeddedUrlClickBlock
      • 直播间点赞按钮点击回调 likeClickBlock
    • 以下回调从 BDLMenuBarView 下变更至 BDLShoppingCardView 下。
      • 商品卡片点击回调 cardViewTappedBlock
      • 商品卡片搜索回调 onCardSearchClickBlock
    • 分享按钮点击回调 shareClickBlock 从 BDLMoreOptionsController 下变更至 BDLMenuItemsController 下。
  • 适用范围变更
    • BDLBottomNoticeView 由横竖屏直播间的进场消息 view 变更为横屏直播间的进场消息 view。新增竖屏直播间的进场消息 view BDLEnterLiveRoomNoticeView。
    • customizeTitleLabel 由自定义横屏模式下的顶部直播标题变更为自定义横竖屏模式下的顶部直播标题。
• 新增特性
  • 礼物打赏
    • 新增支持礼物打赏功能，观众可在观看页发送礼物。有关如何开启礼物打赏功能，详见礼物打赏。
    • 新增礼物按钮点击回调。详见 giftClickBlock。
  • 商品卡片
    • 支持设置观众是否能够拖动浮窗商品卡片。详见 setFloatShoppingCardMovable:。
    • 支持自定义商品卡片相关 controller。详见 customShoppingCardController。
    • 新增 explainingButton（讲解中标签）属性。
    • 新增商品卡片 view BDLShoppingCardView。
  • 浮标广告
    支持设置观众是否能够拖动浮标广告。详见 setFloatAdMovable:。
  • 直播分享
    新增分享弹窗中的 saveButton（保存按钮）和 cancelButton（取消按钮）属性。
  • 私聊互动
    • 新增关闭按钮点击回调。详见 onCloseBlock。
    • 新增 nameLabel（竖屏模式下的菜单名称 label）属性。
    • 新增 closeButton（竖屏模式下的关闭按钮）属性。
    • 新增 sendButton（发送按钮）属性。
  • 互动工具
    • 新增互动工具弹窗关闭按钮点击回调。详见 onCloseBlock。
    • 新增 totalLabel（直播间内发送的互动工具总条数 label）属性。
    • 新增 isDarkTheme（是否为暗黑模式主题）属性。
    • 新增 closeButton（互动工具弹窗关闭按钮）属性。
  • 评论区
    • 新增 menuItemsController（评论区底部按钮的 controller）属性。
    • 新增评论区底部按钮的 controller BDLMenuItemsController。
  • 弹窗
    支持设置弹窗的圆角半径。详见 setContentViewCornerRadii:。
• 优化
  优化竖屏直播间样式，提高观众体验。
• 问题修复
  修复了一些问题。

2024-09-12

1.44.0

• 新增支持签到功能。
• 适配 Xcode 16。
• BDLRiskWarningView 下的 maskView 属性更名为 bottomMaskView。
• BDLPlayerView 下的 maskView 属性更名为 playerMaskView。

2024-08-22

1.43.2

新增 showCloseButtonWhenClearingScreen 属性，用于设置清屏期间是否显示关闭直播间按钮。

2024-08-20

1.43.1

支持禁止重复登录功能。涉及以下回调：

• onUserForceOfflineBlock
• basePlayerView:onUserForceOffline:
• playerView:onUserForceOffline:
• floatingPlayer:onUserForceOffline:

2024-08-15

1.43.0

• 横屏直播间支持展示购物车按钮。
• 支持读取服务端返回的图文介绍文字颜色。

2024-08-01

1.42.0

BDLBasePlayerConfiguration 中新增 isNeedAutoDemote 方法，用于设置直播期间遇到卡顿时，是否支持自动降级或提供提示信息。

2024-07-23

1.41.0

直播预约逻辑优化。

2024-06-28

1.40.1

• BDLUpperAdView 中的 viewTappedBlock 方法新增参数 enableFloating。
• 修复了一些问题。

2024-06-26

1.40.0

• 删除 BDLActivity 中的 nickName 属性。
• 废弃 BDLLiveEngine 中的 joinLiveRoomWithActivity: 方法。
• BDLLiveRoomConfiguration 下，新增 userInfoConfig（用户信息配置）属性。
• 新增用户信息配置 BDLUserInfoConfiguration，包含 setNickname:complete: 方法，用于设置直播间鉴权模式为公开时的用户昵称。
• BDLCommentView 下，新增 imageTextButton（竖屏模式下的图文介绍按钮）属性和 imageTextClickBlock（竖屏模式下的图文介绍按钮点击回调）方法。
• BDLCommentViewConfiguration 下，新增 imageTextButtonImage（竖屏模式下的图文介绍按钮图片）属性。
• 竖屏直播间支持展示图文介绍菜单。
• 优化 UI 样式。
• 修复了一些问题。

2024-06-13

1.39.1

修复了一些问题。

2024-06-07

1.39.0

• 支持展示动态表情包。
• BDLLivePullViewControllerConfig 下删除自定义弹窗 view 的方法 customizeAlertController，新增 customizePopupTopCommentView 和 customizePopupWebView 方法，分别用于自定义置顶评论详情弹窗 view 和 WebView 弹窗。
• BDLLiveRoomConfiguration 下删除 alertControllerConfig（弹窗配置）属性，新增 popupTopCommentViewConfig（置顶评论详情弹窗配置）和 popupWebViewConfig（WebView 弹窗配置）属性。
• BDLCommentView 下：
  • 删除 joinRoomNoticeView（进场消息 view）属性，新增 bottomNoticeView（底部消息通知 view）属性。
  • 删除 customizeJoinRoomNoticeView（自定义进场消息 view）方法，新增 customizeJoinRoomNoticeView（自定义底部消息通知 view）方法。
• BDLCommentViewConfiguration下新增 customizeCommentCell 方法，用于自定义评论 cell。
• 新增评论 cell BDLCommentViewCell。
• 新增置顶评论详情弹窗 BDLPopupTopCommentView 和置顶评论详情弹窗配置 BDLPopupTopCommentViewConfiguration。
• BDLMenuBarView 下，删除 customizeAlertController（自定义置顶评论的点击详情弹窗）方法。
• 删除弹窗 BDLAlertController 和弹窗配置 BDLAlertControllerConfiguration。
• 新增 WebView 弹窗 BDLPopupWebView 和 WebView 弹窗配置 BDLPopupWebViewConfiguration。
• 删除 BDLJoinRoomNoticeView（进场消息 view），新增 BDLBottomNoticeView（底部消息通知 view）。
• BDLPopupBaseView 下，新增：
  • 顶部显示弹窗的协议 BDLPopupTopShowViewProtocol。
  • setVerticalOffset: 方法，用于设置弹窗的内容 view 与弹窗顶部的间距。
  • topShowInView:completion: 方法，用于在顶部显示弹窗。
  • edgeInsets（ self 相对 superView 的偏移量）属性。
  • BDLPopupTopShowBaseView（顶部弹窗 view 的基类 view）。

2024-06-04

1.38.1

修复了一些问题。

2024-05-28

1.38.0

• 新增单次抽奖支持包含多个奖品。
• 优化实时抽奖的界面交互。
• BDLCommentBaseConfiguration 下，属性 likeIconImage（评论未点赞状态的点赞按钮）和 likedIconImage（评论已点赞状态的点赞按钮）变更为 commentLikeIcon 和 commentLikedIcon。
• BDLAwardWinnersView 下，属性 emptyHintLabel 和 bottomHintLabel 已废弃。
• 新增按钮信息 BDLThemeIconModel。
• 修复部分体验问题。

2024-05-24

1.37.1

BDLCommentBaseConfiguration 下新增 hostCommentBackgroundColor 属性，用于设置主持人的评论底色。

2024-05-22

1.37.0

• BDLMultiLanguageConfiguration 下新增 customLanguageString 回调，用于自定义系统文案。
• 新增 addCalendarEvent:alarms:startDate:endDate:completion: 方法，用于创建系统日历日程。
• BDLLiveRoomConfiguration 下新增 multiLanguageConfig 属性。
• BDLCountdownView 下：
  • 新增直播预约按钮点击回调 onBookingButtonClicked、系统日历日程创建结果回调 onCalendarResult，以及创建系统日历日程成功回调 setActivityBooked。
  • reservationButton 属性更名为 bookingButton。
• 新增直播预约信息 BDLActivityBookingModel。

2024-05-17

1.36.0

• BDLCommentViewConfiguration 中新增 showCommentBottomBar 属性，用于设置是否显示评论输入框及其右侧的交互按钮。
• 新增自定义的 IM（长链接消息）信令收到回调 onReceiveIMString:。
• 新增 IM 建立连接成功回调 onConnected。
• 新增 IM 建立连接失败回调 onConnectFailed。
• BDLCommentView 下：
  • 新增 sendTextMessage:success:failure: 方法，用于发送文字评论。
  • 新增文字评论点击回调 textContentClickBlock。

2024-05-07

1.35.0

• 内部播放器升级。
• 新增数据类型 BDLPlayerLoadState（播放器加载状态）。
• BDLPlayerState（播放器状态）新增枚举值 BDLPlayerStatePrepared。
• basePlayerView:liveLoadStateDidChange: 的入参 loadState 的数据类型从 TVLPlayerLoadState 变更为 BDLPlayerLoadState。
• basePlayerView:livePlaybackStateDidChange: 的入参 playbackState 的数据类型从 TVLPlayerPlaybackState 变更为 BDLPlayerState。
• BDLPlayerBaseConfiguration 中新增 scalingMode（视频画面的填充模式）属性。
• BDLPlayerCommonConfiguration 下删除 scalingMode（视频画面的填充模式）属性。
• 竖屏直播间的视频画面填充模式（BDLPlayerScalingMode）默认值从 BDLPlayerScalingModeNone 变更为 BDLPlayerScalingModeAspectFill。
• 横屏直播间的视频画面填充模式（BDLPlayerScalingMode）默认值从 BDLPlayerScalingModeNone 变更为 BDLPlayerScalingModeAspectFit。
• BDLPlayerScalingMode 删除枚举值 BDLPlayerScalingModeNone。

2024-04-29

1.34.1

修复了一些问题。

2024-03-28

1.34.0

• 支持同时开启主备流、超低延时直播和直播时移功能。
• 在直播期间，支持回看 8 小时内任意过去时间点的直播内容以及回看已讲解商品的直播画面。
• 在 BDLBasePlayerView 中：
  • 新增 seek 操作完成后回调 BDLBasePlayerViewSeekCompletionBlock。
  • seek:completion: 方法由 (void)seek:(NSTimeInterval)playbackTime completion:(void (^__nullable)(BOOL success))completion 变更为 (void)seek:(NSTimeInterval)playbackTime completion:(BDLBasePlayerViewSeekCompletionBlock _Nullable)completion。
• 修复了一些问题。

2024-01-31

1.33.1

BDLLivePullViewControllerConfig 中新增 isCloseWhileDisappear 属性，用于在 shouldShowInAppPipIfAvailable 属性传入的 isClose 参数值不符合预期时修正参数值。

2024-01-23

1.33.0

• BDLInteractiveToolConfiguration 中新增 showPeopleCount 属性，用于设置是否显示参与投票人数。
• 当某个商品卡片菜单内商品卡片大于等于 5 个时，支持根据商品标题或序号模糊搜索商品卡片。
  • BDLMenuBarView 中新增商品卡片搜索回调（onCardSearchClickBlock）。
  • BDLCardView 中的新增与修改如下所示：
    • 商品卡片选中回调（viewTappedBlock）新增传入参数 enableFloating。
    • 新增商品卡片搜索按钮（searchButton）属性。
    • 新增商品卡片搜索回调（onSearchButtonClickBlock）。
• BDLPopupBaseView 中新增 setShowAnimationDuration: 和 setHideAnimationDuration: 方法，分别用于设置显示和隐藏弹窗的动画时长。
• 修复部分体验问题。

2024-01-09

1.32.0

• 竖屏直播间支持右滑清屏。
• BDLLivePullViewControllerConfig 中新增 disableClearScreen 属性，用于设置是否禁用竖屏直播间的清屏功能。
• 竖屏直播间的更多选项弹窗中，新增清晰度选择按钮。您可以通过 BDLMoreOptionsViewConfiguration 的 resolutionImage 属性修改清晰度选择按钮的图片。
• 修复部分体验问题。

2023-12-07

1.31.0

• 支持按需优化包体积。详见优化包体积。
• 支持内嵌链接菜单。
• 竖屏模式支持页头图和页头广告。
• BDLCommentView 下新增以下内容：
  • embeddedUrlButton
  • embeddedUrlClickBlock
• BDLCommentViewConfiguration下新增 embeddedUrlButtonImage。
• BDLMenuBarView下新增以下内容：
  • customizeEmbeddedUrlWebView
  • filterOption
  • indexDidChangeBlock
• BDLMenuFilterOption（菜单过滤选项）新增支持 BDLMenuFilterOptionEmbeddedUrl（内嵌链接菜单）。
• audienceLinkEntranceView 和 audienceLinkPreviewView 从 BDLFloatingController迁移至 BDLFloatingController+BDLAudienceLink。
• BDLPageAdView下新增以下内容：
  • setShowOrHideBlock:
  • initWithPortrait:
  • showingPageAdModels
  • shouldShowAdBlock
• BDLPageAdView下的 viewTappedBlock 删除 urlStr 参数，新增 view、ad、isFloatingEnable 参数。您可以使用 ad.advertisementRedirectUrl 方法作为替代方法，获取企业直播控制台设置的跳转链接。
• BDLPageAdView下删除 closeButton。
• BDLPageAdViewConfiguration下新增 cornerRadius。
• BDLPopupBaseView下新增以下内容：
  • setContentViewCorners:
  • hideWithAnimation:completion:
  • topPopupViewInView:
  • neighborPopupViewInView:

2023-11-20

1.30.1

• 支持根据控制台的配置展示竖屏直播间的封面图。
• BDLLiveEngine 中新增 updateActivity:success:failure: 方法。
• BDLLivePullViewController 中新增 livePullViewControllerDidLoad: 方法。
• BDLFloatingController 中新增以下方法：
  • audienceLinkEntranceView
  • audienceLinkPreviewView
  • insertFloatingView:position:dragMode:
  • removeInsertedFloatingView:
• BDLBasePlayerView 中，basePlayerView:coverImageUrlDidChange: 方法删除 isEnabled（是否可用）参数。

2023-11-14

1.30.0

支持累计观看抽奖。

2023-11-03

1.29.3

解决了一些已知问题。

2023-10-10

1.29.2

解决了一些已知问题。

2023-09-27

1.29.1

• BDLLivePullViewController 中新增以下方法：
  • livePullViewControllerDidAppear:
  • livePullViewControllerDidDisappear:
  • isFloating
• BDLLivePullViewControllerConfig 中新增以下方法：
  • autoCloseFloatingPlayerWhenAppear
  • shouldShowInAppPipIfAvailable
• BDLBasePlayerView 中新增以下方法：
  • basePlayerView:livePlaybackStateDidChange:
  • visible
• BDLPlayerView 新增以下方法：
  • play
  • pause
• BDLPlayerCommonConfiguration 中删除以下方法：
  • enableInAppLivePiP
  • enableInAppVodPiP

2023-09-22

1.29.0

• 支持根据控制台的配置展示竖屏直播间的菜单图标。

• BDLCommentViewConfiguration 中新增以下方法，用于设置竖屏直播间的图标。

  • shoppingCardButtonImage：商品卡片图标
  • interactiveButtonImage：互动工具图标
  • privateChatButtonImage：私聊互动图标
  • moreOptionsButtonImage：更多选项图标

  以上方法配置的优先级高于控制台配置。

2023-09-12

1.28.2

BDLPlayerCommonConfiguration 中新增 enterFullScreenEnable 方法。

2023-08-31

1.28.1

解决了一些已知问题。

2023-08-24

1.28.0

• 支持投票、公告、答题功能。
• BDLLivePullViewControllerConfig 中新增以下方法：
  • customInteractiveToolController
  • customFloatingController
• BDLLivePullViewControllerConfig 中删除以下方法：
  • customizeInteractiveToolView
  • customizeUpperAdView
  • customizeFloatingCardView
  • customizeFloatingAwardView
  • customizeAwardContactView
  • customizeAwardDetailsView
  • customizeAwardWinnersView
  • customizeAwardResultView
• BDLCommentView 中新增 interactiveToolUnreadLabel 方法。
• BDLMenuBarView 中删除以下方法：
  • customizeInteractiveToolView
  • interactiveToolViewURLTappedBlock
  • interactiveToolAwardClickedBlock
• 新增 BDLFloatingController、BDLInteractiveToolController、BDLFloatingInteractiveToolView。
• BDLInteractiveToolView 中删除 onAwardClickedBlock 方法并新增 onContextClickBlock 方法。
• BDLInteractiveToolContentView 中删除 didClickContextViewWithModel: 和 didClickContextViewButtonWithModel: 方法，并新增didClickContextViewWithModel:contextModel: 方法。
• 删除 BDLFloatingAwardView。

2023-08-03

1.27.0

支持问卷功能。

2023-07-20

1.26.0

解决了一些已知问题。

2023-07-07

1.25.2

解决了一些已知问题。

2023-07-06

1.25.1

• 优化英文文案。
• 修复表情包展示问题。

2023-07-04

1.25.0

• 支持根据控制台配置，展示自定义的直播间点赞特效。详见直播间点赞。控制台配置的优先级低于 SDK 定制化配置。有关如何在 SDK 中配置直播间点赞特效，详见 BDLCommentViewConfiguration。
• 支持检测观众认真度。详见认真度检测。
• 优化直播间数据上报。

2023-06-05

1.24.0

同步开播 SDK 升级版本号。

2023-05-18

1.23.0

• 支持发送和接收图片评论。
• 完善直播间性能埋点。
• 新增图片评论相关点击回调。
• 优化了浮窗播放器的相关 API。
• 优化了浮窗播放器的切换效率，避免在切换时重新加载视频内容。
• 新增 getLivePullViewControllerWithBasePlayerView: 方法。

2023-04-28

1.22.0

• 支持直播私聊。
• 优化商品卡片展示样式。
• 优化聊天互动菜单下的评论拉取效果，减少评论展示的时间间隔，提高观众体验。

2023-03-31

1.21.0

增加直播间性能埋点。

2023-03-28

1.20.0

支持超低延时直播。

2023-03-01

1.19.2

解决了一些已知问题。

2023-02-27

1.19.1

• 新增 API 用于关闭完整直播间，同时可设置是否显示浮窗。
• 新增 API 用于显示浮窗，同时可设置是否关闭完整直播间。
• 新增 API 用于关闭浮窗，同时可设置是否显示完整直播间。

2023-02-08

1.19.0

• 优化直播间点赞功能，包括：
  • 优化直播间点赞效果
  • 支持自定义直播点赞图标
  • 支持显示点赞数
  • 支持同步点赞数据至企业直播控制台
• 优化直播分享功能，支持分享专属的以及自定义的分享链接、二维码以及邀请海报。
• 观众连麦支持演讲者视图以及主持人对观众的全场控制，包括申请打开或直接关闭观众摄像头/麦克风、全员静音以及修改观众昵称。详见观众连麦。

2023-02-02

1.18.2

解决了一些已知问题。

2023-01-17

1.18.1

• 支持举报评论。
• 当存在一个以上直播线路时，支持线路选择。当上架一个以上回放视频时，支持查看上架的回放视频列表并循环播放列表中的回放视频。
• 直播间开启聊天审核功能后，评论在通过审核前仅发送评论的观众自见。

2023-01-10

1.18.0

• 直播支持主备流。
• 支持回复评论。
• 支持显示水印。
• 支持从 InApp 画中画切换至后台的系统画中画。
• 支持在全屏模式下触发画中画。
• 以下新增功能仅适用于竖屏直播间：
  • 支持根据源流画面宽高比以不同方式展示视频画面。当源流画面宽＞高时，视频以横屏样式展示并支持切换为全屏模式。
  • 点播支持倍速播放、清晰度选择。
  • 企业直播控制台可同步评论区颜色配置至竖屏直播间。

2022-11-23

1.17.0

• 支持观众连麦。
• 新增 userUniqueId 用于获取用户的唯一 ID。

2022-10-28

1.16.0

• 支持点播视频自动断点续播后显示提示。
• 提供 iPad Demo，包含多种 iPad 布局方式的示例代码。

2022-10-12

1.15.0

• 支持点播视频的自动断点续播。
• 支持在直播间评论区内展示用户头像。
• 支持直播间风险提示、聊天欢迎语和系统消息，其中系统消息包含抽奖通知、进场通知和自定义系统消息。
• 支持展开显示直播描述。
• 新增 clearCache 用于清除观众当前设备上 SDK 的所有本地缓存。

2022-09-16

1.14.2

• 广告点击回调、卡片点击回调、卡片选中回调、控件点击回调的参数类型由 NSURL 改为 NSString。
• 调整抽奖图标的显示顺序。默认已开奖的抽奖图标显示在待开奖的抽奖图标上方。
• 修复部分情况下退出全屏时评论区显示异常的问题。

2022-09-14

1.14.1

• 支持自定义横屏直播间内评论输入框的文字颜色。
• 修复无页中广告时，菜单导航栏不上移，出现空白区域的问题。
• 修复浮标广告和抽奖图标样式不统一的问题。
• 修复横屏直播间内输入评论时，直播间整体上移的问题。
• 修复横屏直播间进入小窗后，调用 [livePullVC updateViews] 小窗消失的问题。

2022-09-05

1.14.0

• 支持预约直播并在系统日历中添加事件。
• 支持点击横屏模式下的页头广告跳转和点击评论区的用户昵称跳转。

2022-08-22

1.13.0

• 预告和回放视频支持画中画功能。
• 支持抽奖。
• 清晰度新增流畅档位。
• 新增调用 SDK API 的 Demo，降低接入成本。详见跑通 Demo。

2022-06-13

1.12.0

• 新增接口支持部分自定义配置。
• 支持独立播放器，即播放器内无进度条等互动按钮。
• 竖屏模式下新增更多图标，收纳低频使用的功能入口。
• 竖屏模式下支持清屏功能。清屏后只显示企业账号、播放器画面、关闭直播间图标。其中企业账号如果未配置，则也不会显示。
• 新增观众评论链接点击事件。
• 支持显示 WebP 格式图片。

2022-05-10

1.11.1

• 支持直接进入 App 内的直播画中画页面。
• 支持自定义菜单页签文字颜色。
• 支持显示商品卡片的划线文字。
• 支持直播倒计时。

2022-04-15

1.7.2

横屏模式下支持显示直播间描述。

2022-01-18

1.7.1

• 评论区支持单模块接入。
• 单模块接入支持通过API设置语言。
• 调整企业账号默认frame，不遮挡视频。

2021-12-30

1.7.0

• 企业账号功能区，若未配置链接，用户点击后不产生交互反馈。
• 横屏模式下显示企业账号。
• 若观众发言命中敏感词，仅自见，不提示无法发送，敏感词可以点赞和取消点赞。
• 评论区支持跟随页面语言翻译。
• 评论自定义权限，调用业务方的账号体系登录。
• 支持直达链接。

2021-12-14

1.6.0

• 支持浮标广告。
• 竖屏模式下支持页中广告。
• 支持分享功能。
• 支持图文直播。
• 竖屏模式下支持评论点赞。
• 热门评论支持点赞，通过控制台的“显示赞数”开关，来显示或隐藏点赞数和点赞按钮。
• 点击浮标广告时，上报view_ad事件，含AdType（如3，表示浮标广告）、AdId、AdLink（跳转链接）等字段。

2021-12-01

1.5.0.8

基于UIWindow重构悬浮视频窗，使得悬浮窗永远保持在最前面。

2021-11-17

1.5.0.7

• 新增 leaveLiveRoom API。
• 将内部的 ViewController、FloatingView 通过 block 回调给业务。
• 替换了表情里的部分文案。
• 实现了基于 UIWindow 的 FloatingView 容器。

2021-11-05

1.5.0.6

区分自定义跳转至业务内部页面时的事件源，是从企业账号、页中广告、还是商品卡片上跳转。