Project Chimera
Меню

Исходники

118 строк · 6 КиБ

code/crates/chl-kb/src/steamdeck.rs

1//! Категория совместимости со Steam Deck — вердикт самого Valve.
2//!
3//! Тот же довод, что у [`crate::protondb`] и [`crate::anticheat`]: источник
4//! английский (это внутренний, недокументированный эндпоинт самого магазина
5//! Steam), но отдаёт одно из четырёх известных чисел ([`Category`]) —
6//! переводится без остатка, у русской альтернативы вердикту самого Valve
7//! взяться неоткуда.
8//!
9//! Эндпоинт не задокументирован официально, но им пользуется сама страница
10//! магазина при показе значка совместимости, ключа не спрашивает.
11
12use anyhow::{Context, Result};
13use chl_covers::wikipedia::USER_AGENT;
14use serde::{Deserialize, Serialize};
15
16/// Категория. Числа — те же, что Valve показывает значком на странице
17/// магазина: 3 — зелёная галка, 2 — жёлтый кружок, 1 — красный крест,
18/// 0 — вопрос (не проверялось).
19#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
20pub enum Category {
21 Unknown,
22 Unsupported,
23 Playable,
24 Verified,
25}
26
27impl Category {
28 fn from_wire(raw: i64) -> Self {
29 match raw {
30 3 => Category::Verified,
31 2 => Category::Playable,
32 1 => Category::Unsupported,
33 // 0 и всё, чего Valve ещё не заводил — то же «не проверялось»,
34 // что и настоящий 0: показывать разницу между «неизвестно» и
35 // «неизвестное будущее число» игроку не за чем.
36 _ => Category::Unknown,
37 }
38 }
39
40 pub fn title_ru(&self) -> &'static str {
41 match self {
42 Category::Verified => "проверено (Verified) — полностью готово для Steam Deck",
43 Category::Playable => "играбельно (Playable) — идёт, но не без оговорок",
44 Category::Unsupported => "не поддерживается (Unsupported)",
45 Category::Unknown => "не проверялось Valve",
46 }
47 }
48}
49
50#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
51pub struct Report {
52 pub category: Category,
53}
54
55#[derive(Deserialize)]
56struct Envelope {
57 success: i32,
58 results: Option<Results>,
59}
60
61#[derive(Deserialize)]
62struct Results {
63 resolved_category: i64,
64}
65
66/// Спрашивает категорию по `appid`. `Ok(None)` — Steam про такой appid
67/// ничего не ответил (снят с продажи, регион, сбой), а не «не проверялось»:
68/// это разные вещи, и путать их значит выдавать догадку за факт.
69pub fn fetch(appid: u32) -> Result<Option<Report>> {
70 let url = format!(
71 "https://store.steampowered.com/saleaction/ajaxgetdeckappcompatibilityreport?nAppID={appid}&cc=us&l=english"
72 );
73 let mut response = ureq::Agent::config_builder()
74 .timeout_global(Some(std::time::Duration::from_secs(10)))
75 .build()
76 .new_agent()
77 .get(&url)
78 .header("User-Agent", USER_AGENT)
79 .call()
80 .context("не удалось обратиться к Steam")?;
81 let text = response.body_mut().read_to_string().context("обрыв ответа Steam")?;
82 let envelope: Envelope = serde_json::from_str(&text).context("ответ Steam не разбирается")?;
83 if envelope.success != 1 {
84 return Ok(None);
85 }
86 Ok(envelope.results.map(|r| Report { category: Category::from_wire(r.resolved_category) }))
87}
88
89#[cfg(test)]
90mod tests {
91 use super::*;
92
93 #[test]
94 fn известные_числа_разбираются_а_незнакомое_уходит_в_неизвестно() {
95 assert_eq!(Category::from_wire(3), Category::Verified);
96 assert_eq!(Category::from_wire(2), Category::Playable);
97 assert_eq!(Category::from_wire(1), Category::Unsupported);
98 assert_eq!(Category::from_wire(0), Category::Unknown);
99 assert_eq!(Category::from_wire(99), Category::Unknown);
100 }
101
102 #[test]
103 fn у_каждой_категории_есть_русское_название() {
104 for c in [Category::Unknown, Category::Unsupported, Category::Playable, Category::Verified] {
105 assert!(!c.title_ru().is_empty());
106 }
107 }
108
109 /// Живой прогон — пропускается по умолчанию, требует сеть. Baldur's
110 /// Gate 3 (1086940) числится Verified с релиза.
111 #[test]
112 #[ignore]
113 fn живой_прогон_против_настоящего_steam() {
114 let report = fetch(1_086_940).expect("запрос не должен упасть").expect("у BG3 есть вердикт");
115 assert_eq!(report.category, Category::Verified);
116 }
117}
118