diff --git a/docs/comment/readme.md b/docs/comment/readme.md index 687fe24..09f0b62 100644 --- a/docs/comment/readme.md +++ b/docs/comment/readme.md @@ -70,7 +70,7 @@ | folder | obj | 折叠信息 | | | up_action | obj | 评论 UP 主操作信息 | | | show_follow | bool | (?) | | -| invisible | bool | | | +| invisible | bool | 评论是否被隐藏 | | | card_label | obj | 右上角卡片标签信息 | | | reply_control | obj | 评论提示文案信息 | | @@ -334,3 +334,4 @@ | sub_reply_entry_text | str | 回复提示 | `共 xx 条回复` | | sub_reply_title_text | str | 回复提示 | `相关回复共有 xx 条` | | time_desc | str | 时间提示 | `xx 天/小时 前发布` | +| location | str | IP属地 | `IP属地:xx`
评论者发送评论时的IP地址属地
仅对2022-07-25 11:00及以后发布的评论有效
需要登录| diff --git a/docs/live/message_stream.md b/docs/live/message_stream.md index 9a29817..6ed7487 100644 --- a/docs/live/message_stream.md +++ b/docs/live/message_stream.md @@ -527,6 +527,210 @@ data字段 +#### 上舰通知 + +json格式 + +| 字段 | 类型 | 内容 | 备注 | +| ---- | ---- |------------------|----------------------------------| +| cmd | str | "GUARD_BUY" | 用户购买舰长 / 提督 / 总督,内容则是"GUARD_BUY" | +| data | obj | 上舰人uid & 昵称、上舰信息 | | + +data字段 + +| 字段 | 类型 | 内容 | 备注 | +| ---- |-----|--------------------------|-----| +| uid | num | 用户ID | | +| username | str | 用户名称 | | +| guard_level | num | 大航海等级 | 1: 总督 2: 提督 3:舰长 | +| num | num | 数量 | | +| price | num | 待调查 | | +| gift_id | num | 礼物id | | +| gift_name | str | 礼物名称 | | +| start_time | num | 待调查 | | +| end_time | num | 待调查 | | + +
+ +查看消息示例: + +```json +{ + "cmd": "GUARD_BUY", + "data": { + "uid": 14225357, + "username": "妙妙喵喵妙妙喵O_O", + "guard_level": 3, + "num": 1, + "price": 198000, + "gift_id": 10003, + "gift_name": "舰长", + "start_time": 1677069316, + "end_time": 1677069316 + } +} +``` + +
+ +#### 醒目留言 + +json格式 + +| 字段 | 类型 | 内容 | 备注 | +| ---- |-----|---------------------|-----------------------------------| +| cmd | str | "SUPER_CHAT_MESSAGE" | 用户发送醒目留言,内容则是"SUPER_CHAT_MESSAGE" | +| data | obj | 醒目留言内容、发送者信息等 | | +| roomid | num | 直播间房间号(非短号 | | + +data字段 + +| 字段 | 类型 | 内容 | 备注 | +| ---- |-----|----------------| --------- | +| background_bottom_color | str | 待调查 | | +| background_color | str | 待调查 | | +| background_color_end | str | 待调查 | | +| background_color_start | str | 待调查 | | +| background_icon | str | 待调查 | | +| background_image | str | 待调查 | | +| background_price_color | str | 待调查 | | +| color_point | num | 待调查 | | +| dmscore | num | 待调查 | | +| end_time | num | 待调查 | | +| gift | obj | 礼物信息 | | +| id | num | 待调查 | | +| is_ranked | num | 待调查 | | +| is_send_audit | num | 待调查 | | +| medal_info | obj | SC发送用户佩戴的粉丝牌信息 | | +| message | str | sc内容 | | +| message_font_color | str | SC文本颜色 | | +| message_trans | str | 待调查 | | +| price | num | sc金额 | | +| rate | num | 待调查 | | +| start_time | num | 待调查 | | +| time | num | sc持续时间 | | +| token | num | 待调查 | | +| trans_mark | num | 待调查 | | +| ts | num | 待调查 | | +| uid | num | 发送用户uid | | +| user_info | obj | 发送用户信息 | | + +gift字段 + +| 字段 | 类型 | 内容 | 备注 | +| ---- |-----|------|------| +| gift_id | num | 礼物id | | +| gift_name | str | 礼物名称 | 一般均为"醒目留言" | +| num | num | 数量 | | + +medal_info字段 + +| 字段 | 类型 | 内容 | 备注 | +| ---- |-----|-------------|------| +| anchor_roomid | num | 房间号 | 包含短号 | +| anchor_uname | str | 主播昵称 | | +| guard_level | num | 大航海等级 | 1: 总督 2: 提督 3:舰长 | +| icon_id | num | 待调查 | | +| is_lighted | num | 待调查 | | +| medal_color | str | 待调查 | | +| medal_color_border | num | 待调查 | | +| medal_color_end | num | 待调查 | | +| medal_color_start | num | 待调查 | | +| medal_level | num | 粉丝牌等级 | | +| medal_name | str | 粉丝牌名称 | | +| special | str | 待调查 | | +| target_id | num | 粉丝牌对应的主播uid | | + +user_info字段 + +| 字段 | 类型 | 内容 | 备注 | +| ---- |-----|-------|------| +| face | num | 用户头像 | | +| face_frame | num | 头像边框 | | +| guard_level | num | 大航海等级 | 1: 总督 2: 提督 3:舰长 | +| is_main_vip | num | 待调查 | | +| is_svip | num | 待调查 | | +| is_vip | num | 待调查 | | +| level_color | str | 待调查 | | +| manager | num | 待调查 | | +| name_color | str | 待调查 | | +| title | str | 待调查 | | +| uname | str | 用户名称 | | +| user_level | num | 待调查 | | + +
+ +查看消息示例: + +```json +{ + "cmd": "SUPER_CHAT_MESSAGE", + "data": { + "background_bottom_color": "#2A60B2", + "background_color": "#EDF5FF", + "background_color_end": "#405D85", + "background_color_start": "#3171D2", + "background_icon": "", + "background_image": "https://i0.hdslb.com/bfs/live/a712efa5c6ebc67bafbe8352d3e74b820a00c13e.png", + "background_price_color": "#7497CD", + "color_point": 0.7, + "dmscore": 120, + "end_time": 1677069095, + "gift": { + "gift_id": 12000, + "gift_name": "醒目留言", + "num": 1 + }, + "id": 6522809, + "is_ranked": 1, + "is_send_audit": 0, + "medal_info": { + "anchor_roomid": 732, + "anchor_uname": "Asaki大人", + "guard_level": 3, + "icon_id": 0, + "is_lighted": 1, + "medal_color": "#1a544b", + "medal_color_border": 6809855, + "medal_color_end": 5414290, + "medal_color_start": 1725515, + "medal_level": 21, + "medal_name": "ASAKI", + "special": "", + "target_id": 194484313 + }, + "message": "猪播完美预测自己第一个死,这就是鹅鸭杀高玩吗", + "message_font_color": "#A3F6FF", + "message_trans": "", + "price": 30, + "rate": 1000, + "start_time": 1677069035, + "time": 60, + "token": "7BED5681", + "trans_mark": 0, + "ts": 1677069035, + "uid": 294094150, + "user_info": { + "face": "https://i1.hdslb.com/bfs/face/7a11b48e0a3055e220fa8b4c7d938cd4bcac2577.jpg", + "face_frame": "https://i0.hdslb.com/bfs/live/80f732943cc3367029df65e267960d56736a82ee.png", + "guard_level": 3, + "is_main_vip": 1, + "is_svip": 0, + "is_vip": 0, + "level_color": "#969696", + "manager": 0, + "name_color": "#00D1F1", + "title": "0", + "uname": "界原虚", + "user_level": 6 + } + }, + "roomid": 6154037 +} +``` + +
+ #### 送礼 json格式 diff --git a/docs/manga/light_card.md b/docs/manga/light_card.md index 4b3c290..405daa4 100644 --- a/docs/manga/light_card.md +++ b/docs/manga/light_card.md @@ -152,20 +152,20 @@ Content-Type:`application/json` **正文参数( application/json ):** -| 参数名 | 类型 | 必填 | 内容 | 备注 | -|-----------|-----|----|-----|--------| -| weekIndex | num | √ | 第几周 | 从`1`开始 | -| type | num | √ | 第几天 | 从`1`开始 | +| 参数名 | 类型 | 必填 | 内容 | 备注 | +|-----------|-----|----|------|----------------------| +| weekIndex | num | √ | 第几周 | 从`1`开始 | +| type | num | √ | 领取类型 | 1:领取漫读券
2:领取限免卡 | **json回复:** 根对象: -| 字段名 | 类型 | 内容 | 备注 | -|------|-----|-----|----------------------------------------------------| -| code | num | 响应码 | 0:成功
3:今日已领取,请明日再来
3:还未满足领取条件
4:找不到数据~ | -| msg | str | | | -| data | obj | | | +| 字段名 | 类型 | 内容 | 备注 | +|------|-----|-----|-------------------------------------------------------------------| +| code | num | 响应码 | 0:成功
3:今日已领取,请明日再来
3:还未满足领取条件
4:找不到数据~
6:你点击太快了哦~ | +| msg | str | | | +| data | obj | | | **示例:** diff --git a/grpc_api/bilibili/app/archive/middleware/v1/preload.proto b/grpc_api/bilibili/app/archive/middleware/v1/preload.proto index 8abfaba..e7746e6 100644 --- a/grpc_api/bilibili/app/archive/middleware/v1/preload.proto +++ b/grpc_api/bilibili/app/archive/middleware/v1/preload.proto @@ -13,6 +13,6 @@ message PlayerArgs { // 返回url是否强制使用域名 // 0:不强制使用域名 1:http域名 2:https域名 int64 force_host = 4; - // + // 音量均衡 int64 voice_balance = 5; } \ No newline at end of file diff --git a/grpc_api/bilibili/app/dynamic/v2/dynamic.proto b/grpc_api/bilibili/app/dynamic/v2/dynamic.proto index a4ef1ce..2cb1474 100644 --- a/grpc_api/bilibili/app/dynamic/v2/dynamic.proto +++ b/grpc_api/bilibili/app/dynamic/v2/dynamic.proto @@ -41,6 +41,8 @@ service Dynamic { rpc LikeList(LikeListReq) returns (LikeListReply); // 转发列表 rpc RepostList(RepostListReq) returns (RepostListRsp); + // 新版动态转发点赞列表 需要登录 + rpc ReactionList(ReactionListReq) returns (ReactionListReply); // 空间页动态 rpc DynSpace(DynSpaceReq) returns (DynSpaceRsp); // 未登录页分区UP主推荐 @@ -3494,6 +3496,42 @@ message RepostListRsp { RepostType repost_type = 5; } +// 新版动态转发点赞列表-请求 +message ReactionListReq { + // 动态ID + int64 dynamic_id = 1; + // 动态类型 + int64 dyn_type = 2; + // 业务方资源id + int64 rid = 3; + // 偏移,使用上一页回包中的offset字段;第一页不传。 + string offset = 4; +} + +// 新版动态转发点赞列表-响应 +message ReactionListReply { + // 标题 + string title = 1; + // 列表 + repeated ReactionListItem list = 2; + // 偏移 + string offset = 3; + // 是否还有更多 + bool has_more = 4; +} + +message ReactionListItem { + // 用户信息 + UserInfo user = 1; + // 关注关系 + Relation relation = 2; + // 显示文字 + string act_text = 3; + // + string rcmd_reason = 4; + // bool has_relation = 5; + // bool has_user = 6; +} // 评论类型 enum RepostType { repost_hot = 0; // 热门评论 diff --git a/grpc_api/bilibili/metadata/device/device.proto b/grpc_api/bilibili/metadata/device/device.proto index c56376b..7108a91 100644 --- a/grpc_api/bilibili/metadata/device/device.proto +++ b/grpc_api/bilibili/metadata/device/device.proto @@ -6,8 +6,8 @@ package bilibili.metadata.device; // gRPC头部:x-bili-device-bin message Device { // 产品id - // 粉 白 蓝 直播姬 HD 海外 OTT 漫画 TV野版 小视频 网易漫画 网易漫画 网易漫画HD 国际版 - // 1 2 3 4 5 6 7 8 9 10 11 12 13 14 + // 粉 白 蓝 直播姬 HD 海外 OTT 漫画 TV野版 小视频 网易漫画 网易漫画 网易漫画HD 国际版 东南亚版 + // 1 2 3 4 5 6 7 8 9 10 11 12 13 14 30 int32 app_id = 1; // 构建id int32 build = 2; @@ -36,6 +36,6 @@ message Device { string version_name = 13; // 设备指纹, 不区分本地或远程设备指纹,作为推送目标的索引 string fp = 14; - // + // 首次启动时的毫秒时间戳 int64 fts = 15; } diff --git a/grpc_api/bilibili/metadata/metadata.proto b/grpc_api/bilibili/metadata/metadata.proto index dda7bcd..9af2607 100644 --- a/grpc_api/bilibili/metadata/metadata.proto +++ b/grpc_api/bilibili/metadata/metadata.proto @@ -13,7 +13,7 @@ message Metadata { string device = 3; // 构建id int32 build = 4; - // 渠道 + // APP分发渠道 string channel = 5; // 设备buvid string buvid = 6; diff --git a/grpc_api/bilibili/metadata/restriction/restriction.proto b/grpc_api/bilibili/metadata/restriction/restriction.proto index 5aef6eb..67dca6a 100644 --- a/grpc_api/bilibili/metadata/restriction/restriction.proto +++ b/grpc_api/bilibili/metadata/restriction/restriction.proto @@ -19,6 +19,6 @@ message Restriction { ModeType mode = 3; // app 审核review状态 bool review = 4; - // + // 客户端是否选择关闭个性化推荐 bool disable_rcmd = 5; } diff --git a/grpc_api/bilibili/pagination/pagination.proto b/grpc_api/bilibili/pagination/pagination.proto index b229841..377981d 100644 --- a/grpc_api/bilibili/pagination/pagination.proto +++ b/grpc_api/bilibili/pagination/pagination.proto @@ -2,7 +2,7 @@ syntax = "proto3"; package bilibili.pagination; -// +// 分页信息 message FeedPagination { // int32 page_size = 1; @@ -12,7 +12,7 @@ message FeedPagination { bool is_refresh = 3; } -// +// 分页信息 message FeedPaginationReply { // string next_offset = 1; @@ -22,7 +22,7 @@ message FeedPaginationReply { string last_read_offset = 3; } -// +// 分页信息 message Pagination { // int32 page_size = 1; @@ -30,7 +30,7 @@ message Pagination { string next = 2; } -// +// 分页信息 message PaginationReply { // string next = 1; diff --git a/grpc_api/bilibili/pgc/gateway/player/v2/playurl.proto b/grpc_api/bilibili/pgc/gateway/player/v2/playurl.proto index 0b2d9fa..6a1d1e4 100644 --- a/grpc_api/bilibili/pgc/gateway/player/v2/playurl.proto +++ b/grpc_api/bilibili/pgc/gateway/player/v2/playurl.proto @@ -22,15 +22,15 @@ message BadgeInfo { string bg_color_night = 3; // 文案色值 string text_color = 4; - // + // ? 新版本客户端已弃用此项 GradientColor bg_gradient_color = 5; } -// +// Dialog组件: 底部显示 message BottomDisplay { - // + // 文案 TextInfo title = 1; - // + // 图标 string icon = 2; } @@ -68,34 +68,35 @@ message ButtonInfo { map order_report_params = 15; } -// +// 投屏限制. code = 0 时为无限制, 否则表示不不允许投屏并提示message message CastTips { // int32 code = 1; - // + // string message = 2; } -// +// 跳过片头/片尾配置 message ClipInfo { // int64 material_no = 1; - // + // DASH分段始 int32 start = 2; - // + // DASH分段终 int32 end = 3; - // + // Clip类型 ClipType clip_type = 4; - // + // 跳过片头/片尾时的提示语 string toast_text = 5; - // + // MultiView multi_view = 6; } +// 跳过片头/片尾配置: Clip类型 enum ClipType { NT_UNKNOWN = 0; // - CLIP_TYPE_OP = 1; // - CLIP_TYPE_ED = 2; // + CLIP_TYPE_OP = 1; // 跳过OP + CLIP_TYPE_ED = 2; // 跳过ED CLIP_TYPE_HE = 3; // CLIP_TYPE_MULTI_VIEW = 4; // } @@ -176,7 +177,7 @@ message DashItem { uint32 codecid = 5; // md5 string md5 = 6; - // 大小 + // 视频大小 uint64 size = 7; // 帧率 string frame_rate = 8; @@ -252,13 +253,13 @@ message DialogConfig { bool is_force_halfscreen_enable = 4; } -// +// 当前分辨率信息 message Dimension { - // + // 宽 int32 width = 1; - // + // 长 int32 height = 2; - // + // 旋转角度 int32 rotate = 3; } @@ -276,7 +277,7 @@ message DolbyItem { DashItem audio = 2; } -// +// DRM技术类型 enum DrmTechType { NON = 0; // FAIR_PLAY = 1; // @@ -296,7 +297,7 @@ message Event { Shake shake = 1; } -// +// ? 放映室提示语 message FreyaConfig { // string desc = 1; @@ -312,7 +313,7 @@ message FreyaConfig { int32 full_screen_number = 6; } -// +// 渐变色信息 message GradientColor { // string start_color = 1; @@ -320,7 +321,7 @@ message GradientColor { string end_color = 2; } -// +// 高画质试看信息 message HighDefinitionTrialInfo { // bool trial_able = 1; @@ -376,7 +377,7 @@ message MultiView { int64 avid = 4; } -// +// 大会员广告: 支付提示信息 message PayTip { // string title = 1; @@ -482,19 +483,19 @@ message PlayViewBusinessInfo { string playback_speed_color = 4; // ContinuePlayInfo continue_play_info = 5; - // + // 跳过片头/片尾配置 repeated ClipInfo clip_info = 6; // InlineType inline_type = 7; // int32 ep_whole_duration = 8; - // + // 当前分辨率信息 Dimension dimension = 9; // map quality_ext_map = 10; // map exp_map = 11; - // + // DRM技术类型 DrmTechType drm_tech_type = 12; } @@ -578,21 +579,21 @@ message PopWin { string pop_type = 9; } -// +// 广告组件: 竖屏时视频下部提示栏 message PromptBar { - // + // 主标题, 如: "本片含大会员专享内容" TextInfo title = 1; - // + // 副标题, 如: "成为大会员可免费看全部剧集" TextInfo sub_title = 2; - // + // 副标题前面的icon string sub_title_icon = 3; - // + // 背景图 string bg_image = 4; - // + // 背景渐变色 GradientColor bg_gradient_color = 5; - // + // 按钮 repeated ButtonInfo button = 6; - // + // 埋点上报信息 Report report = 7; // string full_screen_ip_icon = 8; @@ -600,9 +601,9 @@ message PromptBar { GradientColor full_screen_bg_gradient_color = 9; } -// +// 云控拓展视频画质信息 message QualityExtInfo { - // + // 是否支持试看 bool trial_support = 1; } diff --git a/grpc_api/bilibili/polymer/app/search/v1/search.proto b/grpc_api/bilibili/polymer/app/search/v1/search.proto index 37a0bd0..f532f49 100644 --- a/grpc_api/bilibili/polymer/app/search/v1/search.proto +++ b/grpc_api/bilibili/polymer/app/search/v1/search.proto @@ -7,9 +7,9 @@ import "bilibili/pagination/pagination.proto"; // service Search { - // + // 搜索所有类型结果 rpc SearchAll(SearchAllRequest) returns (SearchAllResponse); - // + // 搜索指定类型结果 rpc SearchByType(SearchByTypeRequest) returns (SearchByTypeResponse); // rpc SearchComic(SearchComicRequest) returns (SearchComicResponse); @@ -1098,9 +1098,9 @@ message SearchBannerCard { // message SearchByTypeRequest { - // + // 搜索目标类型, 番剧为7 int32 type = 1; - // + // 关键词 string keyword = 2; // int32 category_sort = 3; @@ -1118,21 +1118,21 @@ message SearchByTypeRequest { // message SearchByTypeResponse { - // + // 追踪id string trackid = 1; - // + // 当前页码 int32 pages = 2; // string exp_str = 3; - // + // 搜索关键词 string keyword = 4; - // + // 是否为推荐结果 int32 result_is_recommend = 5; - // + // 搜索结果条目 repeated Item items = 6; - // + // 分页信息 bilibili.pagination.PaginationReply pagination = 7; - // + // map annotation = 8; }