> ## Documentation Index > Fetch the complete documentation index at: https://www.mellowtel.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Intégrer Mellowtel dans votre application de bureau Windows Intégrez Mellowtel dans votre application de bureau Windows pour permettre aux utilisateurs de partager leur bande passante internet inutilisée en échange de récompenses ou de fonctionnalités premium. **Le consentement de l'utilisateur est obligatoire.** Le SDK lance une `InvalidOperationException` si vous appelez `StartAsync()` sans que l'utilisateur ait opté pour. ## Prérequis * Un compte Mellowtel et un **ID d'intégration** depuis le [tableau de bord](https://www.mellowtel.com/mellowtel-auth/). Chaque application de bureau obtient son propre ID d'intégration unique. * SDK .NET 10 * Windows 10 ou Windows 11 * Une application de bureau .NET (Console, WPF, ou Windows Forms) Vous souhaitez voir une intégration complète et réelle avant de l'intégrer dans votre propre application ? L'exemple WPF [mellowtel-pomodoro-windows](https://github.com/mellowtel-inc/mellowtel-pomodoro-windows) montre le flux complet de bout en bout : dialogue de consentement, bascule des paramètres, et cycle de vie en arrière-plan. *** ## Installation Mellowtel pour Windows est disponible sur NuGet sous le nom [`Mellowtel.Win`](https://www.nuget.org/packages/Mellowtel.Win). ### 1. Installer le package Depuis votre répertoire de projet : ```bash theme={null} dotnet add package Mellowtel.Win ``` Ou ajoutez une `PackageReference` à votre `.csproj` : ```xml theme={null} ``` ### 2. Ajouter à votre code ```csharp theme={null} using MellowtelWin; // Initialiser Mellowtel avec votre ID d'intégration var mellowtel = new Mellowtel("YOUR_INTEGRATION_ID", new MellowtelOptions { PluginId = "your-app-id" }); // Si l'utilisateur a déjà opté pour, reprendre silencieusement. // Sinon, c'est une opération nulle et retourne false. await mellowtel.StartIfOptedInAsync(); // Flux pour la première fois : affichez votre interface de consentement, puis optez pour et démarrez. if (!mellowtel.GetOptInStatus() && ShowConsentDialog()) { mellowtel.OptIn(); await mellowtel.StartAsync(); } // À la fermeture de l'application await mellowtel.StopAsync(); mellowtel.Dispose(); ``` Remplacez `YOUR_INTEGRATION_ID` par l'ID d'intégration de votre tableau de bord Mellowtel, et définissez `PluginId` sur un identifiant stable pour votre application. `ShowConsentDialog()` est votre propre interface utilisateur qui retourne `true` uniquement lorsque l'utilisateur accepte explicitement. Voir [Consentement de l'utilisateur](#user-consent) ci-dessous. ### Options de configuration `MellowtelOptions` vous permet de régler quelques paramètres : | Propriété | Type | Défaut | Description | | -------------- | -------- | -------------------------- | ------------------------------------------------------------------------------------ | | `PluginId` | `string` | `"mellowtel-win"` | Identifiant stable pour votre application. Définissez-le sur quelque chose d'unique. | | `MaxDailyRate` | `int` | Valeur par défaut intégrée | Nombre maximal de requêtes que le SDK traitera par jour. | | `DisableLogs` | `bool` | `true` | Définissez sur `false` pour activer les journaux du SDK pendant le développement. | *** ## Exemples par type d'application ```csharp theme={null} using MellowtelWin; class Program { static async Task Main(string[] args) { using var mellowtel = new Mellowtel("YOUR_INTEGRATION_ID", new MellowtelOptions { PluginId = "your-app-id" }); if (!mellowtel.GetOptInStatus()) { Console.WriteLine("L'utilisateur doit opter pour avant d'utiliser ce service."); return; } using var cts = new CancellationTokenSource(); Console.CancelKeyPress += (s, e) => { e.Cancel = true; cts.Cancel(); }; try { await mellowtel.StartAsync(cts.Token); Console.WriteLine("Mellowtel en cours d'exécution. Appuyez sur Ctrl+C pour arrêter."); await Task.Delay(Timeout.Infinite, cts.Token); } catch (InvalidOperationException ex) { Console.WriteLine($"Impossible de démarrer : {ex.Message}"); } catch (OperationCanceledException) { Console.WriteLine("Arrêt..."); } finally { await mellowtel.StopAsync(); } } } ``` Ajoutez à votre `MainWindow.xaml.cs` : ```csharp theme={null} using MellowtelWin; using System.Windows; public partial class MainWindow : Window { private Mellowtel? _mellowtel; public MainWindow() { InitializeComponent(); Loaded += Window_Loaded; } private async void Window_Loaded(object sender, RoutedEventArgs e) { _mellowtel = new Mellowtel("YOUR_INTEGRATION_ID", new MellowtelOptions { PluginId = "your-app-id" }); _mellowtel.ConnectionStateChanged += (s, connected) => { Dispatcher.Invoke(() => { StatusTextBlock.Text = connected ? "Connecté" : "Déconnecté"; }); }; // Reprendre silencieusement si déjà opté pour. Sinon, affichez votre interface de consentement. var started = await _mellowtel.StartIfOptedInAsync(); if (!started) { // Affichez votre dialogue de consentement ici } } protected override async void OnClosing(CancelEventArgs e) { if (_mellowtel != null) { await _mellowtel.StopAsync(); _mellowtel.Dispose(); } base.OnClosing(e); } } ``` Ajoutez à votre `MainForm.cs` : ```csharp theme={null} using MellowtelWin; public partial class MainForm : Form { private Mellowtel? _mellowtel; public MainForm() { InitializeComponent(); Load += MainForm_Load; FormClosing += MainForm_FormClosing; } private async void MainForm_Load(object sender, EventArgs e) { _mellowtel = new Mellowtel("YOUR_INTEGRATION_ID", new MellowtelOptions { PluginId = "your-app-id" }); _mellowtel.ConnectionStateChanged += (s, connected) => { if (InvokeRequired) Invoke(() => statusLabel.Text = connected ? "Connecté" : "Déconnecté"); else statusLabel.Text = connected ? "Connecté" : "Déconnecté"; }; // Reprendre silencieusement si déjà opté pour. Sinon, affichez votre interface de consentement. var started = await _mellowtel.StartIfOptedInAsync(); if (!started) { // Affichez votre dialogue de consentement ici } } private async void MainForm_FormClosing(object sender, FormClosingEventArgs e) { if (_mellowtel != null) { await _mellowtel.StopAsync(); _mellowtel.Dispose(); } } } ``` ### Observer l'état de la connexion L'instance `Mellowtel` expose un événement `ConnectionStateChanged` qui se déclenche chaque fois que le WebSocket sous-jacent vers le backend de Mellowtel se connecte ou se déconnecte. Les exemples WPF et Windows Forms ci-dessus s'y abonnent pour piloter un indicateur de statut. La charge utile est un `bool` où `true` signifie connecté et `false` signifie déconnecté. L'événement se déclenche sur un thread d'arrière-plan, donc les frameworks d'interface utilisateur qui appliquent l'affinité de thread doivent transférer les mises à jour sur le thread de l'interface utilisateur. Dans WPF, utilisez `Dispatcher.Invoke`, et dans Windows Forms, utilisez `Control.Invoke` (les deux sont montrés dans les exemples ci-dessus). **À propos du modèle `async void OnClosing` de WPF.** L'exemple WPF ci-dessus utilise `protected override async void OnClosing`, qui est la forme la plus simple mais présente un problème subtil : `base.OnClosing(e)` est appelé de manière synchrone pendant que `StopAsync()` est toujours en attente, donc la fenêtre peut se fermer avant que le nettoyage ne soit terminé. Pour la plupart des applications, cela est acceptable car le processus se termine immédiatement après. Si vous avez besoin d'une fermeture en douceur garantie (par exemple, pour vider la télémétrie), suivez le [modèle de report documenté par Microsoft](https://learn.microsoft.com/en-us/dotnet/api/system.windows.window.closing) où vous définissez `e.Cancel = true`, `await` votre travail asynchrone, puis fermez la fenêtre explicitement. *** ## Consentement de l'utilisateur L'affichage d'un dialogue de consentement est **obligatoire**. Le SDK l'impose : `StartAsync()` lance une `InvalidOperationException` si l'utilisateur n'a pas opté pour. ```csharp theme={null} var mellowtel = new Mellowtel("YOUR_INTEGRATION_ID", new MellowtelOptions { PluginId = "your-app-id" }); if (!mellowtel.GetOptInStatus()) { var userAgreed = ShowConsentDialog(); // votre dialogue personnalisé if (userAgreed) mellowtel.OptIn(); else return; // l'utilisateur a refusé, ne pas démarrer } try { await mellowtel.StartAsync(); } catch (InvalidOperationException ex) { Console.WriteLine($"Erreur : {ex.Message}"); } ``` ### Ce que votre dialogue de consentement doit inclure Utilisez un langage simple. Exemple : *"Cette application utilise Mellowtel pour partager votre bande passante internet inutilisée. Cela vous permet de \[bénéfice/fonctionnalité]. Vous pouvez vous désinscrire à tout moment dans les paramètres."* Incluez des options distinctes pour Accepter et Refuser. Incluez des liens vers les [Conditions d'utilisation](https://www.mellowtel.com/terms-and-conditions) et la [Politique de confidentialité](https://www.mellowtel.com/privacy-policy). ### Permettre aux utilisateurs de modifier leur consentement dans les paramètres ```csharp theme={null} // Vérifiez le statut actuel bool isOptedIn = mellowtel.GetOptInStatus(); // Se désinscrire if (userWantsToOptOut) { mellowtel.OptOut(); await mellowtel.StopAsync(); } // Se réinscrire if (userWantsToOptIn) { mellowtel.OptIn(); await mellowtel.StartAsync(); } ``` Pour une interface utilisateur plus riche (par exemple, afficher quand l'utilisateur a d'abord opté pour), `GetOptInDetails()` retourne le statut d'opt-in ainsi que les horodatages d'opt-in et d'opt-out : ```csharp theme={null} var (isOptedIn, optInDate, optOutDate) = mellowtel.GetOptInDetails(); ``` *** ## Dépannage 1. Assurez-vous que votre projet cible **.NET 10** ou une version ultérieure. `Mellowtel.Win` nécessite `net10.0`. 2. Videz le cache NuGet et restaurez : ```bash theme={null} dotnet nuget locals all --clear dotnet restore ``` `StartAsync()` nécessite un consentement explicite. Appelez `OptIn()` après que votre dialogue de consentement retourne un résultat positif, puis appelez `StartAsync()`. Pour une reprise silencieuse lors des lancements suivants, utilisez `StartIfOptedInAsync()` à la place, ce qui est une opération nulle lorsque l'utilisateur n'a pas opté pour. *** Temps estimé pour terminer : 10-15 minutes. Si vous avez besoin d'aide ou souhaitez nous faire part de vos commentaires, contactez-nous à [info@mellowtel.com](mailto:info@mellowtel.com) ou rejoignez notre [communauté Discord](https://discord.com/invite/txAZp4MSDe).