Merge branch 'SocialSisterYi:master' into patch-1

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`<br />评论者发送评论时的IP地址属地<br />仅对2022-07-25 11:00及以后发布的评论有效<br />需要登录|

docs/live/message_stream.md

@@ -527,6 +527,210 @@ data字段
 
 </details>
 
+#### 上舰通知
+
+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 | 待调查                      |     |
+
+<details>
+
+<summary>查看消息示例：</summary>
+
+```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
+  }
+}
+```
+
+</details>
+
+#### 醒目留言
+
+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 | 待调查   |  |
+
+<details>
+
+<summary>查看消息示例：</summary>
+
+```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
+}
+```
+
+</details>
+
 #### 送礼
 
 json格式

docs/manga/light_card.md

@@ -152,20 +152,20 @@ Content-Type：`application/json`
 
 **正文参数（ application/json ）：**
 
-| 参数名       | 类型  | 必填 | 内容  | 备注     |
+| 参数名       | 类型  | 必填 | 内容   | 备注                   |
-|-----------|-----|----|-----|--------|
+|-----------|-----|----|------|----------------------|
-| weekIndex | num | √  | 第几周 | 从`1`开始 |
+| weekIndex | num | √  | 第几周  | 从`1`开始               |
-| type      | num | √  | 第几天 | 从`1`开始 |
+| type      | num | √  | 领取类型 | 1：领取漫读券<br/>2：领取限免卡  |
 
 **json回复：**
 
 根对象：
 
-| 字段名  | 类型  | 内容  | 备注                                                 |
+| 字段名  | 类型  | 内容  | 备注                                                                |
-|------|-----|-----|----------------------------------------------------|
+|------|-----|-----|-------------------------------------------------------------------|
-| code | num | 响应码 | 0：成功<br/>3：今日已领取,请明日再来<br/>3：还未满足领取条件<br/>4：找不到数据~ |
+| code | num | 响应码 | 0：成功<br/>3：今日已领取,请明日再来<br/>3：还未满足领取条件<br/>4：找不到数据~<br/>6：你点击太快了哦~ |
-| msg  | str |     |                                                    |
+| msg  | str |     |                                                                   |
-| data | obj |     |                                                    |
+| data | obj |     |                                                                   |
 
 **示例：**
 

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;
 }

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;     // 热门评论

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 国际版
+    // 粉 白 蓝 直播姬 HD 海外 OTT 漫画 TV野版 小视频 网易漫画 网易漫画 网易漫画HD 国际版 东南亚版
-    // 1  2  3    4    5   6    7   8     9     10      11       12       13       14
+    // 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;
 }

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;

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;
 }

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;

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<string, string> 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_OP = 1;         // 跳过OP
-    CLIP_TYPE_ED = 2;         //
+    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<int32, QualityExtInfo> quality_ext_map = 10;
     //
     map<string, int32> 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;
 }
 

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<string, string> annotation = 8;
 }