Windows Phone 8 Wallet 手机钱包 / 电子钱包

手机钱包是windows phone 8中的新特性之一，在这里先给大家声明一下 因为有很多合作伙伴对钱包功能有一个“误解” - 钱包功能不开放 只能做支付其实不然， 目前来说手机钱包主要分为几个功能点 ，卡片管理 \ 支付功能 \ NFC进场通信通讯交易

其中 NFC 近场通讯交易 - security payment 是依赖于运用商的在这里不做过多介绍，手机钱包 支付功能 目标国内支持 ailpay (支付宝) 可以进行 应用购买以及应用内支付，这在我们的SDK中都是相应API 这部分内容我会放到 应用内支付(购买)一节中给大家介绍，今天我着重介绍卡片管理功能，卡片管理主要分为 银行卡（信用卡/储蓄卡）、会员卡、以及优惠劵的管理下面我会逐一介绍：

windows phone wallet (电子钱包) 可以为你的应用提供一个全新的用户信息展示平台展示，并且这个平台更加的自然贴近用户的使用习惯，在细节上讨好用户，在wallet中可以展示带有图logo片及连接的卡片项，你可以为这些卡片选择deep link到应用中 并且可以使用后台的 wallet agent 进行数据同步。

此文是 升级到WP8必需知道的13个特性 系列的一个更新 希望这个系列可以给 Windows Phone 8开发者带来一些开发上的便利。

同时欢迎大家在这里和我沟通交流或者在新浪微博上 @王博_Nick

1. 声明权限

和其他新特性一样 wallet 也需要在Manifest中声明 我这里是因为后面要进行应用内支付的 code 所以在选择了 wallet 的基础上又选择了 payment in struments

2.银行卡

银行卡分为信用卡和借记卡

在创建的时候有以下几种选择标记

在对 WalletItem进行操作时候首先是要介绍 AddWalletItemTask 对象，使用他进行卡片的添加操作在Completed 的时候进行判断操作是否成功。

 // Constructor
        public MainPage()
        {
            InitializeComponent();

            AWIT.Completed += AWIT_Completed;
        }

        static AddWalletItemTask AWIT = new AddWalletItemTask();

        void AWIT_Completed(object sender, AddWalletItemResult e)
        {
            if (e.TaskResult == TaskResult.OK)
            {
                MessageBox.Show(e.Item.DisplayName + " operation successful.");
            }
            else
            {
                MessageBox.Show(e.Item.DisplayName + " Error: " + e.Error.Message);
            }
        }

每一张卡片对应一个 PaymentInstrument 对象其中包含各种信息包括 deeplink 的URL 图片Logo

                PaymentInstrument PI;
                PI = new PaymentInstrument("Contoso Credit Account");
                PI.PaymentInstrumentKinds = PaymentInstrumentKinds.Credit;
                PI.IssuerName = publisher.Name;
                PI.DisplayName = publisher.Name + " Payment Card";
                PI.IssuerPhone.Business = publisher.TelNo;
                PI.CustomerName = member.Name;
                PI.AccountNumber = member.MembershipNumber;
                PI.BillingPhone = member.TelNo;
                PI.IssuerWebsite = new Uri(publisher.WebSite);
                PI.ExpirationDate = member.ExpirationDate;
                PI.NavigationUri = new Uri("/mainpage.xaml?ParameterName=[ParameterValue] for wallet to app communication.", UriKind.Relative);

                PI.DisplayCreditLimit = member.CreditLimit.ToString();
                PI.DisplayAvailableCredit = member.AvailableLimit.ToString();

                PI.Logo99x99 = GetBitmapSource("Assets/wallet_99x99.png");
                PI.Logo159x159 = GetBitmapSource("Assets/wallet_159x159.png");
                PI.Logo336x336 = GetBitmapSource("Assets/wallet_336x336.png");
                                                
                AWIT.Item = PI;
                AWIT.Show();

上面可以看到设置了三种不同大小的Logo 是因为会在不同的地方使用到 例如当你的卡片pin到主屏的时候

既然是消费类型的卡就有消费记录的存在 在我们的钱包中自然就有交易记录

添加一条记录的方法如下，这里提一下 wallet 也是独立应用的 使用Wallet的时候 找卡仅限于当前应用是不允许找其他应用的卡片信息的 原因大家都懂的，当然也可以使用 WalletAgent 进行实时更新。

Random RandomPayment = new Random();

        async private void btnCreatePaymentTrans_Tap(object sender, System.Windows.Input.GestureEventArgs e)
        {
            // Find the payment instrument to use 
            PaymentInstrument PI;

            PI = Wallet.FindItem("Contoso Credit Account") as PaymentInstrument;

            if (PI == null)
            {
                MessageBox.Show("Payment Card [Credit Account] not found on the wallet.");
                return;
            }

            // Create the transaction
            WalletTransaction transaction = new WalletTransaction();

            transaction.DisplayAmount = RandomPayment.Next(50, 500).ToString();

            transaction.Description = "Random online payment";
            transaction.TransactionDate = DateTime.Now;

            // Add the transaction to the wallet
            PI.TransactionHistory.Add("Internet payment " + DateTime.Now, transaction);

            await PI.SaveAsync();

            MessageBox.Show("Succesfully made a random payment. Check your wallet to see the transactions.");
        }

3.会员卡

这里的会员卡和支付卡十分相似只不过是使用的对象是 WalletTransactionItem 

                WalletTransactionItem wtiMember;
                wtiMember = new WalletTransactionItem("CoffeeContosoMembershipCard");
                wtiMember.IssuerName = publisher.Name;
                wtiMember.DisplayName = publisher.Name + " Membership Card.";
                wtiMember.IssuerPhone.Business = publisher.TelNo;
                wtiMember.CustomerName = member.Name;
                wtiMember.AccountNumber = member.MembershipNumber;
                wtiMember.BillingPhone = member.TelNo;
                wtiMember.IssuerWebsite = new Uri(publisher.WebSite);
                wtiMember.DisplayAvailableBalance = "1000 Cont Lira";
                wtiMember.NavigationUri = new Uri("/mainpage.xaml?ParameterName=[ParameterValue] for wallet to app communication.", UriKind.Relative);

                wtiMember.Logo99x99 = GetBitmapSource("Assets/wallet_99x99.png");
                wtiMember.Logo159x159 = GetBitmapSource("Assets/wallet_159x159.png");
                wtiMember.Logo336x336 = GetBitmapSource("Assets/wallet_336x336.png");
                wtiMember.BarcodeImage = GetBitmapSource("Assets/wallet_barcode.png");

                AWIT.Item = wtiMember;
                AWIT.Show();

上图包含了左侧的deeplink中可以看到一些事实信息的现实 例如这个客户关怀 生日快乐就是借助 wallet agent 手机钱包 代理 实现的，下面我介绍下如何实现这样一个代理 WalletAgent

4.后台代理 WalletAgent 

walletAgent依赖于系统的调用级别上每次打开钱包的时候都会同步一次，添加一个这样的agent 目前wp开模板中没有这个选项 我们就直接添加一个 Windows Phone Class Library 即可然后使用

Microsoft.Phone.Wallet 命名空间下的 WalletAgent

using Microsoft.Phone.Wallet;
 
namespace WAgents
{
    public class WAgent : WalletAgent
    {
        private static volatile bool _classInitialized;
 
        public WAgent()
        {
            if (!_classInitialized)
            {
                _classInitialized = true;
                // Subscribe to the managed exception handler
                Deployment.Current.Dispatcher.BeginInvoke(delegate
                {
                    Application.Current.UnhandledException += ScheduledAgent_UnhandledException;
                });
            }
        }
 
        // Code to execute on Unhandled Exceptions
        private void ScheduledAgent_UnhandledException(object sender, ApplicationUnhandledExceptionEventArgs e)
        {
            if (System.Diagnostics.Debugger.IsAttached)
            {
                // An unhandled exception has occurred; break into the debugger
                System.Diagnostics.Debugger.Break();
            }
        }
 
        protected override async void OnRefreshData(RefreshDataEventArgs args)
        {
            // Check if the customers birthday etc…
            foreach (WalletItem item in args.Items)
            {
                WalletTransactionItem WTI = item as WalletTransactionItem;
                if (WTI != null)
                {
                    if (WTI.Id == "CoffeeContosoMembershipCard")
                    {
                        WTI.Message = "Happy birthday, we have a suprise for you. Tap for details.";
                        WTI.MessageNavigationUri = new Uri("/mainpage.xaml?ParameterName=[ParameterValue] for wallet agent to app communication.", UriKind.Relative);
 
                        //WTI.SetUserAttentionRequiredNotification(true);
                 
                        await WTI.SaveAsync();
                    }
                }
            }
 
            //base.OnRefreshData(args);
            NotifyComplete();
        }
    }
}

当系统调用Agent的时候代码会自动执行OnRefreshData中的代码。这里可以显示一些推荐类信息和广告，这里是一个客户关怀。

当然这里你还是要在Manifest中写这样一段ExtendedTask节点

    <Tasks>
      <DefaultTask Name="_default" NavigationPage="MainPage.xaml" />
      <ExtendedTask Name="BackgroundTask">
        <BackgroundServiceAgent Specifier="WalletAgent" Name="WalletAgent" Source="WalletAgent" Type="WAgents.WAgent" />
      </ExtendedTask>
    </Tasks>

最终的结构是这样的

5.优惠劵

有了以上的了解 优惠劵相对来说就简单多了 主要就是一个信息的展示 支持排序

                Deal DI = new Deal("ContosoDeal");

                DI.MerchantName = "Contoso Coffee Corp.";
                DI.DisplayName = "Contoso Coffee";
                DI.Description = "With the above barcode, within the next 15 days, you can get a free coffee from any of our shops.";
                DI.CustomerName = "This deal is offered for [Customer Name]";
                DI.ExpirationDate = DateTime.Now.AddDays(15);
                DI.IssuerName = "Issuer name of this deal is [Issuer Name]";
                DI.IssuerWebsite = new Uri("http://www.issuerwebsite.contoso.com");
                DI.NavigationUri = new Uri("/mainpage.xaml?ParameterName=[ParameterValue] for wallet to app communication.", UriKind.Relative);
                DI.Notes = "Notes for the customer.";
                DI.OfferWebsite = new Uri("http://www.offerwebsite.contoso.com");
                DI.TermsAndConditions = "Terms and Conditions of the deal goes here.";
                DI.Logo99x99 = GetBitmapSource("Assets/wallet_99x99.png");
                DI.Logo159x159 = GetBitmapSource("Assets/wallet_159x159.png");
                DI.Logo336x336 = GetBitmapSource("Assets/wallet_336x336.png");
                DI.BarcodeImage = GetBitmapSource("Assets/wallet_barcode.png");

                await DI.SaveAsync();

添加方法如上 

好了相信大家看过之后在 windows phone 8 wallet 如何使用电子钱包已经有了一个了解，欢迎大家在这里和我沟通交流或者在新浪微博上 @王博_Nick