Obtenir les informations produit des applications et des extensions

  • Article

Cet article explique comment utiliser les méthodes de la classe StoreContext dans l’espace de noms Windows.Services.Store pour accéder aux informations liées au Store pour l’application actuelle ou l’un de ses modules complémentaires.

Pour obtenir un exemple d’application complète, consultez Exemple Windows Store.

Notes

L’espace de noms Windows.Services.Store a été introduit dans Windows 10, version 1607, et il ne peut être utilisé que dans les projets qui ciblent Windows 10 Édition anniversaire (10.0 ; Build 14393) ou une version ultérieure dans Visual Studio. Si votre application cible une version antérieure de Windows 10, vous devez utiliser l’espace de noms Windows.ApplicationModel.Store à la place de l’espace de noms Windows.Services.Store. Pour plus d’informations, consultez cet article.

Prérequis

Les conditions préalables de ces exemples sont les suivantes :

  • Un projet Visual Studio pour une application plateforme Windows universelle (UWP) qui cible Windows 10 édition anniversaire (10.0 ; Build 14393) ou une version ultérieure.
  • Vous avez créé une soumission d’application dans l’Espace partenaires et cette application est publiée dans le Windows Store. Vous pouvez éventuellement configurer l’application afin qu’elle ne soit pas détectable dans le Store pendant que vous la testez. Pour plus d’informations, consultez nos conseils de test.
  • Si vous souhaitez obtenir des informations sur le produit d’un module complémentaire pour l’application, vous devez également créer le module complémentaire dans l’Espace partenaires.

Le code de ces exemples respecte les présupposés suivants :

  • Le code s’exécute dans le contexte d’une Page qui contient un ProgressRing nommé workingProgressRing et un TextBlock nommé textBlock. Ces objets sont utilisés pour respectivement indiquer qu’une opération asynchrone est en cours et afficher les messages de sortie.
  • Le fichier de code contient une instruction using pour l’espace de noms Windows.Services.Store.
  • Cette application mono-utilisateur ne s’exécute que dans le contexte de l’utilisateur qui l’a lancée. Pour plus d’informations, consultez Versions d’évaluation et achats in-app.

Notes

Si vous disposez d’une application de bureau qui utilise le Pont du bureau, vous devrez peut-être ajouter du code supplémentaire qui n’apparaît pas dans ces exemples pour configurer l’objet StoreContext. Pour plus d’informations, voir Utilisation de la classe StoreContext dans une application de bureau qui utilise Desktop Bridge.

Obtenir les informations de l’application en cours

Pour obtenir des informations du Windows Store concernant l’application actuelle, utilisez la méthode GetStoreProductForCurrentAppAsync. Cette méthode asynchrone renvoie un objet StoreProduct que vous pouvez utiliser pour obtenir des informations telles que le prix.

private StoreContext context = null;

public async void GetAppInfo()
{
    if (context == null)
    {
        context = StoreContext.GetDefault();
        // If your app is a desktop app that uses the Desktop Bridge, you
        // may need additional code to configure the StoreContext object.
        // For more info, see https://aka.ms/storecontext-for-desktop.
    }

    // Get app store product details. Because this might take several moments,   
    // display a ProgressRing during the operation.
    workingProgressRing.IsActive = true;
    StoreProductResult queryResult = await context.GetStoreProductForCurrentAppAsync();
    workingProgressRing.IsActive = false;

    if (queryResult.Product == null)
    {
        // The Store catalog returned an unexpected result.
        textBlock.Text = "Something went wrong, and the product was not returned.";

        // Show additional error info if it is available.
        if (queryResult.ExtendedError != null)
        {
            textBlock.Text += $"\nExtendedError: {queryResult.ExtendedError.Message}";
        }

        return;
    }

    // Display the price of the app.
    textBlock.Text = $"The price of this app is: {queryResult.Product.Price.FormattedBasePrice}";
}

Obtenir des informations sur les modules complémentaires avec des ID du Store connus associés à l’application actuelle

Pour obtenir des informations sur les produits du Store pour les modules complémentaires associés à l’application actuelle et pour lesquels vous connaissez déjà les ID du Store, utilisez la méthode GetStoreProductsAsync . Cette méthode asynchrone renvoie un ensemble d’objets StoreProduct qui représentent chaque module complémentaire. Outre les ID Windows Store, vous devez transmettre à cette méthode une liste de chaînes qui identifient les types de modules complémentaires. Pour obtenir la liste des valeurs de chaîne prises en charge, consultez la propriété ProductKind.

Notes

La méthode GetStoreProductsAsync retourne les informations de produit pour les modules complémentaires spécifiés qui sont associés à l’application, que les modules complémentaires soient actuellement disponibles ou non. Pour récupérer des informations pour tous les modules complémentaires de l’application actuelle qui peuvent être achetés, utilisez plutôt la méthode GetAssociatedStoreProductsAsync , comme décrit dans la section suivante .

Cet exemple récupère des informations pour les modules complémentaires durables avec les ID du Store spécifiés qui sont associés à l’application actuelle.

private StoreContext context = null;

public async void GetProductInfo()
{
    if (context == null)
    {
        context = StoreContext.GetDefault();
        // If your app is a desktop app that uses the Desktop Bridge, you
        // may need additional code to configure the StoreContext object.
        // For more info, see https://aka.ms/storecontext-for-desktop.
    }

    // Specify the kinds of add-ons to retrieve.
    string[] productKinds = { "Durable" };
    List<String> filterList = new List<string>(productKinds);

    // Specify the Store IDs of the products to retrieve.
    string[] storeIds = new string[] { "9NBLGGH4TNMP", "9NBLGGH4TNMN" };

    workingProgressRing.IsActive = true;
    StoreProductQueryResult queryResult =
        await context.GetStoreProductsAsync(filterList, storeIds);
    workingProgressRing.IsActive = false;

    if (queryResult.ExtendedError != null)
    {
        // The user may be offline or there might be some other server failure.
        textBlock.Text = $"ExtendedError: {queryResult.ExtendedError.Message}";
        return;
    }

    foreach (KeyValuePair<string, StoreProduct> item in queryResult.Products)
    {
        // Access the Store info for the product.
        StoreProduct product = item.Value;

        // Use members of the product object to access info for the product...
    }
}

Obtenir des informations sur les modules complémentaires disponibles à l’achat à partir de l’application actuelle

Pour obtenir des informations sur les produits du Store pour les modules complémentaires actuellement disponibles à l’achat à partir de l’application actuelle, utilisez la méthode GetAssociatedStoreProductsAsync . Cette méthode asynchrone renvoie un ensemble d’objets StoreProduct qui représentent chaque module complémentaire disponible. Vous devez transmettre à cette méthode une liste de chaînes qui identifient les types de modules complémentaires que vous souhaitez récupérer. Pour obtenir la liste des valeurs de chaîne prises en charge, consultez la propriété ProductKind.

Notes

Si l’application a de nombreux modules complémentaires disponibles à l’achat, vous pouvez également utiliser la méthode GetAssociatedStoreProductsWithPagingAsync pour utiliser la pagination pour retourner les résultats du module complémentaire.

L’exemple suivant récupère les informations de tous les modules complémentaires durables, les modules complémentaires consommables gérés par le Store et les modules complémentaires consommables gérés par les développeurs qui sont disponibles à l’achat à partir de l’application actuelle.

private StoreContext context = null;

public async void GetAddOnInfo()
{
    if (context == null)
    {
        context = StoreContext.GetDefault();
        // If your app is a desktop app that uses the Desktop Bridge, you
        // may need additional code to configure the StoreContext object.
        // For more info, see https://aka.ms/storecontext-for-desktop.
    }

    // Specify the kinds of add-ons to retrieve.
    string[] productKinds = { "Durable", "Consumable", "UnmanagedConsumable" };
    List<String> filterList = new List<string>(productKinds);

    workingProgressRing.IsActive = true;
    StoreProductQueryResult queryResult = await context.GetAssociatedStoreProductsAsync(filterList);
    workingProgressRing.IsActive = false;

    if (queryResult.ExtendedError != null)
    {
        // The user may be offline or there might be some other server failure.
        textBlock.Text = $"ExtendedError: {queryResult.ExtendedError.Message}";
        return;
    }

    foreach (KeyValuePair<string, StoreProduct> item in queryResult.Products)
    {
        // Access the Store product info for the add-on.
        StoreProduct product = item.Value;

        // Use members of the product object to access listing info for the add-on...
    }
}

Obtenir des informations sur les modules complémentaires pour l’application actuelle que l’utilisateur a achetées

Pour obtenir des informations sur les produits du Store pour les modules complémentaires que l’utilisateur actuel a achetés, utilisez la méthode GetUserCollectionAsync . Cette méthode asynchrone renvoie un ensemble d’objets StoreProduct qui représentent chaque module complémentaire. Vous devez transmettre à cette méthode une liste de chaînes qui identifient les types de modules complémentaires que vous souhaitez récupérer. Pour obtenir la liste des valeurs de chaîne prises en charge, consultez la propriété ProductKind.

Notes

Si l’application a de nombreux modules complémentaires, vous pouvez également utiliser la méthode GetUserCollectionWithPagingAsync pour utiliser la pagination pour retourner les résultats du module complémentaire.

L’exemple suivant récupère des informations pour les modules complémentaires durables avec les ID du Store spécifiés.

private StoreContext context = null;

public async void GetUserCollection()
{
    if (context == null)
    {
        context = StoreContext.GetDefault();
        // If your app is a desktop app that uses the Desktop Bridge, you
        // may need additional code to configure the StoreContext object.
        // For more info, see https://aka.ms/storecontext-for-desktop.
    }

    // Specify the kinds of add-ons to retrieve.
    string[] productKinds = { "Durable" };
    List<String> filterList = new List<string>(productKinds);

    workingProgressRing.IsActive = true;
    StoreProductQueryResult queryResult = await context.GetUserCollectionAsync(filterList);
    workingProgressRing.IsActive = false;

    if (queryResult.ExtendedError != null)
    {
        // The user may be offline or there might be some other server failure.
        textBlock.Text = $"ExtendedError: {queryResult.ExtendedError.Message}";
        return;
    }

    foreach (KeyValuePair<string, StoreProduct> item in queryResult.Products)
    {
        StoreProduct product = item.Value;

        // Use members of the product object to access info for the product...
    }
}