Ad
4: 2016-07-20 (水) 13:07:38 njf ソース バックアップ No.4 を復元して編集 現: 2019-04-25 (木) 19:27:54 njf ソース 編集
Line 2: Line 2:
まず、通常のAndroidアプリで広告を表示できないとANEを作成することはできません。ここではAndroidアプリでAdmobの広告を表示し、そこから必要なファイルを抜き出す方法を紹介します。 まず、通常のAndroidアプリで広告を表示できないとANEを作成することはできません。ここではAndroidアプリでAdmobの広告を表示し、そこから必要なファイルを抜き出す方法を紹介します。
-こちらの内容は「[[AndroidでのANEの作成1_Android側の作成]]」にそった方法で行いますので、そちらも参考にして下さい。+こちらの内容は「[[AndroidでのANEの作成/Android側の作成]]」にそった方法で行いますので、そちらも参考にして下さい。
また、こちらではAdmobの広告IDを使いますので、あらかじめテスト用のAndroidのアプリの登録とそのID、バナー広告用のID、インタースティシャル広告のIDを用意しておいて下さい。 また、こちらではAdmobの広告IDを使いますので、あらかじめテスト用のAndroidのアプリの登録とそのID、バナー広告用のID、インタースティシャル広告のIDを用意しておいて下さい。
Line 76: Line 76:
Finishボタンを押せばライブラリが作成されます。 Finishボタンを押せばライブラリが作成されます。
-*Google Play Servicesの追加 [#ua4e58f1]+*Google Play Servicesの追加 (現在は不要)[#ua4e58f1]
 +&font(Red){----アップデートにより、このセクションの手順は意味がなくなったので飛ばしてください-----&br;};
（この部分については[[公式ページ:https://developers.google.com/mobile-ads-sdk/docs/admob/android/quick-start?hl=ja]]も参考にして下さい。） （この部分については[[公式ページ:https://developers.google.com/mobile-ads-sdk/docs/admob/android/quick-start?hl=ja]]も参考にして下さい。）
Line 118: Line 119:
あとは「Sync Now」という表示が出ていると思うので、それをクリックしてgradleファイルの内容をプロジェクトに反映させれば、Admobの広告表示に必要なライブラリの取り込みができます。 あとは「Sync Now」という表示が出ていると思うので、それをクリックしてgradleファイルの内容をプロジェクトに反映させれば、Admobの広告表示に必要なライブラリの取り込みができます。
-*主処理の追加とAndroidアプリとしてのテスト [#o254a294]+*主処理の追加 [#o254a294]
広告表示の主処理となる部分を作っていきますが、あとでANEとして分離させないといけないので、サンプルなどにあるようにActivityに直接処理を書くわけにはいきません。admobaneライブラリの中に別クラスを作ってそこに主処理を書きます。 広告表示の主処理となる部分を作っていきますが、あとでANEとして分離させないといけないので、サンプルなどにあるようにActivityに直接処理を書くわけにはいきません。admobaneライブラリの中に別クラスを作ってそこに主処理を書きます。
Line 156: Line 157:
例えば、画面遷移5回毎に表示するなら一回目でロードし、4回も画面遷移すれば多分ロードは終わっているでしょうから、5回目の画面遷移で広告を表示する、といったふうに使います。そのため、ロードと表示のメソッドは分けておく必要があるのです。 例えば、画面遷移5回毎に表示するなら一回目でロードし、4回も画面遷移すれば多分ロードは終わっているでしょうから、5回目の画面遷移で広告を表示する、といったふうに使います。そのため、ロードと表示のメソッドは分けておく必要があるのです。
 +
 +ではクラスの詳細を解説します。
 +まずコンストラクタは広告の初期化で必要なactivityを引数とします。
 +
 + public ANEAdmob(Activity activity){
 +       this.activity = activity;
 + }
 +
 +次にアプリケーションのIDを設定するメソッドです。これは広告を表示する前であることはもちろん、他のIDを設定する前に必ず一度実行する必要があります。
 +
 +   public void setAppID(String appID){
 +       MobileAds.initialize(activity, appID);
 +   }
 +
 +次にバナーのIDを設定する関数です。
 +バナーの初期化も行い、かつアプリの下の中心に表示するようにしています。
 +
 +   public void setBannerID(String bannerID){
 +       if(bannerView == null) {
 +           bannerView = new AdView(activity);
 +           bannerView.setAdUnitId(bannerID);
 +           bannerView.setVisibility(AdView.GONE);
 +           bannerView.setAdSize(AdSize.BANNER);
 +           FrameLayout.LayoutParams adLayout = new FrameLayout.LayoutParams(FrameLayout.LayoutParams.WRAP_CONTENT, FrameLayout.LayoutParams.WRAP_CONTENT);
 +           adLayout.gravity = Gravity.BOTTOM | Gravity.CENTER;
 +           FrameLayout.LayoutParams adParams = adLayout;
 +           activity.addContentView(bannerView, adParams);
 +           bannerView.setBackgroundColor(Color.BLACK);
 +       }
 +   }
 +バナーが二つ表示されるとやっかいなので、一度しか初期化できないようにif文でくくられています。
 +ここでsetBackgroundColorを使って背景色を黒にしています。
 +これはまれに広告のロードが終わっても画像が表示されず、透明のままになることがあり、するとユーザーの誤クリックを誘発しやすくなることを防ぐためです。
 +誤クリックが多いと、Admobはアカウント停止になる場合もあります。
 +Admobは特にバナーの規約が厳しいので、アプリのどこにどう表示するかは必ず規約を確認して下さい。
 +詳しくは「[[AdMob実装時の注意点]]」でも書いています。
 +
 +
 +バナーの表示と非表示はバナーの更新を止めて、viewのvisibilityを切り替えるだけです。
 +
 +   public void showBanner(){
 +       if(bannerView.getVisibility() == AdView.VISIBLE){
 +           return;
 +       }
 +       bannerView.setVisibility(AdView.VISIBLE);
 +       bannerView.resume();
 +       bannerView.loadAd(makeAdRequest());
 +   }
 +
 +   public void hideBanner(){
 +       if(bannerView.getVisibility() == AdView.GONE){
 +           return;
 +       }
 +       bannerView.pause();
 +       bannerView.setVisibility(AdView.GONE);
 +   }
 +
 +通常、バナー広告は数十秒〜数分ごとに更新されます。
 +AdViewのpauseメソッドはこの更新を止めます。
 +バナーを消すと更新は不要なので呼び出しています。
 +
 +アプリがバックグラウンドにまわったときも、余計な負荷を除くため、このpauseメソッドを呼び出し、再び前にまわったらresumeメソッドを呼び出すことをお勧めします。
 +
 +ここの例では、単にバックグラウンドでhideBannerを、前にきたらshowBannerを呼び出すと良いでしょう。
 +
 +
 +ここでmakeAdRequestメソッドは広告用のリクエストを作るメソッドです。
 +
 +   private AdRequest makeAdRequest() {
 +       return new AdRequest.Builder().build();
 +   }
 +
 +一行しかありませんが、インタースティシャル広告でも使うのでメソッドにしています。また、AdRequestの作り方を
 + return new AdRequest.Builder().addTestDevice("デバイスID").build();
 +とするとテスト用の広告が表示されるようになります。
 +「デバイスID」の部分はlogcatに
 + I/Ads: Use AdRequest.Builder.addTestDevice("デバイスID") to get test ads on this device.
 +といった感じで表示されるので探してみて下さい。
 +
 +Admobは開発者が自ら広告をタップしたり、開発時に実際の広告を表示するのを禁止しています。
 +現実的には少々テストで表示したり、一度や二度ほどタップしたからいきなり問題が生じることはありませんが、何度も表示したり誤タップしてしまうとアカウント停止などのなんらかのペナルティがある可能性があります。
 +そのため、テスト時にはこのようにテスト用デバイスを設定することをお勧めします。
 +また、その時のためにこのようにAdRequestを作成するメソッドは別に用意しておいた方が、一カ所直せば良いので便利です。
 +
 +インタースティシャルの方は簡単です。
 +
 +   public void setInterstitialID(String interstitialID){
 +       interstitial = new InterstitialAd(activity);
 +       interstitial.setAdUnitId(interstitialID);
 +   }
 +
 +
 +   public void loadInterstitial(){
 +       interstitial.loadAd(makeAdRequest());
 +   }
 +
 +   public void showInterstitial(){
 +       if(interstitial.isLoaded()){
 +           interstitial.show();
 +       }
 +   }
 +
 +isLoadedはロード完了かどうかを判定するメソッドです。
 +
 +インタースティシャルは規約的にも注意するのは表示させすぎないぐらいで、それほど難しい部分はありません。
 +
 +*Androidアプリとしてのテスト [#w2a72b1c]
 +
 +次にANEAdmobクラスをAndroidでテストします。
 +まずappの下のbuild.gradleに次の一行を加えます。
 +
 + compile project(':aneadmob')
 +
 +さらにapp/src/main/AndroidManifest.xmlに次のパーミッションを加えます。
 +
 +   <uses-permission android:name="android.permission.INTERNET"/>
 +   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
 +
 +同じくAndroidManifest.xmlのapplicationタグの中に次を入れます。
 +
 +       <meta-data android:name="com.google.android.gms.version"
 +           android:value="@integer/google_play_services_version" />
 +
 +       <activity android:name="com.google.android.gms.ads.AdActivity"            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
 +           android:theme="@android:style/Theme.Translucent" />
 +
 +
 +
 +あとはonCreateメソッドにボタンを押したときの処理を入れます。
 +
 +     @Override
 +     protected void onCreate(Bundle savedInstanceState) {
 +         super.onCreate(savedInstanceState);
 +         setContentView(R.layout.activity_main);
 + 
 +         aneAdmob = new ANEAdmob(this);
 + 
 +         aneAdmob.setAppID(APP_ID);
 +         aneAdmob.setBannerID(BANNER_ID);
 +         aneAdmob.setInterstitialID(INTER_ID);
 + 
 +         Button button = (Button) findViewById(R.id.showBannerBtn);
 + 
 +         assert button != null;
 +         button.setOnClickListener(new View.OnClickListener() {
 +                                       @Override
 +                                       public void onClick(View v) {
 +                                           aneAdmob.showBanner();
 +                                       }
 + 
 +                                   }
 +         );
 + 
 +         button = (Button) findViewById(R.id.hideBannerBtn);
 + 
 +         assert button != null;
 +         button.setOnClickListener(new View.OnClickListener() {
 +                                       @Override
 +                                       public void onClick(View v) {
 +                                           aneAdmob.hideBanner();
 +                                       }
 + 
 +                                   }
 +         );
 +         button = (Button) findViewById(R.id.loadInterstitialBtn);
 + 
 +         assert button != null;
 +         button.setOnClickListener(new View.OnClickListener() {
 +                                       @Override
 +                                       public void onClick(View v) {
 +                                           aneAdmob.loadInterstitial();
 +                                       }
 + 
 +                                   }
 +         );
 + 
 +         button = (Button) findViewById(R.id.showInterstitialBtn);
 + 
 +         assert button != null;
 +         button.setOnClickListener(new View.OnClickListener() {
 +                                       @Override
 +                                       public void onClick(View v) {
 +                                           aneAdmob.showInterstitial();
 +                                       }
 + 
 +                                   }
 +         );
 + 
 +     }
 +
 +これでテスト可能です。
 +
 +これで動かないと当然ながらANEにしたところで動きません。ANEへの変換は手間がかかるので、作業を能率化するにはこの段階で入念にテストしておく必要があります。
*ANE呼び出し処理の追加 [#i5cd3b6c] *ANE呼び出し処理の追加 [#i5cd3b6c]
 +Android上で問題なく実行されたら、ANEにするための処理を入れます。
 +
 +[[こちらを参考に:http://njf.jp/cms/modules/xpwiki/?Android%E3%81%A7%E3%81%AEANE%E3%81%AE%E4%BD%9C%E6%88%90%2FAndroid%E5%81%B4%E3%81%AE%E4%BD%9C%E6%88%90#a17e7947]]FlashRuntimeExtensions.jarをaneadmobの下のlibに配置します。
 +
 +最終的にaneadmobのbuild.gradleのdependencies以下に次の一行が挿入されていればOKです。
 +
 + compile files('libs/FlashRuntimeExtensions.jar')
 +
 +次にActionScriptから呼び出される部分を作ります。
 +
 +呼び出しには次の二つのクラスが必要です。
 +
 +|名前|機能|インターフェイス|
 +|ANEAdmobFREExtension|呼び出しの定義と振り分け処理|FREExtension|
 +|ANEAdmobFREFunction|実際に呼び出される関数|FREFunction|
 +
 +ここではこれらのクラスをjp.njf.aneadmobパッケージとして制作します。
 +
 +ここで呼び出されるクラスの設計には二つの選択肢があります。
 +呼び出される関数はFREFunctionをimplementsしておくと、その中のcallメソッドが呼ばれます。
 +
 +よって呼び出しメソッドの数だけクラスを作るか、一つのクラスを作って内部的に振り分けるか、という設計があり得ます。
 +
 +前節のように、このANEには7つのメソッドがあるので、7つもクラスを作るのは面倒です。よって一つのクラスを作って第一引数を使って処理の分岐を行うようにします。そのクラスが上記のANEAdmobFREFunctionで、メソッドの数だけクラスがないのはそのためです。
 +
 +ただし、メソッドごとにクラスを作った方が呼び出しエラーなどがFlash側のtraceメッセージなどと一緒に表示されるため、デバッグは楽です。自分で振り分けする場合は、もちろん自分でエラー処理もしなくてはなりません。
 +
 +このように一長一短ありますので、場合に応じて設計を変えて下さい。
 +
 +
 +
 +まずANEAdmobFREExtensionクラスのcreateContextメソッドです。"admob"という名前で呼び出せるようにしておきます。
 +
 +   @Override
 +   public FREContext createContext(String s) {
 +       FREContext context = new FREContext() {
 +           @Override
 +           public Map<String, FREFunction> getFunctions() {
 +               Map<String, FREFunction> result = new HashMap<String, FREFunction>();
 +               result.put("admob", new ANEAdmobFREFunction());
 +               return result;
 +           }
 + 
 +           @Override
 +           public void dispose() {
 + 
 +           }
 +       };
 +       return context;
 +   }
 +
 +特に難しい部分はないはずです。分からない部分があれば「[[AndroidでのANEの作成/Android側の作成]]」を参照してください。
 +
 +次にANEAdmobFREFunctionのcallメソッドです。
 +第一引数をメソッドの振り分けに、第二引数をパラメータとして使っています。
 +
 +   public FREObject call(FREContext freContext, FREObject[] freObjects) {
 +       String method = "";
 +       String prm = "";
 +       try {
 +           method = freObjects[0].getAsString();
 +       } catch (Exception e) {
 +           Log.e("njf.jp.aneadmob", "ANEAdmobFREFunction:can't parse : arg 0");
 +       }
 +       try {
 +           prm = freObjects[1].getAsString();
 +       } catch (Exception e) {
 +           Log.w("njf.jp.aneadmob", "ANEAdmobFREFunction:can't parse : arg 1");
 +       }
 + 
 +       if(aneAdmob == null){
 +           aneAdmob = new ANEAdmob(freContext.getActivity());
 +       }
 + 
 +       if(method.equals("setAppID") && !prm.equals("")){
 +           aneAdmob.setAppID(prm);
 +       }else if(method.equals("setBannerID") && !prm.equals("")){
 +           aneAdmob.setBannerID(prm);
 +       }else if(method.equals("setInterstitialID") && !prm.equals("")){
 +           aneAdmob.setInterstitialID(prm);
 +       }else if(method.equals("showBanner")){
 +           aneAdmob.showBanner();
 +       }else if(method.equals("hideBanner")){
 +           aneAdmob.hideBanner();
 +       }else if(method.equals("showInterstitial")){
 +           aneAdmob.showInterstitial();
 +       }else if(method.equals("loadInterstitial")){
 +           aneAdmob.loadInterstitial();
 +       }else{
 +           Log.e("njf.jp.aneadmob", "ANEAdmobFREFunction:no method or invalid prm " + method);
 +       }
 +       return null;
 +   }
 +
 +
 +こちらも分からない部分があれば「[[AndroidでのANEの作成/Android側の作成]]」を参照してください。
 +
 +*jarファイルの取り出し [#re49287b]
 +
 +jarファイルの取り出しについては、[[こちらの記事:http://njf.jp/cms/modules/xpwiki/?Android%E3%81%A7%E3%81%AEANE%E3%81%AE%E4%BD%9C%E6%88%90%2FAndroid%E5%81%B4%E3%81%AE%E4%BD%9C%E6%88%90#veeed4bc]]と同じです。
 +ツールバーの「Build->Rebuild Project」でビルドし直して、aneadmob-release.aarファイルを探し出し、zip解凍してください。必要なのは「classes.jar」のみです。
-制作中+---- 
 +-[[AndroidでのAdmobのANEの作成]]にもどる 
 +-[[AndroidでのAdmobのANEの作成_swcの作成]]に進む
トップ   編集 差分 バックアップ 添付 複製 名前変更 リロード印刷に適した表示   ページ新規作成 全ページ一覧 単語検索 最新ページの一覧   ヘルプ   最新ページのRSS 1.0 最新ページのRSS 2.0 最新ページのRSS Atom Powered by xpWiki
ぺージ情報
ぺージ名 :AndroidでのAdmobのANEの作成_Android側の作成
ページ別名 :未設定
ページ作成 :njf
閲覧可
グループ :すべての訪問者
ユーザー :すべての訪問者
編集可
グループ :すべての訪問者
ユーザー :すべての訪問者
Counter: 2785, today: 1, yesterday: 2

サイト管理: njf

MenuBar
20 最新の0件
広告

ログイン

ユーザー名:


パスワード:





パスワード紛失

Portuguese | English | German | Greek | Japanese | Korean | Russian | T-Chinese top
NJF