Windows Phone 8 Wallet 手机钱包.doc

本文由麦可网 收集整理，转载请注明出处。
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=newPaymentInstrument("ContosoCreditAccount"); 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 wallettoappcommunication.",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("");
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("");
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();
添加方法如上。