MiyaLive (蜜芽直播/MC) URL Scheme 协议文档
概述
MiyaLive 使用 micha:// 和 micha:// 两种 URL Scheme 进行应用内路由跳转。
两者功能相同，micha:// 会在内部转换为 micha:// 处理。
基本格式
micha://pname={页面名称}&{参数1}={值1}&{参数2}={值2}...
或者带问号的格式（两种都支持）：
micha://?pname={页面名称}&{参数1}={值1}&{参数2}={值2}...
通用参数
| 参数 |
类型 |
说明 |
pname |
string |
页面名称（必须） |
from |
string |
来源标识，用于埋点追踪 |
一、房间相关
1.1 进入直播间 (room)
micha://pname=room&live={live_id}&room_info={JSON_ENCODED}
| 参数 |
类型 |
必须 |
说明 |
live |
string |
✅ |
直播间ID (live_id) |
room_info |
string |
❌ |
URL编码的JSON，包含额外信息 |
enterRoomType |
string |
❌ |
进房来源类型，如 fol-123456, act-热门推荐, search |
FOLLOW_JOIN_ROOM_UID |
int |
❌ |
跟随进房的用户ID |
room_info 结构：
{
"extraData": {
"join_room_code": "JR11117728",
"invite_code": "983496",
"track_token": "",
"followJoinRoomUid": 0
}
}
示例：
import json
from urllib.parse import quote
live_id = "1737269989067805"
room_info = {"extraData": {"join_room_code": "JR11117728", "invite_code": "983496"}}
url = f"micha://pname=room&live={live_id}&room_info={quote(json.dumps(room_info))}"
1.2 H5房间 (roomh5) - 已在房间内时跳转
micha://?pname=roomh5&live={live_id}
1.3 音频房间 (audioroom)
micha://pname=audioroom&live={live_id}
1.4 Meta KTV 房间 (metaktvroom)
micha://?pname=metaktvroom&live_id={live_id}
1.5 创建音频房间 (audiocreateroom)
micha://pname=audiocreateroom&from={来源}&topic_name={话题名称}
1.6 房间贡献榜 (contributionlist / contributionlistV2)
micha://pname=contributionlist
micha://pname=contributionlistV2
二、用户相关
2.1 个人主页 (personalhome)
micha://pname=personalhome&user={uid}
| 参数 |
类型 |
必须 |
说明 |
user |
int |
✅ |
用户ID |
2.2 编辑个人资料 (editinfo)
micha://pname=editinfo
2.3 粉丝列表 (fans)
micha://pname=fans&user={uid}
2.4 关注列表 (following)
micha://pname=following&user={uid}
2.5 黑名单 (blacklist)
micha://pname=blacklist
2.6 最近访客 (recentvisitor)
micha://pname=recentvisitor
2.7 浏览历史 (browsehistoryactivity)
micha://pname=browsehistoryactivity
2.8 用户关系列表 (userrelationship / contacts)
micha://pname=userrelationship&type={类型}
micha://pname=contacts&type={类型}
| 参数 |
类型 |
说明 |
type |
string |
fans_type, follow_type, friend_type |
2.9 主播标签 (anchorlabel)
micha://pname=anchorlabel&user={uid}&gender={性别}
| 参数 |
类型 |
说明 |
user |
int |
用户ID |
gender |
int |
性别 (1=男, 2=女) |
三、消息/聊天相关
3.1 消息中心 (message)
micha://pname=message
3.2 私信聊天 (privatemsg)
micha://pname=privatemsg&user={uid}
3.3 房间内@聊天 (roomchatat)
micha://pname=roomchatat&user={uid}&nick={昵称}
micha://pname=roomchatat&user={uid}&nick={昵称}&mystery=true // 神秘人模式
3.4 聊天对话框 (chatdialog)
micha://pname=chatdialog&user={uid}&nick={昵称}
3.5 群聊 (joingroupchatroom)
micha://pname=joingroupchatroom&group_id={群ID}
四、充值/钱包相关
4.1 充值页面 (charge)
micha://pname=charge
4.2 房间内充值 (roomcharge)
micha://pname=roomcharge
4.3 我的收益 (myincome)
micha://pname=myincome
4.4 兑换映币 (convertincoin)
micha://pname=convertincoin
4.5 贵族充值 (noblecharge)
micha://pname=noblecharge
4.6 酒馆商城 (wineshop)
micha://pname=wineshop
五、礼物相关
5.1 礼物墙 (opengiftwall)
micha://pname=opengiftwall
5.2 礼物图鉴 (gift_book_page)
micha://pname=gift_book_page
5.3 周礼物墙 (weekly_gift_wall)
micha://pname=weekly_gift_wall
5.4 礼物勋章 (giftmedal)
micha://pname=giftmedal
5.5 社交礼物详情 (social_gift)
micha://pname=social_gift
5.6 位置礼物 (positiongift)
micha://pname=positiongift
六、荣誉/勋章相关
6.1 荣誉中心 (user_honor_center)
micha://pname=user_honor_center
6.2 勋章详情 (user_honor_medal_detail)
micha://pname=user_honor_medal_detail&medal_id={勋章ID}
6.3 勋章佩戴 (user_honor_medal_wear)
micha://pname=user_honor_medal_wear
七、粉丝团/守护相关
7.1 粉丝团列表 (fansclublist)
micha://pname=fansclublist
7.2 粉丝团任务 (fansclubtask)
micha://pname=fansclubtask
7.3 守护列表 (guardlist)
micha://pname=guardlist
7.4 购买守护 (jumptoguardpurchase)
micha://pname=jumptoguardpurchase
7.5 管理员对话框 (managerdialog)
micha://pname=managerdialog
八、家族相关
8.1 家族房间列表 (familyroomlist)
micha://pname=familyroomlist
8.2 家族主页 (familyhome)
micha://pname=familyhome&family_id={家族ID}
8.3 家族动态 (familydynamic)
micha://pname=familydynamic
8.4 创建/更新家族 (createfamily)
micha://pname=createfamily
8.5 家族公告 (familynotice)
micha://pname=familynotice
8.6 家族成员操作 (familymemberaction)
micha://pname=familymemberaction
九、活动/排行相关
9.1 活动中心 (hotcenter)
micha://pname=hotcenter
9.2 VIP页面 (vippage)
micha://pname=vippage
9.3 排行榜 (play_rank_key)
micha://pname=play_rank_key
9.4 热门主播 (popularBroadcaster)
micha://pname=popularBroadcaster
9.5 我的直播数据 (myLiveEffctive)
micha://pname=myLiveEffctive
十、首页/大厅相关
10.1 首页热门 (hallhot)
micha://pname=hallhot
10.2 首页关注 (hallfollow)
micha://pname=hallfollow
10.3 首页发现 (halldiscovery / hallfind)
micha://pname=halldiscovery
micha://pname=hallfind
10.4 首页附近 (hallnearby / nearby)
micha://pname=hallnearby
micha://pname=nearby
10.5 首页新人 (hallnew)
micha://pname=hallnew
10.6 搜索 (search)
micha://pname=search
十一、设置/账户相关
11.1 设置页面 (setting)
micha://pname=setting
11.2 账户安全 (accountsafe)
micha://pname=accountsafe
11.3 房间管理 (roommanagement)
micha://pname=roommanagement
十二、其他功能
12.1 录制/回放 (record)
micha://pname=record
12.2 分享 (webshare)
micha://pname=webshare&url={分享URL}&title={标题}
12.3 唤醒 (wake)
micha://pname=wake
12.4 举报 (reportreason)
micha://pname=reportreason&user={uid}
12.5 推送报告 (pushreport)
micha://pname=pushreport
12.6 推送直播列表 (pushLiveList)
micha://pname=pushLiveList
12.7 频道页面 (channelpage)
micha://pname=channelpage
12.8 快速匹配 (fastmatch)
micha://pname=fastmatch
12.9 收藏房间 (collection_room)
micha://pname=collection_room
12.10 关系小屋 (relationcabin)
micha://pname=relationcabin
12.11 房间相册 (roomalbum)
micha://pname=roomalbum
12.12 社交游戏 (createsocialgame)
micha://pname=createsocialgame
12.13 网页游戏 (webgame)
micha://pname=webgame
12.14 派对签到 (partysignin)
micha://pname=partysignin
12.15 俱乐部分享 (clubshare)
micha://pname=clubshare
12.16 拍卖首页 (auctionhome / auctionhomefull)
micha://pname=auctionhome
micha://pname=auctionhomefull // 全屏模式
12.17 心动呼叫 (xindong_call)
micha://pname=xindong_call
12.18 二维码扫描 (openqrcode)
micha://pname=openqrcode
12.19 客服 (customerservice)
micha://pname=customerservice
12.20 我的排名 (myrank)
micha://pname=myrank
12.21 头像上传 (portrait_upload_v720)
micha://pname=portrait_upload_v720
12.22 语音签名 (voicesign)
micha://pname=voicesign
12.23 Toast提示 (toast)
micha://pname=toast&msg={消息内容}
12.24 确认对话框 (confirm_dialog)
micha://pname=confirm_dialog&title={标题}&content={内容}
12.25 启动页 (start)
micha://pname=start
十三、WebView 相关
13.1 通用Web页面 (web_view_activity)
micha://pname=web_view_activity&url={URL}
13.2 刷新Web页面 (refreshwebact)
micha://pname=refreshwebact
附录：路由常量对照表
| 路由Key |
常量名 |
目标Activity |
room |
ROOM_KEY |
RoomActivity |
audioroom |
AUDIOROOM_KEY |
RoomActivity |
personalhome |
ROUTE_USER_CENTER_USER_HOME_KEY |
OtherUserHomeActivity |
editinfo |
ROUTE_USER_CENTER_USER_EDIT_KEY |
UserInfoEditActivity |
setting |
ROUTE_USER_CENTER_SETTING_KEY |
UserSettingActivity |
charge |
CHARGE_KEY |
ChargeActivity |
myincome |
MY_INCOME_KEY |
MyGainActivity |
noblecharge |
NOBLE_CHARGE_KEY |
JoinNobleActivity |
record |
RECORD_KEY |
LiveRecordActivity |
hotcenter |
ROUTER_ACTIVITY_CENTER_KEY |
ActivityCenterActivity |
gift_book_page |
ROUTER_USER_GIFT_BOOK_KEY |
UserGiftBookActivity |
user_honor_center |
ROUTER_USER_HONOR_CENTER_KEY |
HonorCenterActivity |
social_gift |
ROUTE_USER_CENTER_SOCIAL_GIFT_KEY |
SocialGiftDetailActivity |
browsehistoryactivity |
BROWSEHISTORYACTIVITY_KEY |
BrowseHistoryActivity |
giftmedal |
ROUTER_USER_GIFT_WALL_MEDAL_KEY |
UserGiftWallMedalActivity |
weekly_gift_wall |
ROUTER_USER_WEEKLY_GIFT_WALL_KEY |
UserWeeklyGiftWallActivity |
roommanagement |
ROUTER_ROOM_MANAGEMENT_KEY |
ManagementActivity |
fastmatch |
FAST_MATCH_KEY |
MakeFriendMatchActivity |
wineshop |
WINE_SHOP_KEY |
WineShopActivity |
contributionlist |
CONTRIBUTION_LIST_KEY |
GiftNormalContributorActivity |
convertincoin |
CONVERTINCOIN_KEY |
ConversionListActivity |
audiocreateroom |
AUDIO_CREATEROOMACTIVITY_KEY |
AudioCreateRoomActivity |
channelactivity |
CHANNELACTIVITY_KEY |
ChannelActivity |
familyroomlist |
FAMILY_ROOM_LIST |
FamilyRoomListActivity |
openqrcode |
ROUTE_QR_SCAN_CAMERA_ACTIVITY_KEY |
QrCodeCameraActivity2 |
使用示例 (Python)
import json
from urllib.parse import quote
def build_room_url(live_id: str, join_room_code: str = None, invite_code: str = None) -> str:
"""构建进入直播间的URL Scheme"""
url = f"micha://pname=room&live={live_id}"
if join_room_code or invite_code:
extra_data = {}
if join_room_code:
extra_data["join_room_code"] = join_room_code
if invite_code:
extra_data["invite_code"] = invite_code
room_info = {"extraData": extra_data}
url += f"&room_info={quote(json.dumps(room_info))}"
return url
def build_user_home_url(uid: int) -> str:
"""构建用户主页URL"""
return f"micha://pname=personalhome&user={uid}"
def build_private_msg_url(uid: int) -> str:
"""构建私信URL"""
return f"micha://pname=privatemsg&user={uid}"
# 示例
print(build_room_url("1737269989067805", "JR11117728", "983496"))
print(build_user_home_url(123456789))
print(build_private_msg_url(123456789))