クイックスタート - C# および Xamarin 用の PlayFab クライアント ライブラリ
C# および Xamarin 用の PlayFab クライアント ライブラリを使用して開始します。 手順に従ってパッケージをインストールし、基本的なタスクのコード例を試します。
このクイックスタートでは、C# および Xamarin 用のクライアント ライブラリを使用して最初の PlayFab API 呼び出しを行うことができます。
要件
- PlayFab 開発者アカウント。
- Visual Studio のインストール。
Xamarin プロジェクトのセットアップ
- Visual Studio を開き、[新しいプロジェクトの作成] を選択します。
- [Mobile App (Xamarin.Forms)](モバイル アプリ (Xamarin.Forms)) を選択し、[次へ] を選択します。
- アプリに GettingStartedXamarin という名前を付け、[作成] を選択します。
- このクイック スタートでは、[Android] と [iOs] のチェックを外し、**[Windows (UWP)] をオンにします。
- PlayFabAllSDK 用の NuGet パッケージをインストールします。
最初の API 呼び出しのセットアップ
このガイドでは、GUI や画面上のフィードバックなしで、最初の PlayFab API 呼び出しを行う最小限の手順を示します。 確認は、画面上のテキスト ウィジェットで行います。
- Visual Studio のソリューション エクスプローラーで、GettingStartedXamarin > App.xaml > App.xaml.cs ファイルを開きます。
- 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;
}
}
}
}
完成と実行
- プロジェクトを実行するには、[デバッグ] を選択し、[デバッグの開始] を選択します。
注意
初めて UWP のプログラムを実行するときは、読み込みに時間がかかることがあります。
プロジェクトが読み込まれると、次のテキストが表示されます。
"これで、最初の API 呼び出しが成功しました。"
この時点で、他の API 呼び出しとタイトルのビルドを開始できます。
利用可能なすべてのクライアント API 呼び出しの一覧については、PlayFab API リファレンスをご覧ください。