模板:BilibiliCount/doc
跳至導覽
跳至搜尋
本模板用以獲取指定B站視頻數據。
伺服器端配置
| 配置項 | Bilibili相關 | Niconico相關 | Youtube相關 | |||
|---|---|---|---|---|---|---|
| 視頻接口 | UP接口 | 視頻接口 | 視頻接口 | 頻道接口 | ||
| 緩存時長 | ||||||
| 緩存更新 最大頻率控制 |
低頻時段 | |||||
| 低頻時段頻率 | ||||||
| 高頻時段頻率 | ||||||
| 代理節點個數 | ||||||
註：
- 緩存更新最大頻率是指連續60秒內伺服器或代理節點進行緩存刷新的最大次數，超出最大次數之後的請求將會延長緩存有效期至解除頻率控制時間點，並會在每日的低頻時段被伺服器重試，直至完成緩存刷新。
- 建議通過搭配onlyTime參數來向讀者提示緩存時間，如有需要強制刷新請聯繫AnnAngela[更多]。
統計數據
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
參數說明
- id：必填，填寫需要獲取的視頻的av/bv號（不建議省略開頭的av或bv）
- 如果id為【av+一到九位純數字】或【一到九位純數字】則按av號處理；
- 如果id為【bv+十位數字或字母】或【十位數字或字母】則按bv號處理；
- 如果以上兩項id均不符合則報錯。
- type：選填，填寫需要獲取的信息類型：
- 1 / view（默認值）：視頻播放數；
- 2 / danmaku：視頻彈幕數；
- 3 / reply：視頻評論數；
- 4 / favorite：視頻收藏數；
- 5 / coin：視頻硬幣數；
- 6 / share：視頻分享次數；
- 7 / his_rank：視頻歷史最高全站日排行；
- 8 / like：視頻推薦數；
- 10 / title：視頻標題。
- noTime：選填，默認為不顯示信息獲得的時間，值為
false/no/0時顯示獲得的時間 - onlyTime：選填，默認為否，值不為空時僅顯示獲得的時間
- color：選填，改變字體顏色
- format：選填，指定輸出的數據的格式，只能填以下三種參數：
round/toFixed（默認值）：- 數據小於10000時顯示原始數據；
- 大於10000時以「萬」為單位顯示：
- 此時四捨五入保留的小數位數以
{{{decimalLength|}}}指定，只接受正整數，默認為2；
- 此時四捨五入保留的小數位數以
plain：直接顯示原始數據separate：顯示帶千位分隔符的數據
- dateFormat：選填，直接傳遞給moment庫，所以請使用moment庫可用的格式，默認值為
LLL（2020年1月2日晚上4點50分，在只顯示時間時）
註：B站現已不返回dislike（差評）數量【請求後只會返回「0」】，於是停用相關參數。
輸出
- 在無法獲得數據（例如該視頻在第一次請求數據前即被刪除、該視頻av號不存在或者設置的信息類型錯誤）的時候會顯示相關錯誤信息；
- 否則以原數值顯示。
舉例
| 參數舉例 | 1 / view | 2 / danmaku | 3 / reply |
|---|---|---|---|
| 結果舉例 | -- | -- | -- |
| 用法舉例 | {{BilibiliCount|id=av723092041}} {{BilibiliCount|id=av723092041|type=view}} |
{{BilibiliCount|id=av723092041|type=2}} {{BilibiliCount|id=av723092041|type=danmaku}} |
{{BilibiliCount|id=av723092041|type=3}} {{BilibiliCount|id=av723092041|type=reply}} |
| 參數舉例 | 4 / favorite | 5 / coin | 6 / share |
| 結果舉例 | -- | -- | -- |
| 用法舉例 | {{BilibiliCount|id=av723092041|type=4}} {{BilibiliCount|id=av723092041|type=favorite}} |
{{BilibiliCount|id=av723092041|type=5}} {{BilibiliCount|id=av723092041|type=coin}} |
{{BilibiliCount|id=av723092041|type=6}} {{BilibiliCount|id=av723092041|type=share}} |
| 參數舉例 | 7 / his_rank | 8 / like | 10 / title |
| 結果舉例 | -- | -- | -- |
| 用法舉例 | {{BilibiliCount|id=av723092041|type=7}} {{BilibiliCount|id=av723092041|type=his_rank}} |
{{BilibiliCount|id=av723092041|type=8}} {{BilibiliCount|id=av723092041|type=like}} |
{{BilibiliCount|id=av723092041|type=10}} {{BilibiliCount|id=av723092041|type=title}} |
| 參數舉例 | noTime | onlyTime | color |
| 結果舉例 | -- | -- | -- |
| 用法舉例 | {{BilibiliCount|id=av723092041|type=6|noTime=0}} | {{BilibiliCount|id=av723092041|type=7|onlyTime=1}} | {{BilibiliCount|id=av723092041|type=8|color=red}} |
| 參數舉例 | round / toFixed | plain | separate |
| 結果舉例 | -- | -- | -- |
| 用法舉例 | {{BilibiliCount|id=av723092041|format=toFixed}} | {{{BilibiliCount|id=av723092041|format=plain}} | {{BilibiliCount|id=av723092041|format=separate}} |
| 參數舉例 | decimalLength | dateFormat | 類型設置錯誤 |
| 結果舉例 | -- | -- | -- |
| 用法舉例 | {{BilibiliCount|id=av723092041|format=toFixed|decimalLength=4}} | {{BilibiliCount|id=av723092041|onlyTime=1|dateFormat=LLLL}} | {{BilibiliCount|id=av723092041|type=0}} {{BilibiliCount|id=av723092041|type=error}} |
| 參數舉例 | ID為bv號時 | 示例用視頻為《這是萌娘百科嶄新的開始喲~》（av號）、《【萌娘百科】綠壩綠壩☆河蟹你全家》（bv號） | |
| 結果舉例 | -- | ||
| 用法舉例 | {{BilibiliCount|id=BV1jr4y1s7Ne}} | ||