Create & Init Project...

app/service/live/xroom/api/BUILD

@@ -0,0 +1,61 @@
+load(
+    "@io_bazel_rules_go//proto:def.bzl",
+    "go_proto_library",
+)
+
+package(default_visibility = ["//visibility:public"])
+
+load(
+    "@io_bazel_rules_go//go:def.bzl",
+    "go_library",
+)
+
+proto_library(
+    name = "api_proto",
+    srcs = ["api.proto"],
+    tags = ["automanaged"],
+    deps = ["@gogo_special_proto//github.com/gogo/protobuf/gogoproto"],
+)
+
+go_proto_library(
+    name = "api_go_proto",
+    compilers = ["@io_bazel_rules_go//proto:gogofast_grpc"],
+    importpath = "go-common/app/service/live/xroom/api",
+    proto = ":api_proto",
+    tags = ["automanaged"],
+    deps = ["@com_github_gogo_protobuf//gogoproto:go_default_library"],
+)
+
+go_library(
+    name = "go_default_library",
+    srcs = [
+        "api.bm.go",
+        "generate.go",
+    ],
+    embed = [":api_go_proto"],
+    importpath = "go-common/app/service/live/xroom/api",
+    tags = ["automanaged"],
+    visibility = ["//visibility:public"],
+    deps = [
+        "//library/net/http/blademaster:go_default_library",
+        "//library/net/http/blademaster/binding:go_default_library",
+        "@com_github_gogo_protobuf//gogoproto:go_default_library",
+        "@com_github_gogo_protobuf//proto:go_default_library",
+        "@org_golang_google_grpc//:go_default_library",
+        "@org_golang_x_net//context:go_default_library",
+    ],
+)
+
+filegroup(
+    name = "package-srcs",
+    srcs = glob(["**"]),
+    tags = ["automanaged"],
+    visibility = ["//visibility:private"],
+)
+
+filegroup(
+    name = "all-srcs",
+    srcs = [":package-srcs"],
+    tags = ["automanaged"],
+    visibility = ["//visibility:public"],
+)

app/service/live/xroom/api/api.bm.go

@@ -0,0 +1,79 @@
+// Code generated by protoc-gen-bm v0.1, DO NOT EDIT.
+// source: api.proto
+
+/*
+Package api is a generated blademaster stub package.
+This code was generated with go-common/app/tool/bmgen/protoc-gen-bm v0.1.
+
+It is generated from these files:
+	api.proto
+*/
+package api
+
+import (
+	"context"
+
+	bm "go-common/library/net/http/blademaster"
+	"go-common/library/net/http/blademaster/binding"
+)
+
+// to suppressed 'imported but not used warning'
+var _ *bm.Context
+var _ context.Context
+var _ binding.StructValidator
+
+var PathRoomGetMultiple = "/live.xroom.v1.Room/getMultiple"
+var PathRoomGetMultipleByUids = "/live.xroom.v1.Room/getMultipleByUids"
+var PathRoomIsAnchor = "/live.xroom.v1.Room/isAnchor"
+
+// ==============
+// Room Interface
+// ==============
+
+type RoomBMServer interface {
+	// 批量根据room_ids获取房间信息
+	GetMultiple(ctx context.Context, req *RoomIDsReq) (resp *RoomIDsInfosResp, err error)
+
+	// 批量根据uids获取房间信息
+	GetMultipleByUids(ctx context.Context, req *UIDsReq) (resp *UIDsInfosResp, err error)
+
+	// 批量根据uids判断是否是主播，如果是返回主播的room_id，否则返回0
+	IsAnchor(ctx context.Context, req *IsAnchorUIDsReq) (resp *IsAnchorUIDsResp, err error)
+}
+
+var RoomSvc RoomBMServer
+
+func roomGetMultiple(c *bm.Context) {
+	p := new(RoomIDsReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := RoomSvc.GetMultiple(c, p)
+	c.JSON(resp, err)
+}
+
+func roomGetMultipleByUids(c *bm.Context) {
+	p := new(UIDsReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := RoomSvc.GetMultipleByUids(c, p)
+	c.JSON(resp, err)
+}
+
+func roomIsAnchor(c *bm.Context) {
+	p := new(IsAnchorUIDsReq)
+	if err := c.BindWith(p, binding.Default(c.Request.Method, c.Request.Header.Get("Content-Type"))); err != nil {
+		return
+	}
+	resp, err := RoomSvc.IsAnchor(c, p)
+	c.JSON(resp, err)
+}
+
+// RegisterRoomBMServer Register the blademaster route
+func RegisterRoomBMServer(e *bm.Engine, server RoomBMServer) {
+	RoomSvc = server
+	e.GET("/live.xroom.v1.Room/getMultiple", roomGetMultiple)
+	e.GET("/live.xroom.v1.Room/getMultipleByUids", roomGetMultipleByUids)
+	e.GET("/live.xroom.v1.Room/isAnchor", roomIsAnchor)
+}

app/service/live/xroom/api/api.proto

@@ -0,0 +1,166 @@
+// 定义项目 API 的 proto 文件 可以同时描述 gRPC 和 HTTP API
+// protobuf 文件参考:
+//  - https://developers.google.com/protocol-buffers/
+//  - http://info.bilibili.co/display/documentation/gRPC+Proto
+// protobuf 生成 HTTP 工具:
+//  - http://git.bilibili.co/platform/go-common/tree/master/app/tool/protoc-gen-bm
+// gRPC Golang Model:
+//  - http://info.bilibili.co/display/documentation/gRPC+Golang+Model
+// gRPC Golang Warden Gen:
+//  - http://info.bilibili.co/display/documentation/gRPC+Golang+Warden+Gen
+// gRPC http 调试工具(无需pb文件):
+//  - http://info.bilibili.co/pages/viewpage.action?pageId=12877366
+// grpc 命令行调试工具(无需pb文件):
+//  - http://info.bilibili.co/pages/viewpage.action?pageId=11869411
+syntax = "proto3";
+
+import "github.com/gogo/protobuf/gogoproto/gogo.proto";
+
+package live.xroom.v1;
+
+option go_package = "api";
+
+option (gogoproto.goproto_getters_all) = false;
+
+service Room {
+	// 批量根据room_ids获取房间信息
+	rpc getMultiple (RoomIDsReq) returns (RoomIDsInfosResp);
+	// 批量根据uids获取房间信息
+	rpc getMultipleByUids (UIDsReq) returns (UIDsInfosResp);
+	// 批量根据uids判断是否是主播，如果是返回主播的room_id，否则返回0
+	rpc isAnchor (IsAnchorUIDsReq) returns (IsAnchorUIDsResp);
+}
+
+message RoomIDsReq {
+	// room_ids数组，长号
+	repeated int64 room_ids = 1 [(gogoproto.moretags) = 'form:"room_ids" validate:"required,gt=0,dive,gt=0"'];
+	// 要获取的房间信息维度 status:状态相关 show:展示相关 area:分区相关 anchor:主播相关
+	repeated string attrs = 2 [(gogoproto.moretags) = 'form:"attrs" validate:"required,gt=0,dive,gt=0"'];
+}
+message UIDsReq {
+	// 主播uids
+	repeated int64 uids = 1 [(gogoproto.moretags) = 'form:"uids" validate:"required,gt=0,dive,gt=0"'];
+	// 要获取的房间信息维度 status:状态相关 show:展示相关 area:分区相关 anchor:主播相关
+	repeated string attrs = 2 [(gogoproto.moretags) = 'form:"attrs" validate:"required,gt=0,dive,gt=0"'];
+}
+message IsAnchorUIDsReq {
+	// 主播uids
+	repeated int64 uids = 1 [(gogoproto.moretags) = 'form:"uids" validate:"required,gt=0,dive,gt=0"'];
+}
+
+message IsAnchorUIDsResp {
+	// uid => room_id(长号)，room_id=0表示没有创建房间
+	map<int64, int64> list = 1 [(gogoproto.jsontag) = "list"];
+}
+// 批量根据room_ids获取房间信息
+message RoomIDsInfosResp {
+	// 主播room_id => 房间维度信息
+	map<int64, Infos> list = 1 [(gogoproto.jsontag) = "list"];
+}
+// 批量根据uids获取房间信息
+message UIDsInfosResp {
+	// 主播UID => 房间维度信息
+	map<int64, Infos> list = 1 [(gogoproto.jsontag) = "list"];
+}
+message Infos {
+	// room_id 房间长号
+	int64 room_id = 1 [(gogoproto.jsontag) = "room_id"];
+	// uid 主播uid
+	int64 uid = 2 [(gogoproto.jsontag) = "uid"];
+	// Model1：房间信息（状态相关）
+	RoomStatusInfo status = 3 [(gogoproto.jsontag) = "status"];
+	// Model2：房间信息（展示相关）
+	RoomShowInfo show = 4 [(gogoproto.jsontag) = "show"];
+	// Model3：房间信息（分区相关）
+	RoomAreaInfo area = 5 [(gogoproto.jsontag) = "area"];
+	// Model4：房间信息（主播相关）
+	RoomAnchorInfo anchor = 6 [(gogoproto.jsontag) = "anchor"];
+}
+
+// 房间信息(状态）
+message RoomStatusInfo {
+	// 直播间状态 0未开播，1直播中；2轮播中；
+	int64 live_status = 1 [(gogoproto.jsontag) = "live_status"];
+	// 横竖屏方向 0横屏，1竖屏
+	int64 live_screen_type = 2 [(gogoproto.jsontag) = "live_screen_type"];
+	// 是否开播过标识
+	int64 live_mark = 3 [(gogoproto.jsontag) = "live_mark"];
+	// 封禁状态：0未封禁；1审核封禁; 2全网封禁
+	int64 lock_status = 4 [(gogoproto.jsontag) = "lock_status"];
+	// 封禁时间戳
+	int64 lock_time = 5 [(gogoproto.jsontag) = "lock_time"];
+	// 隐藏状态 0不隐藏，1隐藏
+	int64 hidden_status = 6 [(gogoproto.jsontag) = "hidden_status"];
+	// 隐藏时间戳
+	int64 hidden_time = 7 [(gogoproto.jsontag) = "hidden_time"];
+	// 直播类型 0默认 1摄像头直播 2录屏直播 3语音直播
+	int64 live_type = 8 [(gogoproto.jsontag) = "live_type"];
+}
+
+// 房间信息(展示)
+message RoomShowInfo {
+	// short_id 短号
+	int64 short_id = 1 [(gogoproto.jsontag) = "short_id"];
+	// 直播间标题
+	string title = 2 [(gogoproto.jsontag) = "title"];
+	// 直播间封面
+	string cover = 3 [(gogoproto.jsontag) = "cover"];
+	// 直播间标签
+	string tags = 4 [(gogoproto.jsontag) = "tags"];
+	// 直播间背景图
+	string background = 5 [(gogoproto.jsontag) = "background"];
+	// 直播间简介
+	string description = 6 [(gogoproto.jsontag) = "description"];
+	// 关键帧
+	string keyframe = 7 [(gogoproto.jsontag) = "keyframe"];
+	// 人气值
+	int64 popularity_count = 8 [(gogoproto.jsontag) = "popularity_count"];
+	// 房间tag（角标）
+	repeated TagData tag_list = 9 [(gogoproto.jsontag) = "tag_list"];
+	// 最近一次开播时间戳
+	int64 live_start_time = 10 [(gogoproto.jsontag) = "live_start_time"];
+}
+
+// 房间信息(分区)
+message RoomAreaInfo {
+	// 直播间分区id
+	int64 area_id = 1 [(gogoproto.jsontag) = "area_id"];
+	// 直播间分区名称
+	string area_name = 2 [(gogoproto.jsontag) = "area_name"];
+	// 直播间父分区id
+	int64 parent_area_id = 3 [(gogoproto.jsontag) = "parent_area_id"];
+	// 直播间父分区名称
+	string parent_area_name = 4 [(gogoproto.jsontag) = "parent_area_name"];
+}
+
+// 主播信息(展示)
+message RoomAnchorInfo {
+	// 主播类型
+	int64 anchor_profile_type = 1 [(gogoproto.jsontag) = "anchor_profile_type"];
+	// 主播等级
+	AnchorLevel anchor_level = 2 [(gogoproto.jsontag) = "anchor_level"];
+}
+
+// 房间角标、tag
+message TagData {
+	int64 tag_id = 1 [(gogoproto.jsontag) = "tag_id"];
+	int64 tag_sub_id = 2 [(gogoproto.jsontag) = "tag_sub_id"];
+	int64 tag_value = 3 [(gogoproto.jsontag) = "tag_value"];
+	string tag_ext = 4 [(gogoproto.jsontag) = "tag_ext"];
+}
+
+// 主播经验定义
+message AnchorLevel {
+	// 等级
+	int64 level = 1 [(gogoproto.jsontag) = "level"];
+	// 当前等级颜色
+	int64 color = 2 [(gogoproto.jsontag) = "color"];
+	// 当前积分
+	int64 score = 3 [(gogoproto.jsontag) = "score"];
+	// 当前等级最小积分
+	int64 left = 4 [(gogoproto.jsontag) = "left"];
+	// 下一等级起始积分
+	int64 right = 5 [(gogoproto.jsontag) = "right"];
+	// 下一个经验值
+	int64 max_level = 6 [(gogoproto.jsontag) = "max_level"];
+}

app/service/live/xroom/api/api.room.md

@@ -0,0 +1,257 @@
+<!-- package=live.xroom.v1 -->
+- [/live.xroom.v1.Room/getMultiple](#live.xroom.v1.RoomgetMultiple)  批量根据room_ids获取房间信息
+- [/live.xroom.v1.Room/getMultipleByUids](#live.xroom.v1.RoomgetMultipleByUids)  批量根据uids获取房间信息
+- [/live.xroom.v1.Room/isAnchor](#live.xroom.v1.RoomisAnchor)  批量根据uids判断是否是主播，如果是返回主播的room_id，否则返回0
+
+## /live.xroom.v1.Room/getMultiple
+### 批量根据room_ids获取房间信息
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|room_ids|是|多个integer| room_ids数组，长号|
+|attrs|是|多个string| 要获取的房间信息维度 status:状态相关 show:展示相关 area:分区相关 anchor:主播相关|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        //  主播room_id => 房间维度信息
+        "list": {
+            "1": {
+                //  room_id 房间长号
+                "room_id": 0,
+                //  uid 主播uid
+                "uid": 0,
+                //  Model1：房间信息（状态相关）
+                "status": {
+                    //  直播间状态 0未开播，1直播中；2轮播中；
+                    "live_status": 0,
+                    //  横竖屏方向 0横屏，1竖屏
+                    "live_screen_type": 0,
+                    //  是否开播过标识
+                    "live_mark": 0,
+                    //  封禁状态：0未封禁；1审核封禁; 2全网封禁
+                    "lock_status": 0,
+                    //  封禁时间戳
+                    "lock_time": 0,
+                    //  隐藏状态 0不隐藏，1隐藏
+                    "hidden_status": 0,
+                    //  隐藏时间戳
+                    "hidden_time": 0,
+                    //  直播类型 0默认 1摄像头直播 2录屏直播 3语音直播
+                    "live_type": 0
+                },
+                //  Model2：房间信息（展示相关）
+                "show": {
+                    //  short_id 短号
+                    "short_id": 0,
+                    //  直播间标题
+                    "title": "",
+                    //  直播间封面
+                    "cover": "",
+                    //  直播间标签
+                    "tags": "",
+                    //  直播间背景图
+                    "background": "",
+                    //  直播间简介
+                    "description": "",
+                    //  关键帧
+                    "keyframe": "",
+                    //  人气值
+                    "popularity_count": 0,
+                    //  房间tag（角标）
+                    "tag_list": [
+                        {
+                            "tag_id": 0,
+                            "tag_sub_id": 0,
+                            "tag_value": 0,
+                            "tag_ext": ""
+                        }
+                    ],
+                    //  最近一次开播时间戳
+                    "live_start_time": 0
+                },
+                //  Model3：房间信息（分区相关）
+                "area": {
+                    //  直播间分区id
+                    "area_id": 0,
+                    //  直播间分区名称
+                    "area_name": "",
+                    //  直播间父分区id
+                    "parent_area_id": 0,
+                    //  直播间父分区名称
+                    "parent_area_name": ""
+                },
+                //  Model4：房间信息（主播相关）
+                "anchor": {
+                    //  主播类型
+                    "anchor_profile_type": 0,
+                    //  主播等级
+                    "anchor_level": {
+                        //  等级
+                        "level": 0,
+                        //  当前等级颜色
+                        "color": 0,
+                        //  当前积分
+                        "score": 0,
+                        //  当前等级最小积分
+                        "left": 0,
+                        //  下一等级起始积分
+                        "right": 0,
+                        //  下一个经验值
+                        "max_level": 0
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+
+## /live.xroom.v1.Room/getMultipleByUids
+### 批量根据uids获取房间信息
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|uids|是|多个integer| 主播uids|
+|attrs|是|多个string| 要获取的房间信息维度 status:状态相关 show:展示相关 area:分区相关 anchor:主播相关|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        //  主播UID => 房间维度信息
+        "list": {
+            "1": {
+                //  room_id 房间长号
+                "room_id": 0,
+                //  uid 主播uid
+                "uid": 0,
+                //  Model1：房间信息（状态相关）
+                "status": {
+                    //  直播间状态 0未开播，1直播中；2轮播中；
+                    "live_status": 0,
+                    //  横竖屏方向 0横屏，1竖屏
+                    "live_screen_type": 0,
+                    //  是否开播过标识
+                    "live_mark": 0,
+                    //  封禁状态：0未封禁；1审核封禁; 2全网封禁
+                    "lock_status": 0,
+                    //  封禁时间戳
+                    "lock_time": 0,
+                    //  隐藏状态 0不隐藏，1隐藏
+                    "hidden_status": 0,
+                    //  隐藏时间戳
+                    "hidden_time": 0,
+                    //  直播类型 0默认 1摄像头直播 2录屏直播 3语音直播
+                    "live_type": 0
+                },
+                //  Model2：房间信息（展示相关）
+                "show": {
+                    //  short_id 短号
+                    "short_id": 0,
+                    //  直播间标题
+                    "title": "",
+                    //  直播间封面
+                    "cover": "",
+                    //  直播间标签
+                    "tags": "",
+                    //  直播间背景图
+                    "background": "",
+                    //  直播间简介
+                    "description": "",
+                    //  关键帧
+                    "keyframe": "",
+                    //  人气值
+                    "popularity_count": 0,
+                    //  房间tag（角标）
+                    "tag_list": [
+                        {
+                            "tag_id": 0,
+                            "tag_sub_id": 0,
+                            "tag_value": 0,
+                            "tag_ext": ""
+                        }
+                    ],
+                    //  最近一次开播时间戳
+                    "live_start_time": 0
+                },
+                //  Model3：房间信息（分区相关）
+                "area": {
+                    //  直播间分区id
+                    "area_id": 0,
+                    //  直播间分区名称
+                    "area_name": "",
+                    //  直播间父分区id
+                    "parent_area_id": 0,
+                    //  直播间父分区名称
+                    "parent_area_name": ""
+                },
+                //  Model4：房间信息（主播相关）
+                "anchor": {
+                    //  主播类型
+                    "anchor_profile_type": 0,
+                    //  主播等级
+                    "anchor_level": {
+                        //  等级
+                        "level": 0,
+                        //  当前等级颜色
+                        "color": 0,
+                        //  当前积分
+                        "score": 0,
+                        //  当前等级最小积分
+                        "left": 0,
+                        //  下一等级起始积分
+                        "right": 0,
+                        //  下一个经验值
+                        "max_level": 0
+                    }
+                }
+            }
+        }
+    }
+}
+```
+
+
+## /live.xroom.v1.Room/isAnchor
+### 批量根据uids判断是否是主播，如果是返回主播的room_id，否则返回0
+
+#### 方法：GET
+
+#### 请求参数
+
+|参数名|必选|类型|描述|
+|:---|:---|:---|:---|
+|uids|是|多个integer| 主播uids|
+
+#### 响应
+
+```javascript
+{
+    "code": 0,
+    "message": "ok",
+    "data": {
+        //  uid => room_id(长号)，room_id=0表示没有创建房间
+        "list": {
+            "1": 0
+        }
+    }
+}
+```
+

app/service/live/xroom/api/generate.go

@@ -0,0 +1,4 @@
+package api
+
+// 生成 gRPC 代码
+//go:generate $GOPATH/src/go-common/app/tool/warden/protoc.sh