互动功能
本文档主要提供互动功能 SDK 单一实例获取 Api 说明。
一、安装互动接收端 SDK
观看页 SDK 默认不会加载互动功能接收端 SDK,如需使用互动功能,请在 watchCore.setup() 之后调用该方法加载互动功能接收端 SDK。
Api 方法: setupIarCore(): Promise<void>
示例:
// 安装观看页 SDK
await watchCore.setup();
// 加载互动功能
await watchCore.interactReceive.setupIarCore();
// 加载后即可获取互动功能单一实例
二、获取互动设置信息
用于获取管理后台设置的互动功能信息。
Api 方法: getInteractSetting(): InteractSetting
返回值说明: 互动功能设置信息,InteractSetting 类型,详细类型说明如下
| 属性名 | 说明 | 类型 |
|---|---|---|
recruitmentEnabled |
招聘直播开关 | boolean |
productEnabled |
商品库开关 | boolean |
liveProductEnabled |
商品库超管总开关 | boolean |
productTrackEnabled |
商品库数据上报开关 | boolean |
productLinkJumpTipEnabled |
商品库链接跳转提示开关 | boolean |
outLinkProductRedirectEnabled |
商品直接跳转外链开关 | boolean |
productEntryPosition |
商品入口位置 | ProductEntryPosition |
enrollLotteryEnabled |
报名抽奖开关 | boolean |
lotteryManualEndEnabled |
抽奖手动结束开关 | boolean |
conditionLotteryEnabled |
条件抽奖开关 | boolean |
conditionLotteryAutoPopperEnabled |
条件抽奖是否自动弹窗开关 | boolean |
lotteryVersion |
抽奖版本 | 'v1' | 'v2' |
watchFeedbackEnabled |
投诉反馈开关 | boolean |
watchFeedbackButtonPositions |
投诉反馈按钮位置 | string[] |
voteActiveEnabled |
投票活动开关 | boolean |
redpackEnabled |
互动红包开关 | boolean |
redpackImage |
红包背景图 | string |
redpackRainBottomImage |
红包雨底部背景图 | string |
redpackRainImages |
红包雨下落物图片 | string[] |
seatTableEnabled |
云席功能开关 | boolean |
seatTableTemplate |
云席模板 | SeatTableTemplate |
seatMaxNumber |
嘉宾普通云席最大数量 | number |
seatVipMaxNumber |
嘉宾 vip 云席最大数量 | number |
seatCustomTextEnabled |
云席自定义文案开关 | boolean |
seatCustomText |
云席自定义文案 | string |
seatGuestCardEnabled |
云席嘉宾证开关 | boolean |
lotteryGiftButtonTextCH |
抽奖按钮中文文案 | string |
lotteryGiftButtonTextEN |
抽奖按钮英文文案 | string |
productHotEffectEnabled |
是否显示热卖特效 | boolean |
productHotEffectTips |
热卖词数据 | ProductHotEffectTips |
couponEnabled |
优惠券开关 | boolean |
personalRewardEnabled |
我的奖励开关 | boolean |
示例:
const settingInfo = watchCore.interactReceive.getInteractSetting();
console.log('商品库开关', settingInfo.productEnabled);
三、获取公告 SDK 单一实例
Api 方法: getAnnouncement(): Announcement
返回值说明: 公告 SDK 单一实例,Announcement 类型
四、获取签到 SDK 单一实例
Api 方法: getCheckIn(): CheckIn
返回值说明: 签到 SDK 单一实例,CheckIn 类型
五、获取答题卡 SDK 单一实例
Api 方法: getAnswerCard(): AnswerCard
返回值说明: 答题卡 SDK 单一实例,AnswerCard 类型
六、获取问卷 SDK 单一实例
Api 方法: getQuestionnaire(): Questionnaire
返回值说明: 问卷 SDK 单一实例,Questionnaire 类型
七、获取问答 SDK 单一实例
Api 方法: getQuestionAnswer(): QuestionAnswer
返回值说明: 问答 SDK 单一实例,QuestionAnswer 类型
八、获取卡片推送 SDK 单一实例
Api 方法: getPushCard(): PushCard
返回值说明: 卡片推送 SDK 单一实例,PushCard 类型
九、获取抽奖 SDK 单一实例
Api 方法: getLottery(): Lottery
返回值说明: 抽奖 SDK 单一实例,Lottery 类型
十、获取条件抽奖 SDK 单一实例
Api 方法: getWelfareLottery(): WelfareLottery
返回值说明: 条件抽奖 SDK 单一实例,WelfareLottery 类型
十一、获取报名抽奖 SDK 单一实例
Api 方法: getEnrollLottery(): EnrollLottery
返回值说明: 报名抽奖 SDK 单一实例,EnrollLottery 类型
十二、获取红包 SDK 单一实例
红包功能开发文档: 红包组件
Api 方法: getRedpack(): RedEnvelope
返回值说明: 红包 SDK 单一实例,RedEnvelope 类型
十三、获取红包雨 SDK 单一实例
目前红包雨和红包共用一份 文档
Api 方法: getRedpackRain(): RedpackRain
返回值说明: 红包雨 SDK 单一实例,RedpackRain 类型
十四、获取投票 SDK 单一实例
暂无相关文档,后续补充...
Api 方法: getVote(): Vote
返回值说明: 投票 SDK 单一实例,Vote 类型
十五、获取反馈 SDK 单一实例
暂无相关文档,后续补充...
Api 方法: getFeedBack(): FeedBack
返回值说明: 反馈 SDK 单一实例,FeedBack 类型
十六、获取商品库 SDK 单一实例
Api 方法: getProduct(): Product
返回值说明: 商品库 SDK 单一实例,Product 类型
十七、商品库回放
Api 方法: processProductReplay(params: Object): void
从 v0.9.0 版本开始支持
参数说明:
- params:
Object类型,必传,详细类型说明如下
| 参数名 | 说明 | 类型 | 必须 | 默认值 |
|---|---|---|---|---|
currentTime |
当前播放时间,单位:秒 | number |
是 | - |
durationTime |
播放总时长,单位:秒 | number |
是 | - |
十八、获取图文直播 SDK 单一实例
Api 方法: getTuwen(): Tuwen
返回值说明: 图文直播 SDK 单一实例,Tuwen 类型
十九、获取云席 SDK 单一实例
Api 方法: getSeatTable(): SeatTable
返回值说明: 云席 SDK 单一实例,SeatTable 类型
二十、设置云席信息
Api 方法: setupSeatTable(): Promise<void>
从 v0.10.0 版本开始支持
二十一、获取话题PK SDK 单一实例
Api 方法: getTopicPK(): Topic
返回值说明: 话题PK SDK 单一实例,Topic 类型
二十二、获取抢答 SDK 单一实例
Api 方法: getRushAnswer(): RushAnswer
返回值说明: 抢答 SDK 单一实例,RushAnswer 类型
二十三、获取商品库按钮点击提示模板配置
Api 方法: getProductLinkJumpTipDetail(): undefined | ProductLinkJumpTipDetail
从 v1.3.0 版本开始支持
返回值说明: 商品库按钮点击提示模板,undefined | ProductLinkJumpTipDetail 类型
二十四、地址管理 SDK 单一实例
Api 方法: getAddressManagement(): AddressManagement
从 v1.5.0 版本开始支持
返回值说明: 地址管理 SDK 单一实例,AddressManagement 类型
二十五、订单 SDK 单一实例
Api 方法: getOrder(): Order
从 v1.5.0 版本开始支持
返回值说明: 订单管理 SDK 单一实例,Order 类型
二十六、获取抽奖隐私协议的数据
Api 方法: getLotteryPrivacyDetail(): LotteryPrivacyDetail
从 v1.4.0 版本开始支持
返回值说明: LotteryPrivacyDetail 类型,详细类型说明如下
| 属性名 | 说明 | 类型 |
|---|---|---|
privacyContent |
抽奖隐私协议内容 | undefined | string |
lotteryActivityPrivacyEnabled |
抽奖活动隐私协议开关 | YN |
二十七、解析商品详情
Api 方法: parseProductDetail(productGoodData: ProductGoodData): Promise<ParseProductDetail>
从 v1.11.0 版本开始支持
从 v2.6.0 版本开始废弃
参数说明:
- productGoodData:
ProductGoodData类型,必传,详细类型说明如下
| 参数名 | 说明 | 类型 | 必须 | 默认值 |
|---|---|---|---|---|
name |
商品名称 | string |
是 | - |
productId |
商品 id | string |
是 | - |
realPrice |
商品原价 | string |
是 | - |
customPrice |
自定义价格 | string |
是 | - |
priceType |
价格类型 | string |
是 | - |
price |
商品价格 | string |
是 | - |
productType |
商品类型 | IarProductType |
是 | - |
productDesc |
商品提示 | string |
是 | - |
logId |
推送Id | string |
否 | - |
buyType |
购买方式 | string |
否 | - |
deliveryType |
履约方式 | string |
否 | - |
productPushRule |
推送规则 | string |
否 | - |
features |
特色标签 | string[] |
否 | - |
productDetail |
商品详情 | string |
否 | - |
cover |
封面图 | string |
是 | - |
coverList |
封面图列表 | string[] |
是 | - |
openPriceEnable |
是否开价 | string |
否 | - |
ext |
扩展信息 | string |
否 | - |
返回值说明: Promise<ParseProductDetail> 类型,详细类型说明如下
| 属性名 | 说明 | 类型 |
|---|---|---|
name |
商品名称 | string |
productId |
商品 id | string |
realPrice |
商品原价 | string |
customPrice |
自定义价格 | string |
priceType |
价格类型 | string |
price |
商品价格 | string |
productType |
商品类型 | IarProductType |
productDesc |
商品提示 | string |
logId |
推送Id | string |
buyType |
购买方式 | string |
deliveryType |
履约方式 | string |
productPushRule |
推送规则 | string |
features |
特色标签 | string[] |
productDetail |
商品详情 | string |
cover |
封面图 | string |
coverList |
封面图列表 | string[] |
ext |
扩展信息 | string |
materialId |
- | string |
openPriceEnable |
是否开价 | string |
二十八、获取投票设置
Api 方法: getVoteSetting(): null | InteractionVoteSetting
返回值说明: 投票设置,如果不存在则返回 null,null | InteractionVoteSetting 类型
Api 方法: getIarCoreV2(check?: false): undefined | InteractionCore
参数说明:
- check:
false类型,选传
返回值说明: undefined | InteractionCore 类型
二十九、获取答题卡 SDK 单一实例(V2)
Api 方法: getAnswerCardV2(): Promise<AnswerCard>
返回值说明: Promise<AnswerCard> 类型
三十、获取问卷 SDK 单一实例(V2)
Api 方法: getQuestionnaireV2(): Promise<Questionnaire>
返回值说明: Promise<Questionnaire> 类型
三十一、获取签到 SDK 单一实例(V2)
Api 方法: getCheckInV2(): Promise<CheckIn>
返回值说明: Promise<CheckIn> 类型
三十二、获取抽奖 SDK 单一实例(V2)
Api 方法: getLotteryV2(): Promise<Lottery>
返回值说明: Promise<Lottery> 类型
三十三、获取优惠券 SDK 单一实例(V2)
Api 方法: getCouponV2(): Promise<Coupon>
返回值说明: Promise<Coupon> 类型
三十四、获取平台抽奖 SDK 单一实例
Api 方法: getLuckyLotteryV2(): Promise<LuckyLottery>
返回值说明: Promise<LuckyLottery> 类型
三十五、获取福袋 SDK 单一实例(V2)
Api 方法: getLuckyBagV2(): Promise<LuckyBag>
返回值说明: Promise<LuckyBag> 类型
三十六、获取投票 SDK 单一实例(V2)
Api 方法: getVoteV2(): Promise<Vote>
返回值说明: Promise<Vote> 类型
三十七、获取公告 SDK 单一实例(V2)
Api 方法: getBulletinV2(): Promise<Bulletin>
返回值说明: Promise<Bulletin> 类型
