イントロダクション（Unity）
スクリプト
プッシュ通知
会員管理・認証
SNS連携
データストア
位置情報検索
ファイルストアクイックスタート
Contents |
クイックスタートについて
このページでは、mobile backendをUnityアプリと連携させる手順を紹介します
アプリの新規作成
- ニフクラ mobile backendにログインします
- 管理画面が表示されたら、「アプリの新規作成」を行います
- すでに別のアプリを作成済みの場合は、ヘッダーの「＋新しいアプリ」をクリックします
- 「アプリ名」を入力し「新規作成」をクリックすると、APIキー（アプリケーションキーとクライアントキー）が発行されます
- APIキーは後ほどUnityアプリで使います
- Unityでプロジェクトを作成します
- 既存のプロジェクトを利用する場合はこの作業は不要です
SDKのダウンロード
- 以下のリンクからGithubのリリースページを開き、NCMB.x.x.x.zip(xはバージョン番号)をダウンロードしてください
- PrefabとSceneをご利用の場合「v4.1.0」以上をダウンロードする必要がございます
SDKをインストールする
- 先ほどダウンロードしたzipファイルを解凍します
- フォルダ内にある「NCMB.unitypackage」をダブルクリックして、インポートしてください
SDKの読み込み
- インポートした「Assets/Prefabs」のフォルダ内にある「NCMBSettings.prefab」と「NCMBManager.prefab」をヒエラルキー（Hierarchy)にドラッグ＆ドロップします
APIキーの設定とSDKの初期化
- コードを書いていく前に、必ずmBaaSで発行されたAPIキーの設定を行う必要があります
- ヒエラルキー（Hierarchy）の「NCMBSettings」をクリックすると、インスペクタ（Inspector）に図のようなアプリケーションキーとクライアントキーの入力欄が表示されます
- プッシュ通知機能を使用する場合、Use Pushにチェックを入れてください
- 開封通知を行う場合、Use Analyticsにチェックを入れてください。
- 詳しくはプッシュ通知の基本的な使い方をご覧ください。
- レスポンスシグネチャの検証を行う場合はResponse Validationにチェックを入れてください
- 上のアプリケーションキーとクライアントキーは、mBaaSの管理画面で「アプリの新規作成」を行ったときに発行されたAPIキーに置き換えます
- アプリ作成時のAPIキー発行画面を閉じてしまった場合は、「アプリ設定」＞「基本」で確認できます。
- 「コピー」ボタンを使用してコピーしてください。
- これで連携作業は完了です！
- サンプルコードを書いて実際にmBaaSを使ってみましょう
サンプルコードの実装
- ここまでの作業を行えば、プロジェクト中のどのシーン、どのスクリプトでもmobile backendの機能を使用することができます
- 新しく「空のGame Object」と「C#スクリプト」を作成し、そのスクリプトを空のGame Objectにアタッチします
- スクリプトを開き、最上部に以下の内容を追記します
using NCMB;
- Startメソッド内に書いた処理は、GameObjectの起動時に実行されます
- Startメソッドの中にサンプルコードを書くと、すぐに動作確認が可能です
// Use this for initialization
void Start () {
// ↓ ここにサンプルコードを実装 ↓
}
サンプルコード（データストア）
- 次のコードはmBaaSのデータストアに保存先の「TestClass」というクラスを作成し、「message」というフィールドへ「Hello, NCMB!」というメッセージ（文字列）を保存するものです
// クラスのNCMBObjectを作成
NCMBObject testClass = new NCMBObject("TestClass");
// オブジェクトに値を設定
testClass["message"] = "Hello, NCMB!";
// データストアへの登録
testClass.SaveAsync();
アプリを実行してmBaaSの管理画面を確認する
アプリを実機またはシミュレーターで実行します
シミュレーターで実行するには画像内の再生ボタンを押してください。
実機でテストするにはiOSまたはAndroidのビルドが必要です。
詳しくはプッシュ通知（Unity）：基本的な使い方をご覧ください。アプリが起動されたら、mBaaSの管理画面で「データストア」から、データが保存されていることを確認できます
注意事項
- WindowsでMonoDevelopを使用しビルドする際、「.NET 4.0」以上を選択する必要があります。設定方法はMonoDevelopの[Project] -> [Assembly-CSharp options] -> [Build/General] -> Target Framework で Mono/.NET 4.0を選択します。
Scenesについて
- 「Assets/Scenes」内にサンプルコード導入まで実施した「QuickStart.scene」をご用意いたしましたので、動作確認にお使いください。
- 「QuickStart.scene」内にはNCMBSettings, NCMBManagerとQuickStart.csをアタッチ済みのGameObjectが含まれています。 動作確認する際、NCMBSettingsをクリックし、インスペクタ（Inspector）にてアプリケーションキー、クライアントキーを入力する必要がありますので、ご注意ください。
Unityアプリのチュートリアルについて
- 他にもさまざまなチュートリアルをご用意しています
ぜひご活用ください！
お探しの内容が見つからなかった場合はユーザーコミュニティ
もご活用ください。（回答保証はいたしかねます）
なお、 Expertプラン以上のお客様はテクニカルサポートにてご質問を承らせて頂きます。
推奨画面サイズ1024×768px以上
