互動功能
本文檔主要提供互動功能 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 |
