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

Приложение 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 останавливает фоновые запросы, чтобы беречь батарею. Поэтому схема такая:
- Сервер раз в 7 секунд запрашивает все live-матчи крикета одним запросом
events. - Сервер приводит ответ к простому формату — счёт, уикеты, оверы, иннинг — и отдаёт его приложению.
- Когда счёт любимой команды меняется, сервер отправляет 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.
Что сделать сегодня
- Получите тестовый ключ SportAPI.
- Запустите сервер из статьи и посмотрите, какие матчи крикета идут сейчас.
- Соберите экран live-матчей на Kotlin.
- Подключите Firebase и проверьте обновление виджета на реальном матче.
Напишите менеджеру SportAPI в Telegram, что вы делаете приложение со счётом крикета, — вы получите тестовый ключ к live-данным и линии SportAPI и проверите раны, уикеты и оверы на реальных матчах.