AIRでAndroid用アプリを構築した経験があると、この記事を最大限に活用できます。Fireは、開発者にとって巨大な市場であり、アプリを収益化する大きなチャンスです。PurchaseシステムをAIRおよびFlashのアプリに統合できます。fireは、次のことが可能になる100%ネイティブのJavaソリューションです。Developer(Amazonデベロッパー)」のパブリッシングアカウントでのアプリの設定Amazonのアプリ内課金を利用する前に、Amazonの開発者Webサイトで購入可能なアイテムを定義する必要があります。http://developer.amazon.comに移動し、自分の開発者アカウント資格情報を使用してログインします。App(新しいアプリを追加)」をクリックします(図1参照)。既存のアプリにアプリ内課金を追加する場合には、手順4に進みます。アプリのタイトル、形態、説明および連絡先情報を入力し、「Save(保存)」をクリックします(図2参照)。Items(アプリ内課金アイテム)」を選択します(図3参照)。Item(アプリ内課金アイテムを追加)」を選択します。Subscription(購読アイテムを追加)」の3つのオプションが表示されます(図4参照)。消費アイテムは何度も購入でき、アプリ内で使い切られるか、消費される製品です。消費アイテムとは、ゲームコインのパックなどです。ユーザーはコインを買い、ゲーム内で使い、またコインを買い足すことができます。資格アイテムは、一度購入すれば永久に所有できる製品です。資格アイテムとは、ゲームの新しいレベルのパックまたはユーティリティアプリの機能制限の解除などです。購読アイテムは、機能またはコンテンツのセットを一定の期間有効にするために購入されます。期間が過ぎると、購読は更新できます。毎月新しい記事を配信する雑誌などが購読アイテムにあたります。追加するアイテムの種類を選択します。以下の例では消費アイテムを使用します。次の画面で、消費アイテムの詳細を入力します。「Title(タイトル)」フィールドおよび「Description(説明)」フィールドは、アップロードするマルチメディアコンテンツとともにエンドユーザーに表示されます。「SKU(SKU)」フィールドは、このアイテム固有の識別子です。ユーザーがこれを見ることはありませんが、後で自分のアプリからアイテムをプログラムで購入する際に必要になるので、自分が選択したSKUは必ず把握しておいてください。アイテムの設定が完了したら、「Save(保存)」を選択します(図5参照)。アプリ内課金をアプリに追加するには、必要に応じて前述の手順を繰り返します。アイテムリストJSONファイルの作成とインストールアプリをAppstoreに申請する前にアプリ内課金をテストするには、購入のためのすべてのメタデータが含まれるJSON形式の特別なファイルを作成する必要があります。サンドボックスモードのとき、このファイルはアプリが購入要求にどのように応答するのかを決定します。次の例に、このファイルが取る必要のある形式を示します。my_spellを持つ消費アイテムが含まれます。SKU、タイトル、説明およびほかのデータがデベロッパーポータルで入力したものと一致するように注意してください。ファイル名は、amazon.sdktester.jsonとします。フォルダーに、このファイルの参考例があります。JSONを参照してください。次の例を参考に、ご利用のテキストエディターでamazon.sdktester.jsonというファイルを作成します。自分の購入用のSKUおよびその他の情報を使用してください。}ご使用のコンピューターの任意の場所にファイルを保存します。FireまたはほかのAndroidデバイスを接続します。Windowsのコマンドプロンプト(スタート/実行で、cmdと入力しEnterキーを押す)またはiOSのターミナル(アプリケーション/ターミナル)を開きます。JSONファイルの場所へ移動します。c:\devと入力しEnterキーを押します。/Users/yourusername/devcdと入力しReturnキーを押します。SDKに付属のadbプログラムを実行します。(SDKがない場合には、http://developer.android.com/sdk/index.htmlから入手できます)。JSONファイルの場所を1つ目のパラメーターとし、/mnt/sdcardを2つめのパラメーターとして渡して、pushコマンドを実行します。/mnt/sdcardと入力してEnterキーを押します。/mnt/sdcardと入力してReturnキーを押します。Testerと呼ばれる特別なテストアプリケーションをインストールする必要があります。SDKはhttps://developer.amazon.com/sdk.htmlからダウンロードできます。SDKのadbコマンドを再度使用します。FireまたはほかのAndroidデバイスを接続します。コマンドプロンプトを開きます。SDKに付属のadbプログラムを実行します。TesterアプリAPKをパラメーターとして渡してinstallコマンドを実行します。C:\dev\android-sdkにある場合、次のコマンドを実行します。/Users/yourusername/android-sdkにある場合、次のコマンドを実行します。CS6以降を使用していない場合には、代わりにAmazonPurchaseAPI.swcライブラリを追加する必要があります)。CS6では次のように行います。Android用のタイプAIRの新規プロジェクトを作成します。ファイル/パブリッシュ設定を選択します。Settings(ActionScript設定のスクリプト)」の横のレンチアイコンをクリックします。「ライブラリパス」タブを選択します。File(ネイティブ拡張機能(ANE)ファイルの参照)」をクリックし、com.milkmangames.nativeextensions.AmazonPurchase.aneファイルを選択します。4.6では次のように行います。プロジェクトプロパティに移動します(パッケージエクスプローラーで右クリックし、「プロパティ」を選択)。Extensions(ネイティブ拡張機能)」タブをクリックします。ANE(ANEを追加)」をクリックして、com.milkmangames.nativeextensions.AmazonPurchase.aneファイルに移動します。Buildパッケージング)/Packaging(パッケージング)/Androidを選択します。Extensions(ネイティブ拡張機能)」タブを選択し、拡張機能の横の「パッケージ」チェックボックスをクリックします。FlashDevelopでは次のように行います。プロジェクトフォルダーにAmazonPurchaseAPI.swcファイルをコピーします。Library(ライブラリに追加)」を選択します。Library(外部ライブラリ)」を選択します。Purchaseの拡張機能は、数回の単純な呼び出しで作動できます。初めに、以下の手順を実行します。APIクラスをインポートします。com.milkmangames.nativeextensions.android.events.*;AmazonPurchase.create()を呼び出して、APIを初期化します。最初にAmazonPurchase.isSupported()メソッドをチェックすることで、現在のプラットフォームがAndroidであって、サポートされていないプラットフォーム(iOSまたはWindows)でないことを確認できます。APIのインスタンスが静的に使用可能になります。考えられるすべてのAPI応答に対してイベントリスナーを追加します。AmazonPurchase.amazonPurchase.addEventListener(AmazonPurchaseEvent.PURCHASES_UPDATED,onPurchasesUpdate);購入更新イベントの処理APIを初期化し、イベントハンドラーを設定すると、AmazonPurchaseEvent.PURCHASES_UPDATEDイベントをいつでも受けることができるようになります。このイベントにはパラメーターreceiptsが含まれます。これには、ユーザーが購入した非消費アイテムのAmazonPurchaseReceiptオブジェクトのアレイが含まれます。次のコード例は、これらの受け取りに対する反復操作を行う方法を示しています。}アイテムデータの取得AmazonPurchase.amazonPurchase.loadItemData()メソッドを使用して、タイトル、説明、アイコンなどの詳細をSKUの特定のセットに関連するものとして、次のように取得できます。AmazonPurchase.amazonPurchase.loadItemData([“my_spell”,”my_levelpack”]);完了時に、この関数は提供されたSKUの詳細を含むAmazonPurchaseEvent.ITEM_DATA_LOADEDイベントをディスパッチします。要求に失敗すると、AmazonPurchaseEvent.ITEM_DATA_FAILEDがディスパッチされます。次のコードは、itemDatasに対する反復操作を実行し、SKUを表示することを示しています。プロパティunavailableSkusをチェックします。これは提出したSKUのアレイで無効なものです。}購入の実行アプリのコードからアイテムの購入を開始するには以下の手順に従います。アイテムの購入を開始し、ユーザーにチェックアウトダイアログボックスを表示するには、purchaseItem(itemSku)メソッドを使用します。itemSkuは先に作成した製品SKUのうちの1つです。AmazonPurchase.amazonPurchase.purchaseItem("your_itemsku");購入プロセスが完了すると、表1に示されたイベントのうち1つを受け取ります。表1.購入イベントイベント説明AmazonPurchaseEvent.PURCHASE_SUCCEEDED購入は成功しました。イベントのreceiptsパラメーターは購入アイテムのAmazonPurchaseReceiptオブジェクトを1つ含むベクトルアレイです。AmazonPurchaseEvent.PURCHASE_FAILED購入は、エラーまたはユーザーが購入を中止したために成功しませんでした。AmazonPurchaseEvent.SKU_INVALID指定されたitemSkuはシステムにありませんでした。AmazonPurchaseEvent.PURCHASE_ALREADY_ENTITLEDユーザーは指定された非消費アイテムを既に持っています。Purchaseの特定の設定に更新するように、AIRアプリケーション記述ファイルを設定する必要があります。example/app.xmlを参照してください。SDKを3.0(または3.0以上)に設定します。xmlns=“http://ns.adobe.com/air/application/3.0”>記述に拡張機能へのリンクを含めます。</extensions>Androidマニフェスト追加を更新します。Purchaseを機能させるには、android.permission.INTERNET許可が必要です。以下に示すように、<intent-filter>要素内にcom.amazon.inapp.purchasing.NOTIFYアクションを追加する必要があります。Purchase拡張ライブラリを追加した場合には、普段行っているようにIDEから直接コンパイルできます。それ以外の場合で、コマンドラインから拡張機能を使用してアプリを構築する場合は、com.milkmangames.nativeextensions.AmazonPurchase.aneファイルを含むディレクトリを指定する必要があります。以下にコマンドラインで構築する例を示します。[DIRECTORY_CONTAINING_ANE_FILE]アプリが期待したイベントを受け取らない場合、以下のヒントを参考にしてください。前述のように、アプリケーション記述XMLファイルに適切なmanifestAdditionsを追加していることを確認する。テスターJSONファイルの形式を再確認する。Purchaseテストはサイレントに失敗します。Purchasesが作動するようにできたので、その他のネイティブ拡張機能のチュートリアルに進むことができます。地域を選択してください地域を選択すると、アドビサイトで使用する言語と内容が変わります。