Pou's IT Life

[事前準備]

1. 請完成 Dev Center 中 Account 的付費驗證，請參考<Getting paid>填寫必要的資料跟匯款的賬號/銀行
2. 在 Dev Center 建立一個 Project，利用 Visual Studio 將專案與 Project 綁定抓到 publisher 資訊 (Packaging Universal Windows apps for Windows 10)

[注意]

• 每一個上架的 product 都是會被審核的(抽查)，流程可以參考<defining its product type and product ID>或<Add-on submissions>
• 如果退費怎辦？可以參考<Microsoft Returns / Refunds>

App 要提供 in-app purchase 與 trial functionality 的話，有些功能會基於 Windows 10 的版本。 不同的 Windows 10 使用不同的 namespaces 將 in-app 購買和試用功能加入 app：

• Windows.Serivce.Store 如果 App 目標版本是 Win10 1607 (14393) 以上建議使用它開發 in-app 與 trials 功能。 支援最新 add-on types 管理與 Windows Dev Center 或 Store 的整合。
• Windows.ApplicationModel.Store 所有的 Win10 都支援這個舊的 APIs，不過該 namespace 不會再更新支援最新的產品類型。

Windows.Service.Store 重要的元素：

• StoreContext 可用它取得 app 相關資訊，例如：可用的 app-ons, license, 等，與該 user 在目前 app 已經購買的項目等其他功能。

如果 App 衹能有一個用戶使用(大部分的 App 都是的單一用戶使用)可以使用下面的指令連結到用戶在 Store 上的資料(GetDefault())：

Windows.Services.Store.StoreContext context = StoreContext.GetDefault();

如果 App 允許多個用戶登入使用(multi-user app)，要改用：GetForUser() 搭配指定的用戶 Index 來取得。

var users = await Windows.System.User.FindAllAsync();
Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);

拿到 StoreContext 之後就可以往下操作需要的任務。 1. 在 Dev Center 建立 add-ons 的產品：(使用單一用戶爲例)

分別建立 耐久性 與 由市集管理的消耗性項目。詳細的填寫資料可以參考<Add-on submissions>。 建立完成之後 (需要等待 add-ons 的審核通常衹要 1 小時内就會通過)，利用 Visual studio 中的 Associate App with Store 把專案綁定，才能使用相同的 App Id 拿到該 App 下有建立的 add-ons。 2. 抓出系統裏面可使用的用戶，挑選要抓去那個用戶在這個 App 已購買或可以購買的内容：

public async Task Initialize()
{
     // 抓取用戶，并用 UserDataWrapper 包裝起來給 ComboxControl 使用
     var users = await Windows.System.User.FindAllAsync();

     int i = 1;
     foreach (var item in users)
     {
         this.Users.Add(new UserDataWrapper(item, $"user{i}"));
         i++;
     }
}

public class UserDataWrapper
{
     public User Self { get; private set; }

     public string Id { get; private set; }

     public UserDataWrapper(User user, string id)
     {
         Self = user;
         Id = id;
     }
}

3. 利用 StoreContext 查詢可以購買的產品： 利用 GetAssociatedStoreProductsAsync 取得該 App 可使用的所有 add-ons 資訊 (StoreProduct)。 如果有很多 add-ons 的内容可以改用 GetAssociatedStoreProductsWithPagingAsync 取得，另外產品類型多樣可以藉由 ProductKind 加以分類。

public async Task GetProducts(object sender, RoutedEventArgs e)
{
      /*
       *  ProductKind:
       *    Application,
       *    Game,
       *    Consumable, (Store-managed)
       *    UnmanagedConsumable, (Developer-managed)
       *    Durable
      */

      string[] filter = new string[] { "Durable", "Consumable" };
      var products = await storeContext.GetAssociatedStoreProductsAsync(filter);

      if (products.ExtendedError != null)
      {
          Errored?.Invoke(this, products.ExtendedError);
          return;
      }

      Products.Clear();

      foreach (var item in products.Products)
      {
           Products.Add(new StoreProductDataWrapper(item.Key, item.Value));
      }
}

爲了在 ListView 可呈現利用 StoreProductDataWrapper 包裝起來。 3. 查詢目前 App 的授權與 add-ons 已經購買的項目： 利用 GetUserCollectionAsync 查詢用戶已經購買且可以使用的項目。如果資料太多可以搭配 GetUserCollectionWithPagingAsync 使用。

public async Task GetPurchasedProducts(object sender, RoutedEventArgs e)
{
      // 抓取已經購買的項目
      var purchased = await storeContext.GetUserCollectionAsync(GetProductKinds());

      if (purchased.ExtendedError != null)
      {
           Errored?.Invoke(this, purchased.ExtendedError);
           return;
      }

      if (purchased.Products == null || purchased.Products.Count == 0)
      {
           Message = "Not purchased any product";
           return;
      }

      PurchasedProducts.Clear();
            
      foreach (var item in purchased.Products)
      {
           PurchasedProducts.Add(new StoreProductDataWrapper(item.Key, item.Value));
      }
}

如果沒有買過任何 add-ons 的 products 會抓不到内容。可以配合下一步購買產品，不過要記得設定是 free 的避免付費。 4. 購買產品： 利用步驟 2 可以抓出可以購買的產品 (StoreProduct)，利用 RequestPurchaseAsync()。訂購結果裏面會有 StorePurchaseStatus 確定是否購買成功。呼叫 RequestPurchaseAsync() 要在 UI thread 使用，避免發生錯誤 (0x800706be: This value corresponds to the RPC_S_CALL_FAILED error code)。

public async void PurchaseProduct(object sender, RoutedEventArgs e)
{
      var dataWrapper = listView.SelectedItem;

      if (dataWrapper != null && dataWrapper.Product != null)
      {
         // 購買產品
         var product = dataWrapper.Product;
         if (product.IsInUserCollection == false)
         {
              var result = await product.RequestPurchaseAsync();

              if (result.ExtendedError != null)
              {
                  Errored?.Invoke(this, result.ExtendedError);
                  return;
              }

              switch (result.Status) 
              {
                  case StorePurchaseStatus.Succeeded:
                       // purchase successed
                       break;
                  case StorePurchaseStatus.AlreadyPurchased:
                       break;
                  case StorePurchaseStatus.NetworkError:
                  case StorePurchaseStatus.NotPurchased:
                  case StorePurchaseStatus.ServerError:
                       break;
              }
         }
     }
}

如果您知道 StoreId 的話，也可以利用 StoreContext 進行購買，如下：

StorePurchaseResult result = await context.RequestPurchaseAsync(storeId);

5. 購買消費性產品 使用的 Store-managed consumable 會比較方便，在 Dev Center 設定時就需要設定每次購買給予到少額度，App 利用 GetConsumableBalanceRemainingAsync 取得可用的額度，在 App 使用之後再透過 ReportConsumableFulfillmentAsync 告訴 Store 用了多少額度。直到用完額度，用戶才可以再次購買。

// 利用 GetConsumableBalanceRemainingAsync 取得可以用的額度
string addOnStoreId = "9p4rrvhmg63x";
StoreConsumableResult result = await context.GetConsumableBalanceRemainingAsync(addOnStoreId);

相反地，如果使用 Developer-managed consumable 就需要在向 StoreContext 或 StoreProduct 訂購成功後,自己管理可用的 quantity， 等到該用戶使用完畢所有的 quantity 時，藉由 ReportConsumableFulfillmentAsync() 通知 Store 已經消費完畢，這樣用戶才能再購買下一次。

// addOnStoreId: 代表產品的 StoreId
// quantity: 如果是 developer-managed consumable , 給 1 就好。
// trackingId: 用來代表交易，可直接使用 GUID 
uint quantity = 1;
string addOnStoreId = "9p4rrvhmg63x";
Guid trackingId = Guid.NewGuid();
    
StoreConsumableResult result = await context.ReportConsumableFulfillmentAsync(addOnStoreId, quantity, trackingId);

更多消費性產品的購買可以參考 Enable consumable add-on purchases。 [重要元素]

• StoreContext

• StoreAppLicense

• StoreLicense

• StoreProduct