01AG 接口是什么
AG(Asia Gaming)是亚洲区最常被接入的真人视讯供应商之一,产品以百家乐、龙虎、轮盘等桌台为主,玩家看到的是一路视频流加一个下注面板。
技术上有两件事必须提前想清楚:一是余额模型,免转钱包意味着每一次下注都要实时调你的钱包接口;二是桌台与限红,不同会员等级看到的桌台和限红不一样,接口层面要能按等级下发,否则高等级客户会看到一堆不该看到的台子。
02三种接入方式
免转钱包
余额留在站内,进入即玩。优点是体验连贯,缺点是你的钱包要扛住牌局节奏的调用频率。
转账钱包
进场转账、退场回传。实现简单,但要防止玩家异常退出导致额度滞留。
注单与路单
注单用于结算对账,路单用于前台展示。两套数据来源不同,别混着用一个接口。
03对接需要准备的字段
下面是最小字段集。字段命名各家不同,但语义基本固定——先把这张表填完,再去对厂商文档,能省掉一半来回。
| 字段 | 说明 |
|---|---|
username | 玩家账号,需与钱包账户一一对应 |
game_type / table_id | 游戏类型与桌台号,可按等级做白名单 |
bet_amount | 下注额,注意与限红规则校验 |
win_amount | 派彩额,结算时才回传 |
platform_id | 平台标识,多平台接入时用来区分 |
timestamp | 注单时间,统一时区后再入库 |
对接流程
- 开户与权限:拿到商户号、密钥与测试环境,确认开放了哪些产品线。
- 钱包打通:先做单笔扣加,跑通幂等与超时补偿。
- 游戏入口:换取游戏地址或 token,验证前台跳转与返回。
- 注单回传:接回调,同时准备定时拉单做补偿。
- 对账与压测:按天比对全量注单,晚高峰压一轮钱包接口。
04这一类接口最常见的坑
- 限红没按等级下发:所有会员看到同一套桌台,高净值客户体验直接掉档。
- 断线不回收:免转模式玩家断线后注单还在进行,你的超时处理必须对齐厂商的作废规则。
- 只算输赢不算抽水:报表口径没统一,月底毛利对不上。
- 视频与下注不同步:播放延迟高,玩家会以为被吃单,CDN 选点很关键。
这些坑的共同点是:接口能通、数据不对。上线前用真实注单跑一遍全量对账,比在测试环境调通十个接口更有价值。
05常见问题
AG 一定要用免转钱包吗?
不是。两种模式都支持,选哪种看你钱包接口的并发能力。多数中等规模站先用转账跑通,再逐步切免转。
真人视讯的视频流走哪里?
视频流一般由厂商侧提供,经 CDN 分发。你的服务器只负责下注与注单,不要把视频流代理到自己机器上,带宽会被吃穿。
注单延迟多久算正常?
通常秒级到分钟级,具体看厂商。做对账时不要假设实时,按时间段拉明细才是稳妥做法。
桌台限红可以自己调吗?
可以在权限内按会员等级做映射,但上下限由厂商设定,不能超范围。
06其他厂商接口
AG 接口可以单独接入,也可以与其他厂商一起走统一网关——字段、签名、回调全部封一层,前台只认一套协议。