Aller au contenu
← Tous les articles
Présentation du projet

Artemis Switch : suivre une image du réseau à l’écran

Écouter en version balado

Suivre une image du réseau jusqu'à l'écran · 2:33 · voix synthétiques, script rédigé avec l’IA

Transcription

Sylvie : Imagine un stream avec un très bon débit, mais qui donne quand même l'impression d'arriver en retard. Les chiffres sont beaux, et tes pouces ne sont pas d'accord. Alors, où est passé le temps ?

Thierry : Celui-là est vicieux. Si tout a l'air rapide, par où commencer ?

Sylvie : C'est la question derrière Artemis Switch, le fork de Moonlight-Switch d'Antoine pour la Nintendo Switch. Il s'intéresse au trajet entre la réception d'une image et son affichage : où cette image a-t-elle attendu ?

Thierry : Donc le PC fait le gros du travail, et la Switch montre le résultat ?

Sylvie : Voilà. Un PC avec Sunshine ou Apollo envoie le jeu via le protocole Moonlight. Sur la Switch, la vidéo est décodée avec FFmpeg et NVDEC, arrive dans une file d'images, puis deko3d, la couche graphique, l'affiche. Tout ce qui suit cette file relève du client, ce qui aide à savoir à qui appartient un accroc.

Thierry : C'est comme une cuisine de resto : les plats sortent, patientent au passe, puis le serveur les amène à table.

Sylvie : Bonne image, et le passe, c'est là que se joue la partie astucieuse. Quand les images s'accumulent, le client choisit lesquelles garder. Il vérifie d'abord l'échéance de la plus ancienne. Une fois l'affichage autorisé, il libère les anciennes et montre la plus récente.

Thierry : Pourquoi la plus ancienne plutôt que la plus récente ?

Sylvie : Si l'échéance suivait toujours la dernière arrivée, elle reculerait sans arrêt : les images entreraient, mais aucune ne serait présentée. En gardant celle de la plus ancienne, l'écran continue d'avancer, et un retard accumulé permet de contourner l'attente.

Thierry : Et comment on sait que ça marche ?

Sylvie : Un module de télémétrie mesure chaque étape : le décodage, l'attente en file, le rendu, la soumission GPU, le débit réel et le temps jusqu'aux premières étapes du stream. Une horloge monotone encadre ces mesures.

Thierry : Au lieu d'un seul chiffre de latence flou, on a une chronologie par image.

Sylvie : Exactement. Le README décrit aussi les modes Fit, Fill et Stretch, un agrandissement de type FSR, RCAS, des profils nommés et des panneaux de diagnostic. On garde le même serveur, la même scène et le même réseau, on change une option à la fois, et on compare l'attente et les intervalles, en portable puis en docké.

Thierry : Une bonne habitude pour n'importe quel pipeline.

Sylvie : Oui : plutôt que de demander si le décodeur est rapide, on demande où chaque image a attendu. L'article complet a le schéma et les liens vers le code.

Bibliothèque d’applications Artemis Switch, tirée du README du dépôt
Table des matières

Un stream peut afficher un bon débit tout en donnant une impression de retard. Artemis Switch est mon fork de Moonlight-Switch pour Nintendo Switch. Je m’intéresse surtout au trajet entre la réception d’une image et son affichage : où cette image a-t-elle attendu ?

1. Bien séparer le client du serveur

Artemis conserve les bases de XITRIX/Moonlight-Switch : interface Borealis, transport Moonlight/GameStream, décodage FFmpeg/NVDEC et rendu deko3d. Sunshine et Apollo restent des serveurs sur le PC. Leur administration passe par leurs propres interfaces.

Un mauvais mode d’écran virtuel relève donc du serveur. Une file d’images décodées qui grossit relève du client. La documentation des intégrations ne signifie pas que toutes les combinaisons ont été validées sur console.

2. Le trajet d’une image

flowchart TD
  H["PC : Sunshine ou Apollo"] --> N["Transport Moonlight / GameStream"]
  N --> D["Décodage FFmpeg / NVDEC"]
  D --> Q["File des images décodées"]
  Q --> S["Échéance et sélection de l’image récente"]
  S --> R["Présentation deko3d"]
  R --> P["Écran de la Switch"]
  T["FramePipelineTelemetry"] -. mesure .-> D
  T -. mesure .-> Q
  T -. mesure .-> R

Ce schéma simplifie le code du client. Il ne représente pas une mesure complète de la latence entre la manette et l’écran.

3. Quand abandonner les anciennes images ?

Dans LowLatencyFrameSelection.hpp[1], la sélection vérifie l’échéance de la plus ancienne image avant de passer à la plus récente. Une fois l’affichage autorisé, elle libère les images anciennes. Un retard accumulé permet aussi de contourner cette attente.

Si l’échéance suivait toujours la dernière arrivée, elle pourrait reculer sans cesse. La file recevrait des images sans jamais en présenter. Cette règle précise explique mieux le travail réalisé qu’une simple promesse de faible latence.

4. Mesurer chaque étape

FramePipelineTelemetry.hpp[2] suit le décodage, l’attente en file, le pipeline client, le rendu, la soumission GPU, le débit réel et le temps jusqu’aux premières étapes du stream. Une horloge monotone et un mutex encadrent ces mesures.

Le pipeline client commence ici après la réception réseau complète. Il ne couvre pas à lui seul l’encodage du PC, tout le réseau, le balayage de l’écran et les commandes.

Le README décrit aussi les modes Fit/Fill/Stretch, l’agrandissement de type FSR, RCAS, les profils nommés et les panneaux de diagnostic. Ce sont des outils pour comparer des compromis, pas une garantie de fréquence d’images.

5. Comparer sur console

Je garderais le même serveur, la même scène, la résolution et le réseau. Ensuite, je changerais une option de cadence à la fois en observant l’attente et les intervalles de présentation. Les modes portable et docké méritent des essais distincts.

Le dépôt distingue les tests portables et les builds des validations sur appareil. Les notes d’installation restent donc la référence avant d’assimiler compilation et expérience de jeu.

6. Sources

Références

  1. antoinebou12. (). LowLatencyFrameSelection.hpp. [Source file or documentation] github.com.
  2. antoinebou12. (). FramePipelineTelemetry.hpp. [Source file or documentation] github.com.
  3. antoinebou12. (). Artemis-Switch. [Software repository] github.com.

Les références utilisent la date de publication de cet article.