SportAPI
Live-интерфейсы

Приложение live-счёта по крикету для Android: API, виджет и исходный код

Как сделать приложение с live-счётом крикета для Android: откуда брать раны, уикеты и оверы, как устроить сервер, обновлять виджет на рабочем столе и не упереться в ограничения системы.

Телефон с live-счётом крикетного матча на фоне освещённого стадиона, ноутбук с кодом API на Kotlin, мяч и калитка

Приложение live-счёта по крикету состоит из трёх частей: источника данных со счётом, небольшого сервера, который этот счёт забирает и раздаёт, и самого приложения с экраном матчей и виджетом на рабочем столе. Сложнее всего обычно не код, а данные. Бесплатные API для крикета быстро упираются в лимиты, а приложения с открытым кодом на GitHub чаще всего парсят чужие сайты и ломаются при первом обновлении вёрстки.

В API спортивной линии SportAPI крикет идёт как обычный вид спорта (sport_id 66) в prematch и live: раны, уикеты и оверы команд, номер иннинга, отбивающая команда, коэффициенты, а у многих матчей ещё и видеотрансляция. Стоит это от $30 в месяц, проверить можно на тестовом ключе за 2 дня. Ниже — архитектура, код сервера и Android-приложения на Kotlin и самый неочевидный момент: как заставить виджет на рабочем столе обновляться в live.

Что показывает приложение live-счёта по крикету

ЭкранЧто на нёмДанные SportAPI
LiveИдущие матчи: счёт вида 154/3 (18.2), иннинг, кто отбиваетevents с типом live
РасписаниеМатчи на сегодня и ближайшие дни, турнирыКалендарь матчей и prematch-линия
МатчПодробный счёт, рынки и коэффициенты, видео, если оно естьevent по game_id
ВиджетСчёт любимой команды на рабочем столеВаш сервер + push

Состав турниров зависит от календаря. В снимке линии из нашей документации — Caribbean Premier League, турниры T20 Шри-Ланки, Kabul Premier League, международные матчи сборных, лиги США. Актуальный список даёт метод menu.

Архитектура: сервер между приложением и API

Приложение не должно обращаться к API напрямую. Ключ окажется в установочном файле, тысяча пользователей даст тысячу одинаковых запросов, а Android останавливает фоновые запросы, чтобы беречь батарею. Поэтому схема такая:

  1. Сервер раз в 7 секунд запрашивает все live-матчи крикета одним запросом events.
  2. Сервер приводит ответ к простому формату — счёт, уикеты, оверы, иннинг — и отдаёт его приложению.
  3. Когда счёт любимой команды меняется, сервер отправляет push через Firebase. Приложение обновляет виджет.

Интервал 7 секунд — минимальный для списка live-матчей по документации метода events. Для одного открытого матча можно запрашивать event раз в 5 секунд. Если коэффициенты на экране не нужны, добавьте к запросу odds=false: ответ станет в 2–5 раз меньше.

Как читать счёт крикета в ответе API

Счёт крикета не похож на футбольный, и разбирать его футбольным правилом нельзя. В ответе live-матча:

  • score_full — раны обеих команд через двоеточие: 154:90;
  • уикеты и оверы каждой команды — в отдельных полях, описанных в документации по крикету;
  • period_name — текущий иннинг, например «2nd innings»;
  • pitch — какая команда сейчас отбивает: 1 или 2;
  • game_desk — формат игры, для крикета это innings.

Привычная болельщикам запись «154/3 (18.2)» значит: 154 рана, 3 уикета, сыграно 18 оверов и 2 броска. Собирайте её на сервере, чтобы приложение получало готовую строку.

В списке live-матчей крикета встречаются и киберматчи — компьютерные симуляции. У них в названии турнира и команд есть пометка «cyber». Если в приложении нужны только настоящие матчи, отфильтруйте их на сервере.

Код сервера: live-счёт в простом формате

Пример на Node.js 18+. Сервер кеширует ответ и отдаёт приложению компактный JSON.

import express from 'express';

const LIVE_URL = 'https://YOUR_API_DOMAIN/v1/events/66/0/sub/50/live/en?odds=false';
let cache = { matches: [], updatedAt: 0 };

function side(game, n) {
  const runs = Number(game.score_full.split(':')[n - 1]) || 0;
  const wickets = readWickets(game, n); // поля уикетов — по документации крикета
  const overs = readOvers(game, n); // поля оверов — по документации крикета
  return {
    name: game[`opp_${n}_name`],
    score: wickets == null ? `${runs}` : `${runs}/${wickets}`,
    overs,
  };
}

async function refresh() {
  try {
    const res = await fetch(LIVE_URL, { headers: { Package: process.env.SPORTAPI_KEY } });
    if (res.ok) {
      const data = await res.json();
      const matches = [];
      for (const tournament of data.body ?? []) {
        if (/cyber/i.test(tournament.tournament_name)) continue; // без киберматчей
        for (const game of tournament.events_list) {
          matches.push({
            id: game.game_id,
            tournament: tournament.tournament_name,
            home: side(game, 1),
            away: side(game, 2),
            batting: game.pitch === '1' ? 'home' : 'away',
            innings: game.period_name,
          });
        }
      }
      cache = { matches, updatedAt: Date.now() };
    }
  } catch (err) {
    console.error(err);
  }
  setTimeout(refresh, 7000);
}

const app = express();
app.get('/cricket/live', (req, res) => res.json(cache));
app.listen(3000, refresh);

Приложение запрашивает /cricket/live у вашего сервера, а не у SportAPI. Сколько бы пользователей ни открыло приложение, к API уходит один запрос раз в 7 секунд.

Экран live-матчей на Kotlin

На стороне Android достаточно модели, запроса к своему серверу и списка на Jetpack Compose:

@Serializable data class Side(val name: String, val score: String, val overs: String? = null)
@Serializable data class Match(val id: Long, val tournament: String, val home: Side, val away: Side, val batting: String)
@Serializable data class Live(val matches: List<Match>)

suspend fun loadLive(client: HttpClient): Live =
    client.get("https://api.your-app.example/cricket/live").body()

@Composable
fun MatchRow(m: Match) {
    Column(Modifier.padding(16.dp)) {
        Text(m.tournament, style = MaterialTheme.typography.labelMedium)
        SideLine(m.home, isBatting = m.batting == "home")
        SideLine(m.away, isBatting = m.batting == "away")
    }
}

@Composable
fun SideLine(side: Side, isBatting: Boolean) {
    Row(Modifier.fillMaxWidth(), horizontalArrangement = Arrangement.SpaceBetween) {
        Text(if (isBatting) "● ${side.name}" else side.name)
        Text(side.score + (side.overs?.let { " ($it)" } ?: ""), fontWeight = FontWeight.Bold)
    }
}

Пока экран открыт, обновляйте список раз в 7–10 секунд. Когда приложение уходит в фон, остановите обновление: свежий счёт придёт через push. Как собрать похожее приложение сразу для Android и iPhone на одном коде, мы разбирали в статье про приложение live-результатов на Flutter.

Виджет на рабочем столе: почему он не обновляется сам

Это главный сюрприз для тех, кто делает свой первый live-виджет. Android ограничивает фоновые обновления:

Способ обновленияКак часто срабатываетПодходит для live
updatePeriodMillis в настройках виджетане чаще раза в 30 минутНет
Периодическая задача WorkManagerне чаще раза в 15 минутНет
Push с данными от вашего серверакогда изменился счётДа

Рабочая схема для live: сервер видит, что изменился счёт матча, на который подписан пользователь, и отправляет через Firebase сообщение с данными. Приложение получает его в фоне и обновляет виджет:

class ScoreMessagingService : FirebaseMessagingService() {
    override fun onMessageReceived(message: RemoteMessage) {
        val match = message.data["match"] ?: return // "Raptors v Lashings"
        val score = message.data["score"] ?: return // "154/3 (18.2)"
        getSharedPreferences("widget", MODE_PRIVATE).edit()
            .putString("match", match).putString("score", score).apply()
        CoroutineScope(Dispatchers.IO).launch { CricketWidget().updateAll(applicationContext) }
    }
}

class CricketWidget : GlanceAppWidget() {
    override suspend fun provideGlance(context: Context, id: GlanceId) {
        val prefs = context.getSharedPreferences("widget", Context.MODE_PRIVATE)
        val match = prefs.getString("match", null) ?: "Нет live-матчей"
        val score = prefs.getString("score", null).orEmpty()
        provideContent {
            Column(GlanceModifier.padding(12.dp)) {
                Text(match)
                Text(score, style = TextStyle(fontSize = 22.sp, fontWeight = FontWeight.Bold))
            }
        }
    }
}

В крикете раны меняются почти каждый бросок, поэтому не отправляйте push на каждый ран. Хорошее правило — обновлять виджет не чаще раза в 30–60 секунд, а при потере уикета и в конце иннинга — сразу. Так виджет остаётся живым, а пользователь не получает сотни сообщений за матч. Как устроить сервер рассылки на Firebase, подробно разобрано в статье про мгновенные уведомления о голах — для крикета схема та же.

На iPhone для той же задачи есть Live Activities: карточка матча на экране блокировки, которую сервер обновляет через push от Apple. Обычные виджеты iOS обновляются по расписанию системы и для live подходят хуже.

Виджет счёта крикета для сайта

Если live-счёт нужен не в приложении, а на сайте, есть готовые варианты:

  • Live-трекер. Live 3D Tracker SportAPI поддерживает крикет: визуализация матча в 2D или 3D, счёт и ход игры. Трекер доступен не для каждого live-матча — проверяйте поле zp в ответе.
  • Видеотрансляции. В нашей проверке 24 октября 2026 года видео было у 6 из 7 live-матчей по крикету. Наличие видео показывают поля va и vi, подключение — по документации видеотрансляций.

Ошибки, из-за которых приложение со счётом крикета ломается

  • Запросы к API с телефонов. Ключ становится публичным, а фоновые запросы останавливает система.
  • Футбольный разбор счёта. score_full в крикете — раны, а не голы; уикеты и оверы приходят отдельно.
  • Виджет на updatePeriodMillis. Счёт обновится через полчаса, когда иннинг уже закончится.
  • Push на каждый ран. Сотни сообщений за матч разряжают батарею и раздражают пользователя.
  • Киберматчи вперемешку с настоящими. Пользователь ищет реальный матч сборной, а видит симуляцию.
  • Исходный код, который парсит сайты. Готовые приложения с GitHub часто берут счёт со страниц чужих сайтов — это нарушает их правила и ломается без предупреждения.

Как собрать приложение на данных SportAPI

Для приложения live-счёта по крикету в SportAPI есть:

  • live-матчи крикета одним запросом: раны, уикеты и оверы, иннинг, отбивающая команда;
  • prematch-линия и календарь матчей для экрана расписания;
  • коэффициенты: победитель матча, тоталы, раны в овере, раны игрока — если приложение показывает и их;
  • логотипы команд и турниров по ссылкам CDN;
  • нет месячного лимита запросов, если соблюдать рекомендованные интервалы.

Ограничение: данные передаются по REST, WebSocket в разработке. Поэтому сервер узнаёт о новом ране при очередном опросе — раз в 5–7 секунд.

Сколько стоит

Что нужноСтоимость
Крикет: live и prematch, коэффициенты, краткая live-статистикаот $30 в месяц
Firebase Cloud Messaging для push и обновления виджетабесплатно, по данным Firebase на октябрь 2026
Проверка до оплатыТестовый ключ SportAPI на 2 дня, все виды спорта

Частые вопросы

Есть ли бесплатный API live-счёта крикета для Android?

Бесплатного тарифа у SportAPI нет, но есть тестовый ключ на 2 дня со всеми видами спорта. У бесплатных API обычно есть дневной лимит запросов, а live-счёт нужно обновлять каждые несколько секунд — такого лимита хватает ненадолго.

Можно ли взять готовый исходный код приложения с GitHub?

Можно взять интерфейс, но не источник данных. Многие такие приложения парсят чужие сайты. Код из этой статьи — сервер и экраны на Kotlin — можно использовать как основу, подключив его к официальному API.

Как часто обновляется счёт?

Список live-матчей можно запрашивать раз в 7 секунд, отдельный матч — раз в 5 секунд. На экране приложения этого достаточно, чтобы видеть каждый бросок с небольшой задержкой.

Почему виджет на рабочем столе не обновляется в live?

Android разрешает виджету обновляться по расписанию не чаще раза в 30 минут. Для live нужен push от вашего сервера: приложение получает новые данные и само перерисовывает виджет.

Есть ли в API матчи IPL и сборных?

В линии есть международные матчи сборных и крупные лиги — состав зависит от календаря. Проверьте актуальные турниры через метод menu на тестовом ключе.

Можно ли показать видео матча в приложении?

У многих live-матчей по крикету есть видеотрансляция. Наличие показывают поля va и vi, условия подключения видео уточните у менеджера SportAPI.

Что сделать сегодня

  1. Получите тестовый ключ SportAPI.
  2. Запустите сервер из статьи и посмотрите, какие матчи крикета идут сейчас.
  3. Соберите экран live-матчей на Kotlin.
  4. Подключите Firebase и проверьте обновление виджета на реальном матче.

Напишите менеджеру SportAPI в Telegram, что вы делаете приложение со счётом крикета, — вы получите тестовый ключ к live-данным и линии SportAPI и проверите раны, уикеты и оверы на реальных матчах.

← Все статьи