当前位置：首页 > news >正文

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

news 来源：原创 2024/5/10 20:46:28

手机钱包是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();