SDK 与客户端库

unzip opendata-sdk-js-<version>.zip          # → sdk/js, sdk/contract

# 先把 SDK 构建一次(包里只有源码,没有 dist/)
cd sdk/js && npm install && npm run build

# 然后在你的项目里从这个目录安装
npm install /path/to/sdk/js

# 引用名(它 package.json 里的名字):
#   import { RestClient, RealtimeClient } from '@openplatform/football-sdk'

import { RestClient, RealtimeClient } from '@openplatform/football-sdk'

const rest = new RestClient({ baseUrl: 'https://api.sports.csap.ai', apiKey: process.env.OPB_API_KEY })

const live = await rest.live({ limit: 50 }) // 进行中的比赛
console.log(live.length, 'live matches')

const rt = new RealtimeClient({
  rest, // 每次(重)连都用它换一张一次性票据
  subscriptions: [{ channels: ['match', 'incident'], matches: live.slice(0, 5).map((r) => r.id) }],
})
rt.on('match', (m, meta) => console.log(m.match_id, m.home_scores[0], m.away_scores[0], meta.snapshot ? '(snapshot)' : ''))
rt.on('incident', (e, meta) => console.log(e.match_id, e.incident_type, e.minute, meta.revised ? '(revised)' : ''))
rt.on('gap', (g) => console.log('offline', g.since, '→', g.until)) // 每次重连成功后一次
rt.on('fatal', (err) => console.error('will not reconnect:', err.message))
await rt.connect()

import { RealtimeClient } from '@openplatform/football-sdk'

// 页面里没有 API Key:回调去问你的服务端要票据
const rt = new RealtimeClient({
  baseUrl: 'https://api.sports.csap.ai',
  getTicket: () => fetch('/opendata/ticket', { method: 'POST' }).then((r) => r.json()),
  subscriptions: [{ channels: ['match'], matches: ['900001'] }],
})
rt.on('match', (m) => console.log(m.match_id, m.home_scores[0], m.away_scores[0]))
await rt.connect()

import 'package:flutter/widgets.dart';
import 'package:opendata_anim/opendata_anim.dart';

// 令牌方式:你的服务端用 API Key 换组件令牌(POST /api/v1/widget/token)
Widget tokenMode(Future<Map<String, Object?>> Function(Map<String, Object?> body) askMyServer) {
  return OpenDataAnim(
    baseUrl: Uri.parse('https://api.sports.csap.ai'),
    match: '900001',             // 比赛 id;'auto' 自动挑一场正在踢的;'replay:demo' 播放录像
    view: AnimView.flat25d,      // 或 AnimView.stadium3d
    tokenProvider: (req) async => AnimToken.fromJson(await askMyServer(req.toJson())),
    onEvent: (e) {
      if (e.type == AnimEventType.goal && !e.historical) debugPrint('goal ${e.side} ${e.score}');
      if (e.type == AnimEventType.fullTime) debugPrint('full time ${e.score}');
    },
  );
}

// App Key 方式:不需要自己的服务端;这把 Key 是公开的,只能加载动画
Widget appKeyMode() {
  return OpenDataAnim.appKey(
    baseUrl: Uri.parse('https://api.sports.csap.ai'),
    appKey: 'pk_xxxxxxxx',                              // 控制台 → 动画直播组件 → App Key
    embedOrigin: Uri.parse('https://app.example.com'),  // 它的主机名必须在这把 Key 的域名白名单里
    match: '900001',
    onError: (e) {
      if (e is AnimRefused) debugPrint('refused: ${e.reason}');   // domain / disabled / quota …
    },
  );
}