Ottenere info sul prodotto per le app e i componenti aggiuntivi

  • Articolo

Questo articolo illustra come usare i metodi della classe StoreContext nello spazio dei nomi Windows.Services.Store per accedere alle informazioni relative allo Store per l'app corrente o i relativi componenti aggiuntivi.

Per un'applicazione di esempio completa, vedere l'esempio di Store.

Nota

Lo spazio dei nomi Windows.Services.Store è stato introdotto in Windows 10, versione 1607, e può essere usato solo nei progetti destinati a Windows 10 Anniversary Edition (10.0; Build 14393) o versione successiva in Visual Studio. Se l'app è destinata a una versione precedente di Windows 10, è necessario usare lo spazio dei nomi Windows.ApplicationModel.Store anziché Windows.Services.Store. Per altre informazioni, vedi questo articolo.

Prerequisiti

Questi esempi hanno i seguenti prerequisiti:

  • Un progetto Visual Studio per un'app UWP (Universal Windows Platform) destinata a Windows 10 Anniversary Edition (10.0; Build 14393) o versione successiva.
  • Aver creato un invio dell'app nel Centro per i partner e pubblicato l'app nello Store. Facoltativamente, è possibile configurare l'app in modo che non sia rilevabile nello Store durante il test. Per ulteriori informazioni, vedere le linee guida per i test.
  • Se si desidera ottenere informazioni sul prodotto per un componente aggiuntivo per l'app, è anche necessario creare il componente aggiuntivo nel Centro per i partner.

Il codice in questi esempi presuppone quanto segue:

  • Il codice è eseguito nel contesto di un oggetto Page che contiene un oggetto ProgressRing denominato workingProgressRing e un oggetto TextBlock denominato textBlock. Questi oggetti vengono usati per indicare che si sta verificando un'operazione asincrona e per visualizzare rispettivamente i messaggi di output.
  • Il file di codice contiene un'istruzione using per lo spazio dei nomi Windows.Services.Store.
  • L'app è un'app per un singolo utente che viene eseguita solo nel contesto dell'utente che ha avviato l'app. Per ulteriori informazioni, vedere Acquisti in-app e versioni di valutazione.

Nota

Se si ha un'applicazione desktop che usa Desktop Bridge, può essere necessario aggiungere ulteriore codice non illustrato in questi esempi per configurare l'oggetto StoreContext. Per ulteriori informazioni, vedere Uso della classe StoreContext in un'applicazione desktop che usa Desktop Bridge.

Ottenere informazioni per l'app corrente

Per ottenere informazioni sul prodotto dello Store relative all'app corrente, usare il metodo GetStoreProductForCurrentAppAsync. Questo è un metodo asincrono che restituisce un oggetto StoreProduct che è possibile usare per ottenere informazioni quali il prezzo.

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}";
}

Ottenere informazioni per i componenti aggiuntivi con ID dello Store noti associati all'app corrente

Per ottenere informazioni sul prodotto dello Store per componenti aggiuntivi associati all'app corrente e per i quali si conoscono già gli ID dello Store, usare il metodo GetStoreProductsAsync. Questo è un metodo asincrono che restituisce un insieme di oggetti StoreProduct che rappresentano ognuno dei componenti aggiuntivi. Oltre agli ID dello Store, è necessario passare a questo metodo un elenco di stringhe che identificano i tipi dei componenti aggiuntivi. Per un elenco dei valori stringa supportati, vedere la proprietà ProductKind.

Nota

Il metodo GetStoreProductsAsync restituisce informazioni sul prodotto per i componenti aggiuntivi specificati associati all'app, indipendentemente dal fatto che i componenti aggiuntivi siano attualmente disponibili per l'acquisto. Per recuperare informazioni per tutti i componenti aggiuntivi per l'app corrente che è attualmente possibile acquistare, usare invece il metodo GetAssociatedStoreProductsAsync come descritto nella sezione seguente.

Questo esempio recupera informazioni per componenti aggiuntivi durevoli con gli ID dello Store specificati, associati all'app corrente.

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...
    }
}

Ottenere informazioni sui componenti aggiuntivi disponibili per l'acquisto dall'app corrente

Per ottenere informazioni sul prodotto dello Store per i componenti aggiuntivi attualmente disponibili per l'acquisto dall'app corrente, usare il metodo GetAssociatedStoreProductsAsync. Questo è un metodo asincrono che restituisce un insieme di oggetti StoreProduct che rappresentano ognuno dei componenti aggiuntivi disponibili. È necessario passare a questo metodo un elenco di stringhe che identificano i tipi di componenti aggiuntivi che si desidera recuperare. Per un elenco dei valori stringa supportati, vedere la proprietà ProductKind.

Nota

Se l'app include molti componenti aggiuntivi disponibili per l'acquisto, in alternativa è possibile usare il metodo GetAssociatedStoreProductsWithPagingAsync per usare il paging per restituire i risultati del componente aggiuntivo.

L'esempio seguente recupera informazioni per tutti i componenti aggiuntivi durevoli, i componenti aggiuntivi di consumo gestiti dallo Store e i componenti aggiuntivi di consumo gestiti dallo sviluppatore disponibili per l'acquisto dall'app corrente.

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...
    }
}

Ottenere informazioni per i componenti aggiuntivi per l'app corrente acquistati dall'utente

Per ottenere informazioni sul prodotto dello Store per i componenti aggiuntivi acquistati dall'utente corrente, usare il metodo GetUserCollectionAsync . Questo è un metodo asincrono che restituisce un insieme di oggetti StoreProduct che rappresentano ognuno dei componenti aggiuntivi. È necessario passare a questo metodo un elenco di stringhe che identificano i tipi di componenti aggiuntivi che si desidera recuperare. Per un elenco dei valori stringa supportati, vedere la proprietà ProductKind.

Nota

Se l'app include molti componenti aggiuntivi, in alternativa è possibile usare il metodo GetUserCollectionWithPagingAsync per usare il paging per restituire i risultati dei componenti aggiuntivi.

L'esempio seguente recupera informazioni per i componenti aggiuntivi durevoli con gli ID dello Store specificati.

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...
    }
}