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 | |
| 12 | use anyhow::{Context, Result}; |
| 13 | use chl_covers::wikipedia::USER_AGENT; |
| 14 | use serde::{Deserialize, Serialize}; |
| 15 | |
| 16 | /// Категория. Числа — те же, что Valve показывает значком на странице |
| 17 | /// магазина: 3 — зелёная галка, 2 — жёлтый кружок, 1 — красный крест, |
| 18 | /// 0 — вопрос (не проверялось). |
| 19 | #[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)] |
| 20 | pub enum Category { |
| 21 | Unknown, |
| 22 | Unsupported, |
| 23 | Playable, |
| 24 | Verified, |
| 25 | } |
| 26 | |
| 27 | impl 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)] |
| 51 | pub struct Report { |
| 52 | pub category: Category, |
| 53 | } |
| 54 | |
| 55 | #[derive(Deserialize)] |
| 56 | struct Envelope { |
| 57 | success: i32, |
| 58 | results: Option<Results>, |
| 59 | } |
| 60 | |
| 61 | #[derive(Deserialize)] |
| 62 | struct Results { |
| 63 | resolved_category: i64, |
| 64 | } |
| 65 | |
| 66 | /// Спрашивает категорию по `appid`. `Ok(None)` — Steam про такой appid |
| 67 | /// ничего не ответил (снят с продажи, регион, сбой), а не «не проверялось»: |
| 68 | /// это разные вещи, и путать их значит выдавать догадку за факт. |
| 69 | pub 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)] |
| 90 | mod 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 |