背水一战 Windows 10 (84) - 用户和账号: 微软账号的登录和注销

[源码下载]

背水一战 Windows 10 (84) - 用户和账号: 微软账号的登录和注销

作者：webabcd


介绍
背水一战 Windows 10 之 用户和账号

• 微软账号的登录和注销

示例
演示如何将微软账号的登录和注销集成到 app 中
UserAndAccount/MicrosoftAccount.xaml

<Page
    x:Class="Windows10.UserAndAccount.MicrosoftAccount"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:Windows10.UserAndAccount"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    mc:Ignorable="d">

    <Grid Background="Transparent">
        <StackPanel Margin="10 0 10 10">

            <Button Name="button" Content="登录/注销" Margin="5" Click="button_Click" />

            <TextBlock Name="lblMsg" Margin="5" />

            <Ellipse Width="48" Height="48" HorizontalAlignment="Left" Margin="5">
                <Ellipse.Fill>
                    <ImageBrush x:Name="imagePicture" />
                </Ellipse.Fill>
            </Ellipse>

        </StackPanel>
    </Grid>
</Page>

UserAndAccount/MicrosoftAccount.xaml.cs

/*
 * 演示如何将微软账号的登录和注销集成到 app 中
 * 
 * AccountsSettingsPane - 账号配置界面
 *     Show() - 弹出界面
 *     GetForCurrentView() - 获取当前的 AccountsSettingsPane 实例
 *     AccountCommandsRequested - 弹出界面时触发的事件（事件参数为：AccountsSettingsPaneCommandsRequestedEventArgs）
 *     
 * AccountsSettingsPaneCommandsRequestedEventArgs
 *     GetDeferral() - 获取异步操作对象
 *     HeaderText - 弹出界面上需要显示的标题文字
 *     Commands - 返回一个 SettingsCommand 列表，用于在界面上添加自定义按钮
 * 
 *     
 *     
 * 流程简述：
 * 
 * 登录第一步，将指定的 web 账号提供商添加到账号登录界面中
 * WebAccountProvider - web 账号提供商（本例以微软账号为例）
 * WebAuthenticationCoreManager - 用于获取指定的 WebAccountProvider
 * WebAccountProviderCommand - 用于将指定的 WebAccountProvider 添加到账号登录界面中
 * 
 * 登录第二步，用户在账号登录界面中登录后
 * WebTokenRequest - 通过指定的 WebAccountProvider 获取这个 web 请求对象
 * WebTokenRequestResult - 通过 WebAuthenticationCoreManager 和指定的 WebTokenRequest 获取这个 web 请求结果
 * 
 * 注销第一步，将指定的 web 账号添加到账号管理界面中
 * WebAccount - 通过 WebAuthenticationCoreManager 和指定的 WebAccountProvider 和指定的 userId 获取这个 web 账号对象
 * WebAccountCommand - 用于将指定的 WebAccount 添加到账号管理界面中
 * 
 * 注销第二步，用户在账号管理界面中选择注销后
 * WebAccount - 可以调用这个对象的注销方法
 * 
 * 
 * 
 * 注：
 * 本例测试时会报 ProviderError 错误，因为“you must register your app under the Microsoft Store with a Microsoft developer account”
 * 给自己一个提醒，如果需要看效果的话，请参见自己写的“打字通”app 中的 MicrosoftAccount.xaml
 */

using System;
using System.Net.Http;
using System.Threading.Tasks;
using Windows.Data.Json;
using Windows.Security.Authentication.Web.Core;
using Windows.Security.Credentials;
using Windows.UI.ApplicationSettings;
using Windows.UI.Popups;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Media.Imaging;
using Windows.UI.Xaml.Navigation;

namespace Windows10.UserAndAccount
{
    public sealed partial class MicrosoftAccount : Page
    {
        const string MicrosoftAccountProviderId = "https://login.microsoft.com";
        const string ConsumerAuthority = "consumers";
        const string AccountScopeRequested = "wl.basic";
        const string AccountClientId = "none";

        private string _userId = null;

        public MicrosoftAccount()
        {
            this.InitializeComponent();
        }

        protected override void OnNavigatedTo(NavigationEventArgs e)
        {
            base.OnNavigatedTo(e);

            // 弹出账号配置界面时触发的事件
            AccountsSettingsPane.GetForCurrentView().AccountCommandsRequested += OnAccountCommandsRequested;
        }

        protected override void OnNavigatedFrom(NavigationEventArgs e)
        {
            base.OnNavigatedFrom(e);

            AccountsSettingsPane.GetForCurrentView().AccountCommandsRequested -= OnAccountCommandsRequested;
        }

        private void button_Click(object sender, RoutedEventArgs e)
        {
            // 弹出账号配置界面
            AccountsSettingsPane.Show();
        }

        private async void OnAccountCommandsRequested(AccountsSettingsPane sender, AccountsSettingsPaneCommandsRequestedEventArgs e)
        {
            AccountsSettingsPaneEventDeferral deferral = e.GetDeferral();

            if (_userId == null)
            {
                // 弹出账号配置界面用于账号登录
                await ShowLoginUI(e);
                // 弹出界面上需要显示的标题文字
                e.HeaderText = "请登录";
            }
            else
            {
                // 弹出账号配置界面用于账号管理（本例用于演示注销）
                await ShowLogoutUI(e);
                // 弹出界面上需要显示的标题文字
                e.HeaderText = "请注销";
            }

            // 在弹出界面上添加自定义按钮
            e.Commands.Add(new SettingsCommand("help", "帮助", HelpInvoked));
            e.Commands.Add(new SettingsCommand("about", "关于", AboutInvoked));

            deferral.Complete();
        }

        private void HelpInvoked(IUICommand command)
        {
            lblMsg.Text = "用户点击了“帮助”按钮";
        }

        private void AboutInvoked(IUICommand command)
        {
            lblMsg.Text = "用户点击了“关于”按钮";
        }



        // 将指定的 web 账号提供商添加到账号登录界面中
        private async Task ShowLoginUI(AccountsSettingsPaneCommandsRequestedEventArgs e)
        {
            WebAccountProvider provider = await WebAuthenticationCoreManager.FindAccountProviderAsync(MicrosoftAccountProviderId, ConsumerAuthority);
            WebAccountProviderCommand providerCommand = new WebAccountProviderCommand(provider, WebAccountProviderCommandInvoked);
            e.WebAccountProviderCommands.Add(providerCommand);
        }

        // 用户在账号登录界面中登录后
        private async void WebAccountProviderCommandInvoked(WebAccountProviderCommand command)
        {
            try
            {
                WebTokenRequest webTokenRequest = new WebTokenRequest(command.WebAccountProvider, AccountScopeRequested, AccountClientId);

                WebTokenRequestResult webTokenRequestResult = await WebAuthenticationCoreManager.RequestTokenAsync(webTokenRequest);

                if (webTokenRequestResult.ResponseStatus == WebTokenRequestStatus.Success)
                {
                    var response = webTokenRequestResult.ResponseData[0];
                    if (response != null)
                    {
                        // 拿到 userId，实际开发中一般会将此信息保存到本地
                        string userId = response.WebAccount.Id;
                        _userId = userId;
                        lblMsg.Text = "登录成功，userId：" + userId;
                        lblMsg.Text += Environment.NewLine;

                        /*
                         * 微软账号的登录过程到此就完成了
                         * 如果想通过 response.WebAccount.UserName 这种方式来获取账号的用户名或其他信息的话，那是获取不到的
                         * 需要带着 response.Token 去请求 apis.live.net 来获取相关信息，说明如下
                         */

                        // 登录成功后，要通过拿到的 token 像下面这样获取用户信息
                        var restApi = new Uri(@"https://apis.live.net/v5.0/me?access_token=" + response.Token);

                        using (var client = new HttpClient())
                        {
                            var infoResult = await client.GetAsync(restApi);
                            string content = await infoResult.Content.ReadAsStringAsync();
                            /* 获取到的内容类似如下
                             {
                               "id": "abcd1234abcd1234", 
                               "name": "王磊", 
                               "first_name": "磊", 
                               "last_name": "王", 
                               "link": "https://profile.live.com/", 
                               "gender": null, 
                               "locale": "zh_CN", 
                               "updated_time": "2017-04-27T02:24:58+0000"
                             }
                             */
                            var jsonObject = JsonObject.Parse(content);
                            string name = jsonObject["name"].GetString() ?? "";
                            string locale = jsonObject["locale"].GetString() ?? "";
                            lblMsg.Text += $"name:{name}, locale:{locale}";

                            // 通过如下方式拿到用户图片
                            string profileId = jsonObject["id"].GetString() ?? "";
                            string pictureUrl = $"https://apis.live.net/v5.0/{profileId}/picture" ?? "";
                            imagePicture.ImageSource = new BitmapImage(new Uri(pictureUrl));
                        }
                    }
                }
                else
                {
                    lblMsg.Text = "登录失败：" + webTokenRequestResult.ResponseStatus.ToString();
                }
            }
            catch (Exception ex)
            {
                lblMsg.Text = ex.ToString();
            }
        }



        // 将指定的 web 账号添加到账号管理界面中
        private async Task ShowLogoutUI(AccountsSettingsPaneCommandsRequestedEventArgs e)
        {
            WebAccountProvider provider = await WebAuthenticationCoreManager.FindAccountProviderAsync(MicrosoftAccountProviderId, ConsumerAuthority);

            WebAccount account = await WebAuthenticationCoreManager.FindAccountAsync(provider, _userId);

            if (account != null)
            {
                // 最后一个参数用于指定当用户选择了账号后，会出现哪些功能按钮（我这里测试只有 SupportedWebAccountActions.Remove 是有效的）
                WebAccountCommand command = new WebAccountCommand(account, WebAccountCommandInvoked, SupportedWebAccountActions.Remove);
                e.WebAccountCommands.Add(command);
            }
            else
            {
                _userId = null;
            }
        }

        // 用户在账号管理界面中选择了某项功能
        private async void WebAccountCommandInvoked(WebAccountCommand command, WebAccountInvokedArgs args)
        {
            // 用户选择的是注销
            if (args.Action == WebAccountAction.Remove)
            {
                await command.WebAccount.SignOutAsync();

                _userId = null;

                lblMsg.Text = "注销成功";
                imagePicture.ImageSource = null;
            }
        }
    }
}

OK
[源码下载]