模板: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}} | ||