最近更新时间:2024.05.07 16:01:29
首次发布时间:2024.02.21 18:10:12
本文介绍 iOS 观播 SDK 进阶功能的接入方法。您可以根据实际业务需求,按需实现复杂功能。
本文介绍以下功能的接入方法。
如果您需要观众先登录您的 App 再观看直播或参与评论、互动等操作,可以选择自定义登录方式,观众可以使用在您 App 中的身份信息进入直播间。
您可以按需选择观众在您 App 的登录时机。
观众先完成登录,再进入直播间。
mode
=2
时的授权 Token。joinLiveRoomWithActivity:
或 joinLiveRoomWithActivity:success:failure:
方法进入直播间。示例代码如下所示。
- (void)joinLiveRoom { BDLActivity *activity = [[BDLActivity alloc] init]; activity.activityId = @(167808997736****); // 直播间的活动 ID。 activity.token = @"ak3T%2FdaGJDL5zSFD7%2F1GPGP****"; // mode=2 时的授权 Token。 activity.isPortrait = YES; // 竖屏直播间。 activity.authMode = BDLActivityAuthModeCustom; // 自定义模式。 [[BDLLiveEngine sharedInstance] joinLiveRoomWithActivity:activity]; }
观众先进入直播间观看直播、查看评论等,在参与评论、互动等操作时触发登录流程,将鉴权模式从公开模式切换为自定义模式。
注意
如果您在创建进入直播间所需的 Activity 时,为 activity.nickName
设置了值,则不会触发 BDLLoginProvider 的任何方法。
观众先以公开模式进入直播间。
您需自行实现获取公开模式 Token 的方法,通过调用 GetSDKTokenAPI 接口请求 mode
=1
时的授权 Token。
设置 BDLLiveEngine
的 loginProvider
,即自定义登录直播间代理。
示例代码如下所示。
... [[BDLLiveEngine sharedInstance] setLoginProvider:self]; ...
调用 SDK 的 joinLiveRoomWithActivity:
或 joinLiveRoomWithActivity:success:failure:
方法进入直播间。
在观众进行以下需要用户信息的操作时,会触发 App 的自定义登录流程:
SDK 调用 loginWithActivity:completion:
方法,允许观众通过您的 App 登录直播间。您需要自行实现获取自定义模式 Token 的方法,并在观众完成自定义登录后,通过调用 GetSDKTokenAPI 接口请求 mode
=2
时的授权 Token。在成功获取 Token 后,您需调用 completion
方法将 Token 传入 SDK。
示例代码如下所示。
- (void)loginWithActivity:(BDLActivity *)activity completion:(void (^)(NSString * _Nullable token))completion { // 请将 getToken: 方法替换为您用来获取授权 Token 的方法。 [self getToken:^(NSString *token) { completion(token); }]; }
SDK 通过 Token 向企业直播请求观众信息。
企业直播验证 Token 合法后,将观众信息传入 SDK。如果 Token 验证失败或为空,则将报错信息传入 SDK。
SDK 调用 loginComplete:error:
方法通知 App 自定义登录流程是否成功。
示例代码如下所示。
- (void)loginComplete:(BDLActivity *)activity error:(NSError *)error { if (!error) { NSLog(@"自定义登录成功"); } else { NSLog(@"自定义登录失败 %@", error.localizedDescription); } }
(可选)如果在观众登录过程中关闭了直播间页面,SDK 会触发 cancelLoginWithActivity:
回调,您可按需取消自定义登录流程。
示例代码如下所示。
- (void)cancelLoginWithActivity:(BDLActivity *)activity { // 触发 cancelLoginWithActivity: 回调后,按需取消自定义登录流程 NSLog(@"登录过程中关闭了直播间页面,此时 App 可按需取消登录流程"); }
观众在点击菜单内商品卡片、页头广告、页中广告、浮标广告、浮窗商品卡片、主播账号头像、聊天互动菜单内评论区中的 URL 或置顶评论中的 URL 时,SDK 会执行后续默认的跳转行为。您可以通过拦截后续 SDK 的默认跳转行为,在观众完成点击后,实现自定义跳转逻辑,即 SDK 不会执行后续默认的跳转行为,从而能够根据特定场景或需求,定制页面的跳转行为,提升用户体验。
您可以在 configLivePullViewController:
中添加相关代码,获取点击的 URL 等信息并自定义跳转逻辑。
- (void)configLivePullViewController:(BDLLivePullViewController *)livePullVC { }
观众在点击菜单内的商品卡片后,触发 cardViewTappedBlock
回调,并向 App 传入商品卡片的跳转链接以及是否浮层展示商品详情页。
示例代码如下所示。
// 请与其他 customizeMenuBarView 方法合并使用,以免互相覆盖配置。 livePullVC.config.customizeMenuBarView = ^(BDLLivePullViewController * _Nonnull viewController, BDLMenuBarView * _Nonnull view) { view.cardViewTappedBlock = ^(NSString * _Nullable urlStr, BOOL enableFloating) { // 触发 cardViewTappedBlock 回调后,执行菜单内商品卡片的自定义跳转逻辑。 NSLog(@"%@ %d", urlStr, enableFloating); }; };
观众在点击页头广告后,触发 livePullViewController:didClickHeaderAd:floatingEnable:
回调,并向 App 传入页头广告跳转链接以及是否浮层展示广告页面。
示例代码如下所示。
- (void)livePullViewController:(BDLLivePullViewController *)livePullVC didClickHeaderAd:(NSString *)url floatingEnable:(BOOL)floatingEnable { // 触发 livePullViewController:didClickHeaderAd:floatingEnable: 回调后,执行页头广告的自定义跳转逻辑。 NSLog(@"%@ %d", url, floatingEnable); }
观众在点击页中广告后,触发 viewTappedBlock
回调,并向 App 传入当前的 BDLPageAdView
实例、广告相关信息以及是否浮层展示广告页面。
示例代码如下所示。
livePullVC.config.customizePageAdView = ^__kindof BDLBaseView * _Nullable(BDLLivePullViewController *viewController, BDLPageAdView * _Nonnull view) { view.viewTappedBlock = ^(BDLPageAdView * _Nonnull view, BDLAdvertisementModel * _Nonnull ad, BOOL isFloatingEnable) { // 触发 viewTappedBlock 回调后,执行页中广告的自定义跳转逻辑。 NSLog(@"%@ %d", ad.advertisementRedirectUrl, isFloatingEnable); }; return view; };
观众在点击浮标广告或浮窗商品卡片后,触发 openUrlBlock
回调,并向 App 传入浮窗控制器、广告或商品卡片的跳转链接以及是否浮层展示广告页面或商品详情页。
示例代码如下所示。
livePullVC.config.customFloatingController = ^(BDLLivePullViewController * _Nonnull viewController, BDLFloatingController * _Nonnull floatingController) { floatingController.openUrlBlock = ^(BDLFloatingController * _Nonnull floatingController, NSURL * _Nonnull url, BOOL isFloatingEnable) { // 触发 openUrlBlock 回调后,执行浮标广告或浮窗商品卡片的自定义跳转逻辑。 NSLog(@"url: %@ isFloatingEnable:%d", url, isFloatingEnable); }; };
观众在点击主播账号头像后,触发 viewTappedBlock
回调,并向 App 传入主播账号的跳转链接。
示例代码如下所示。
livePullVC.config.customizeAccountView = ^__kindof BDLBaseView * _Nullable(BDLLivePullViewController *viewController, BDLBusinessAccountView * _Nonnull view) { view.viewTappedBlock = ^(NSString * _Nullable urlStr) { // 触发 viewTappedBlock 回调后,执行主播账号头像的自定义跳转逻辑。 NSLog(@"%@", urlStr); }; return view; };
默认情况下,仅主持人评论中的 URL 为可点击状态。您可以通过以下方法,将观众评论中的 URL 设置为可点击状态。
[[[BDLLiveEngine sharedInstance] liveRoomConfiguration] commentViewConfig].enableAudienceURLTap = YES;
观众在聊天互动菜单内点击评论区中的 URL (非置顶评论 URL)后,触发 urlClickBlock
回调,并向 App 传入当前的 BDLCommentBaseView
实例、评论相关信息以及评论 URL。
示例代码如下所示。
void (^customizeCommentView)(BDLCommentView *view) = ^(BDLCommentView *view) { view.urlClickBlock = ^(__kindof BDLCommentBaseView * _Nonnull commentView, BDLCommentModel * _Nonnull comment, NSURL * _Nonnull url) { // 触发 urlClickBlock 回调后,执行评论区中 URL 的自定义跳转逻辑。 NSLog(@"%@ %@", url, comment); }; }; // 在竖屏直播间的聊天互动菜单评论区调用 urlClickBlock。 livePullVC.config.customizeCommentView = ^(BDLLivePullViewController * _Nonnull viewController, BDLCommentView * _Nonnull view) { customizeCommentView(view); }; // 在横屏直播间的聊天互动菜单评论区调用 urlClickBlock。 // 请与其他 customizeMenuBarView 方法合并使用,以免互相覆盖配置。 livePullVC.config.customizeMenuBarView = ^(BDLLivePullViewController * _Nonnull viewController, BDLMenuBarView * _Nonnull view) { view.customizeCommentView = ^(BDLMenuBarView * _Nonnull view, BDLCommentView * _Nonnull commentView) { customizeCommentView(commentView); }; };
观众点击置顶评论后,会弹出置顶内容弹窗,点击弹窗中的评论 URL 后,会触发 urlClickBlock
回调,并向 App 传入评论 URL。
示例代码如下所示。
livePullVC.config.customizeAlertController = ^__kindof UIViewController * _Nonnull(BDLLivePullViewController * _Nonnull viewController, BDLAlertController * _Nonnull controller) { __weak typeof(self) weakSelf = self; __weak BDLAlertController * weakController = controller; controller.urlClickBlock = ^(NSURL * _Nonnull url) { [weakController dismissAlertControllerAnimated:YES completion:^{ // 触发 urlClickBlock 回调后,执行置顶评论中 URL 的自定义跳转逻辑。 NSLog(@"%@", url); }]; }; return controller; };
您可以通过观播 SDK 自定义观看页的 UI 显示。
本文以直播带货场景中高频使用的 UI 定制功能点为例。更多 UI 定制相关方法与回调,详见 UI 定制。
竖屏直播间默认视频会保持原有宽高比例填充播放器,视频的宽高会填满播放器的宽高。如果视频宽高比与播放器宽高比不同,会有部分视频内容被裁剪掉。您可以自定义视频画面的填充模式。
以下示例代码将竖屏直播间的视频内容完全填充播放器,但视频宽高比可能发生变化。
BDLLiveRoomConfiguration *config = [[BDLLiveEngine sharedInstance] liveRoomConfiguration]; config.playerConfig.portrait.scalingMode = BDLPlayerScalingModeFill;
竖屏完整直播间的关闭按钮默认显示为 x。您可以自定义关闭按钮的显示样式。
以下示例代码将关闭按钮自定义为文件名为 back 的图片。
livePullVC.config.customizeCloseButton = ^__kindof UIButton * _Nullable(BDLLivePullViewController * _Nonnull viewController, UIButton * _Nonnull button) { // 自定义圆角和边框。 button.clipsToBounds = YES; button.layer.cornerRadius = 3; button.layer.borderWidth = 2; button.layer.borderColor = UIColor.grayColor.CGColor; // 自定义按钮的图标为文件名 back 的图片。 [button setImage:[UIImage imageNamed:@"back"] forState:UIControlStateNormal]; return button; };
竖屏完整直播间的关闭按钮默认显示在直播间的右上方。您可以自定义关闭按钮的显示位置。
以下示例代码将竖屏直播间的关闭按钮调整至直播间的左上方,并调整了主播账号头像 View 的显示位置,以免二者的显示位置重合。
// 自定义完整直播间的约束。 livePullVC.config.customizeViewConstraints = ^(BDLLivePullViewController * _Nonnull viewController) { // 自定义竖屏直播间的关闭按钮位置。 if (viewController.isPortrait) { // 重设关闭按钮的约束,将按钮位置从右上方调整至左上方。 [viewController.closeButton mas_remakeConstraints:^(MASConstraintMaker *make) { make.centerY.equalTo(viewController.accountView); make.left.mas_equalTo(0); make.size.mas_equalTo(40); }]; // 调整主播账号头像的位置, 避免与关闭按钮重合。 [viewController.accountView mas_updateConstraints:^(MASConstraintMaker *make) { make.left.mas_equalTo(50); }]; } };
互动工具浮窗,即包含抽奖、答题、投票、问卷和公告图标的浮窗。竖屏直播间默认展示在直播间左上方。您可以自定义互动工具浮窗的默认位置。
以下示例代码将互动工具浮窗的默认位置向下移动了 50 pt。
// 自定义完整直播间中的浮窗。 livePullVC.config.customFloatingController = ^(BDLLivePullViewController * _Nonnull viewController, BDLFloatingController * _Nonnull floatingController) { // 自定义互动工具浮窗的默认位置。该 View 涉及拖动,因此通过设置 view.frame 调整其位置,而非使用自动布局。 floatingController.customizeInteractiveToolContainerView = ^__kindof UIStackView * _Nullable(BDLFloatingController * _Nonnull floatingController, UIStackView * _Nonnull view) { CGRect frame = view.frame; // 互动工具浮窗的默认位置下移 50 pt。 frame.origin.y += 50; view.frame = frame; return view; }; };
商品卡片菜单的默认高度为 600 pt。您可以自定义菜单的高度。
以下示例代码将商品卡片菜单的高度设置为屏幕高度的 1/2。
// 请与其他 customizeMenuBarView 方法合并使用,以免互相覆盖配置。 livePullVC.config.customizeMenuBarView = ^(BDLLivePullViewController * _Nonnull viewController, BDLMenuBarView * _Nonnull view) { if (view.filterOption & BDLMenuFilterOptionCard) { [view mas_updateConstraints:^(MASConstraintMaker *make) { make.height.mas_equalTo(CGRectGetHeight(UIScreen.mainScreen.bounds) * 1 / 2); }]; } };