快速入门 - 适用于和 Xamarin 的 PlayFab 客户端库 C#

开始使用适用于和 Xamarin 的 PlayFab 客户端库 C#。 按照步骤安装程序包,并尝试基本任务的示例代码。

本快速入门帮助你使用适用于和 Xamarin 的客户端库进行首次 PlayFab API 调用 C#。

API 参考文档

要求

Xamarin 项目设置

  1. 打开Visual Studio,然后选择" 创建新项目"
  2. 选择移动应用 (Xamarin.Forms),然后选择"下一步"
  3. 将应用命名为 GettingStartedXamarin,然后选择 创建
  4. 对于本快速入门,请取消选中 AndroidiOs,然后检查**Windows (UWP)"
  5. 安装适用于 PlayFabAllSDK的 NuGet 包。

VS - 安装适用于 PlayFab SDK 的 nuget 包

设置您的首次 API 调用

本指南提供进行首次 PlayFab API 调用(无任何 GUI 或屏幕反馈)的最少步骤。 确认将通过屏幕上的文本小组件进行。

  1. 在 Visual Studio 解决方案资源管理器中,打开 GettingStartedXamarin > App.xaml > App.xaml.cs 文件。
  2. 将 App.xaml.cs 的内容替换为以下示例代码:
using System;
using System.Threading.Tasks;
using PlayFab;
using PlayFab.ClientModels;
using Xamarin.Forms;

namespace App2
{
    public partial class GettingStartedXamarin : Application
    {
        private readonly Label _myLabel;
        private string _myLabelText = "Logging into PlayFab...";

        public App()
        {
            _myLabel = new Label { HorizontalTextAlignment = TextAlignment.Center, Text = _myLabelText };

            // The root page of your application
            MainPage = new ContentPage
            {
                Content = new StackLayout { VerticalOptions = LayoutOptions.Center, Children = { _myLabel } }
            };

            LogIntoPlayFab();
            Device.StartTimer(TimeSpan.FromMilliseconds(16), Tick);
        }

        private bool Tick()
        {
            lock (_myLabelText)
            {
                _myLabel.Text = _myLabelText;
            }
            return true;
        }

        private void LogIntoPlayFab()
        {
            PlayFabSettings.staticSettings.TitleId = "";
            var request = new LoginWithCustomIDRequest { CustomId = "GettingStartedGuide", CreateAccount = true };
            var loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
            loginTask.ContinueWith(OnLoginComplete);
        }

        private void OnLoginComplete(Task<PlayFabResult<LoginResult>> task)
        {
            var newLabel = "Unknown failure";
            if (task.Result.Result != null)
            {
                newLabel = "Congratulations, you made your first successful API call!";
            }
            if (task.Result.Error != null)
            {
                newLabel = "Something went wrong with your first API call.\n"
                    + "Here's some debug information:\n"
                    + task.Result.Error.GenerateErrorReport();
            }
            lock (_myLabelText)
            {
                _myLabelText = newLabel;
            }
        }
    }
}

完成并执行

  1. 若要运行项目,请选择 调试 ,然后选择 "开始调试"

注意

首次运行 UWP 程序时,可能需要很长时间才能加载。

  1. 加载项目时,你将看到以下文本:

    “恭喜,你首次调用 API 成功!”

此时,可以开始进行其他 API 调用,并生成游戏。

有关所有可用客户端 API 调用的列表,请参阅我们的 PlayFab API 引用文档。