applican

マイページに戻る

CloudPreferences

iOS では iCloud、Android は Android Backup Service を利用して key/value ペアを保存します。

このAPIを使用する場合、以下の設定を行ってください。

・iOS は対象のアプリの iCloud を有効にします。

・Android は Android DevelopersにてAndroid Backup Service の API キーを発行し、アプリカンのAndroidアプリ設定内の追加オプション設定
 'Android Backup Service APIキー' に指定してください。

※詳しくは設定方法をご覧ください。

機能

値を取得する 【 getValue 】※ver.2.0用

値を設定する 【 setValue 】※ver.2.0用

値を削除する 【 deleteValue 】※ver.2.0用

利用用途

環境設定やアプリケーション設定、状態など個別のデータをiCloudに格納する機能を実装したい場合、こちらの機能をご利用ください。

【対応ランタイムバージョン】

ランタイムのバージョン毎に最適化したサンプルをダウンロードしてご使用ください。

サンプル CloudPreferences
サンプル CloudPreferences
サンプル CloudPreferences
サンプル CloudPreferences
サンプル CloudPreferences
サンプル CloudPreferences

設定方法

Android Backup Serviceの設定方法

1.Android Developersにアクセスします
https://developer.android.com


2.Docs → UserData&Identity → Data backup → Backup key-value pairs → Registerの順にクリックしてください。


設定方法 AndroidBackupService


3.Application packge nameを記入し、次に進んでください。


設定方法 AndroidBackupService


4.あなたのキーを保存しておきます。

設定方法 AndroidBackupService

5.アプリカンサイトにログインします。
https://user.applican.com


6.Androidビルド設定から追加オプションの「Android Backup Service APIキー」に保存したあなたのキーを記入します。


設定方法 AndroidBackupService


以上でAndroid Backup Serviceの設定が完了です。


iCloudの設定方法

1.iOS Dev Centerサイトにアクセスします。
https://developer.apple.com/devcenter/ios/index.action


2.Identifiers内のiCloud Containersをクリックし、画面内の右上にある「＋」ボタンをクリックします。


設定方法 iCloud


3.DescriptionとIDを記入し、次に進みます。


設定方法 iCloud


4.Registerをクリックし、iCloud Containersの設定は完了です。


設定方法 iCloud


5.次にIdentifiers内のApp IDsをクリックします。


6.その後、設定したいアプリのIDをクリックします。


設定方法 iCloud


7.Editをクリックします。


設定方法 iCloud


8.iCloud欄のEditをクリックします。


設定方法 iCloud


9.先程作成したiCloud Containersを選択し、Continueをクリックします


設定方法 iCloud


10.Assignをクリックします。


設定方法 iCloud


以上でiCloudの設定が完了です。

メソッド

  • getValue(String Key, Function SuccessCallback, Function ErrorCallback)
  • setValue(String Key, String Value, Function SuccessCallback, Function ErrorCallback)
  • deleteValue(String Key, Function SuccessCallback, Function ErrorCallback)

getValue

メソッド説明

getValue(String key, Function SuccessCallback, Function ErrorCallback)

値を取得します。

パラメータ

Key : String データを識別するためのキーです。
SuccessCallback : Function 値が取得出来た場合にCallbackされます。
ErrorCallback : Function 値が取得出来なかった場合にCallbackされます。

Return

void

サンプルコード

//値取得用メソッド呼び出し
applican.cloudpreferences.getValue("foo", success, failure);

//値取得成功時のコールバック
function success(result)(){
	console.log("getValue() successful.", result);
}
//値取得失敗時のコールバック
function failure(error){
	console.log("getValue() failure.", error);
}

setValue

メソッド説明

setValue(String Key, String Value, Function SuccessCallback, Function ErrorCallback)

値を設定します。

パラメータ

Key : String 保存するデータを識別するためのキーです。
Value : String 保存するデータです。
SuccessCallback : Function 値が設定出来た場合にCallbackされます。
ErrorCallback : Function 値が設定出来なかった場合にCallbackされます。

Return

void

サンプルコード

//値設定用メソッド呼び出し
applican.cloudpreferences.setValue("foo", "bar", success, failure);

//値設定成功時のコールバック
function success(){
	console.log("setValue() successful.");
}
//値設定失敗時のコールバック
function failure(error){
	console.log("setValue() failure.", error);
}

deleteValue

メソッド説明

deleteValue(String Key, Function SuccessCallback, Function ErrorCallback)

値を削除します。

パラメータ

Key : String データを識別するためのキーです。
SuccessCallback : Function 値が削除出来た場合にCallbackされます。
ErrorCallback : Function 値が削除出来なかった場合にCallbackされます。

Return

void

サンプルコード

//値削除用メソッド呼び出し
applican.cloudpreferences.deleteValue("foo", success, failure);

//値削除成功時のコールバック
function success(){
	console.log("deleteValue() successful.");
}
//値削除失敗時のコールバック
function failure(error){
	console.log("deleteValue() failure.", error);
}