【UE5】広告をつけてAndroidアプリ配信

開発者向けオプション有効化
設定>デバイス情報
(機種によって項目は異なるが、ビルド番号はあるはず。)
ビルド番号を7回タップ。
USBデバッグON
設定>開発者向けオプション
USBデバッグをONにする。

下の表示でてアプリの起動ができない現象がおきた。
おそらくProject SettingsのBuild ConfigurationがShippingだから。
Developmentに修正したら正常にアプリを起動できた。
だがDevelopmentにしていても、この表示がでることもあった。
そのときは、プロジェクトをRestartするだけで表示はでなくなった。
原因は分からない。

ちなみに、PlatformsからBINARY CONFIGURATIONをDevelopmentにしても、上の現象は直らなかった。偶然かもしれないが。

5.1でC++のプロジェクトを作ろうとしたら、下記の表示がでた。

下のサイト(上記表示に書いてあるURL)に行くと、自動的にexeファイルがダウンロードされるので実行。

Download .NET 6.0 Runtime (v6.0.11) - Windows x64 Installer

dotnet.microsoft.com

6.0.11が追加された。この状態ならばC++プロジェクトを作ることができた。

https://wa3.i-3-i.info/word12258.html

wa3.i-3-i.info

起きたエラー
UEのVerを5.1にしてC++を使用した場合下記のエラーがでてAndroidで実機プレイできなかった。
（C++を使わない場合は実機プレイできた。）

LogPlayLevel: Error: UAT: ld.lld: error: undefined symbol: __aarch64_swp8_acq_rel

解決方法

NDKのVerが古いのが原因。
Android Studio4.0をDefaultでインストールした状態から、NDKのVerを書き換える方法を下に示す。
Android StudioのVerが4.0でない人はこちらからinstall。

まず、任意のプロジェクトをAndroid Studioで開く。
上のメニューバーからTools>SDK Managerを選択する。

出てきたウィンドウの中で、SDKToolsのタブをクリック。

その後、Show Packge Detailsのチェックボックスにチェックを入れる。

25.1.8937393のVerにチェック。
以前のVerのチェックを外すことでuninstallできる。(任意)

OKをクリック。

Finishをクリック。

Project Settingsで忘れずに設定。

参考

Error: UAT: ld.lld: error: undefined symbol: __aarch64_swp8_acq_rel UE5.1

Hello, 🙂 I have a problem when I build a package android project for Quest2 in UE5.1. My config worked in UE5.0. Maybe anyone has the same problem ^^? ####...

forums.unrealengine.com

Android

Android デバイス向けプロジェクトのビルド方法を学習します。

docs.unrealengine.com

Android Studio download archives  |  Android Developers

This page provides a download archive of Android Studio releases.

developer.android.com

NDK と CMake のインストールと設定  |  Android Studio  |  Android Developers

developer.android.com

アダプティブアイコンをつかうことで、アイコンの背景を指定できる。

アダプティブアイコンを使用しないと、アイコンの形によっては背景が白くなる。

👇基本的には公式ドキュメントに沿って進めるが、記述の間違いが多いので注意。

UE4 による Android のためのプロジェクトにアダプティブ アイコンを追加する方法

アダプティブ アイコン作成のための手順をご紹介します。さまざまな機種で使われている多様なアイコンの図形を表示できるようになります。  

www.unrealengine.com

間違い
・コードのタグのはじめに不要な!がついているので修正する。
・アイコンの名前はicon_round.pngではなく、icon_round_bg.pngにする。

やること

・icon_bg.pngとicon_round_bg.pngを作成。

・作成したアイコンをBuild/Android/res/drawableのフォルダに入れる。
・icon.xml、icon_round.xml、AddRoundIcon_UPL.xmlのファイルを作成。
・Build/Android/resにdrawable-anydpi-v26という名前のフォルダを作成。
・icon.xmlとicon_round.xmlをdrawable-anydpi-v26のフォルダに入れる。
・AddRoundIcon_UPL.xmlをSource/モジュール名のフォルダに入れる。

・モジュール名.Build.csにコードを追記する。

アイコン画像(名前修正済み)

icon_bg.png：108×108の画像。内側72×72に重要なものを配置。
icon_round_bg：108×108の画像。表示範囲は中心から半径72pxの円の中だと思われる。
コード(修正したもの)

icon.xml

<!--?xml version="1.0" encoding="utf-8"?-->
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
    <background android:drawable="@drawable/icon_bg">
</background></adaptive-icon>

icon_round.xml

<!--?xml version="1.0" encoding="utf-8"?-->
<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
    <background android:drawable="@drawable/icon_round_bg">
</background></adaptive-icon>

AddRoundIcon_UPL.xml

<!--?xml version="1.0" encoding="utf-8"?-->
<root xmlns:android="http://schemas.android.com/apk/res/android">
	<!-- init section is always evaluated once per architecture -->
	<init>
	</init>

	<androidmanifestupdates>
		<!-- add roundIcon attribute to application -->
		<addattribute name="”android:roundIcon”" tag="”application”" value="”@drawable/icon_round”/">
	</addattribute></androidmanifestupdates>
</root>

👇if文が追加されたコード。
モジュール名.Build.cs

// Fill out your copyright notice in the Description page of Project Settings.

using UnrealBuildTool;

public class モジュール名 : ModuleRules
{
	public モジュール名(ReadOnlyTargetRules Target) : base(Target)
	{
		PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;
	
		PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore" });

		PrivateDependencyModuleNames.AddRange(new string[] {  });

        // Uncomment if you are using Slate UI
        // PrivateDependencyModuleNames.AddRange(new string[] { "Slate", "SlateCore" });

        // Uncomment if you are using online features
        // PrivateDependencyModuleNames.Add("OnlineSubsystem");

        // To include OnlineSubsystemSteam, add it to the plugins section in your uproject file with the Enabled attribute set to true

        if (Target.Platform == UnrealTargetPlatform.Android)
        {
            // Add UPL to add configrules.txt to our APK
            string PluginPath = Utils.MakePathRelativeTo(ModuleDirectory, Target.RelativeEnginePath);
            AdditionalPropertiesForReceipt.Add("AndroidPlugin", System.IO.Path.Combine(PluginPath, "AddRoundIcon_UPL.xml"));
        }
    }
}

クリスタで画像作る場合、こんな感じのグリッドを入れておくと、内側の72pxが分かりやすいはず。

確認箇所
検索Boxの使用しようして設定していくと良い。

Use Pak File : true (Default)
Use Io Store : false
Create compressed cooked packages : true (Default)
Include Crash Reporter : false
Exclude editor content when cooking : true (参考動画注意箇所。不具合があればfalseに)
Build Configuration : Shipping (スマホでの実機プレイのときはDevelopment)
Full Rebuild : true
For Distribution : true( IOSはfalseの方がいいらしい。)
Include Debug Files in Shipping Builds : false (Default)
Include prerequisites installer : true (Default)
Max Movable Spot Lights / Point Lights : 0（Movableを使っていないのならば）
Android Package Name : com.団体名.プロジェクト名。日本語NG。
Application Display Name : 任意の名前。日本語でもOK。
Target SDK Version : 31
Package game data inside .apk? : false (Default)(No OBBのErrorが出たらtrueに)
Disable verify OBB on first start/update. : true
Generate bundle (AAB) : true
Support arm64 : true (Default)
Distribution Signing : 少し複雑なので後で説明
【参考動画】

VersionCode
Project Settings>Platforms>Androidで設定。
初回の場合は、
Store Version : 1
Store Version offset (arm64) : 1
で良いと思う。
先ほどTarget SDK Versionを31と推奨した。すぐに変化すると思われるので数字を覚えておき、エラーがでたら変更できるようにしておく。
👇VersionCodeについて、こちらのブログに詳しく書いてある。

赤を緑に
Configure Nowで赤い部分を緑に。2か所ある。
また、これを押すことでProjectにBuildフォルダが作られる。
後ほどキーを生成して、このBuildフォルダに入れる。

Option
Framerateの設定
CookOnlyMapなど使用するMapの設定
👇Windowsのパッケージ化についてだが共通する部分は多い。まずはこの動画を見るべき。

アプリサイズを小さくするためにOFFにする。
OFFにしたPlugin
下記のプラグインOFFにすることで、内部テスト時のアプリサイズは42MB減少していた。
(OpenImageDenoiseの影響を除く)
参考として載せておきますが、プロジェクトによっては必要なものも多いと思うので自己責任でお願いします。OFFにする前にバックアップはしておいた方が良いと思います。

Actor Layer Utilities
Actor Sequence(Experimental)
AISupport
Alembic Importer
Animation Modifier Library
Animation Sharing
Apple Image Utils
Apple Movie Player
Asset Manager Editor
ArchVis Character
Asset Tags
Audio Capture
Audio Synesthesia
Automation Utilities
AVF Media Player
BackChannel
Blendspace Motion Analysis
Bridge
Cable Component
Camera Shake Previewer
Chaos Cloth
Chaos Niagara
Chaos Solver
Character AI
Chunk Downloader
CLion Integration
CodeLite Integration
Control Rig
CryptoKeys
Curve Editor Tools
Custom Mesh Component
Data Validation
Datasmith Content
Editor Scripting Utilities
Example Device Profile Selector
Facial Animation Bulk Importer
FastBuild Controller
Gameplay Cameras
GameplayTagsEdigtor
Geometry Cache
Geometry Processing
GeometryMode
Git
Image Sequence Media Player
IOS Device Profile Selector
Level Sequence Editor
Mac Graphic Switching
Media Player Editor
Movie Player for WebM files
Niagara
Online Subsystem iOS
OpenImageDenoise
Paper2D
Perforce
Plastic SCM
Procedual Mesh Component
Runtime PhysX Cooking
Skeltal Mesh Simplifier
SoundFields
SpeedTree Importer
Subversion
Trace Data Filtering
Variant Manager Content
Windows Device Profile Selector
Windows Movie Player
WMF Media Player
World Partition HLOD Utilities
XCode Integration
OFFにするのをやめたもの
👇コンテンツブラウザの表示がおかしくなる。
Content Browser – Asset Data Source
Content Browser – Class Data Source
👇たぶんOFFにすると実機プレイできない。OutputLogに警告がでた。
Online Subsystem NULL
不要なアセット

プラグインとは関係ないが、どのレベルでも使われていないものも消しておく。
使われていないものを探すフィルタ操作

Google Play Consoleにおける下記のエラーに対応するため、Android Play BillingのPluginを追加した。

👇Market Placeにおいて無料で購入できる。

Android Play Billing in Code Plugins - UE Marketplace

Android Play Billing plugin for Unreal Engine provides billing methods for buying consumable, non-consumable products and subscriptions.

www.unrealengine.com

購入したら、LauncherでInstall。

プラグインを適用する。

関連
Google Play Billing Library：定義が良く分からなかったので、最初のリリースノートを載せておく。

PowerShellを使う場合、ExecutionPolicyを変更しておかないとキーを生成できない。

PowerShellのアプリを検索して、管理者として実行をクリック。

下のコードを入力してEnterキーを押せば変更できる。

Set-ExecutionPolicy RemoteSigned

PowerShellにおけるディレクトリの移動方法。
下の階層への移動

cd ディレクトリ名

たまにしか触らないからすぐ忘れる。

上の階層への移動

cd ..

ディレクトリ名にスペースが入っているときは、”　”で囲む。

C:\> cd "Program Files"

国コード：日本の場合は+81 。今回は81を入力すれば良い。

組織単位：任意。僕はKishiroLaboratoryにした。

組織名：任意。僕はKishiroGameにした。

パスワード：任意。

👇リンクの説明通りに進めれば大丈夫

Play Console Help

Official Google Play Console Help Center where you can find tips and tutorials on using Google Play Console and other answers to frequently asked questions.

support.google.com

電話番号は国コード+81をつけて入力。
09011112222の場合、+819011112222になる。
登録料は25米ドル。

下記のエラーがでたら、Project SettingsのTarget SDK Versionを修正する。
下のエラーの場合は31に修正すれば大丈夫だった。

下のエラーがでたらUEのエディタに戻り、
Project Settings>Platforms>Android
から、Store Versionを変更する。

上の例の場合バージョンコード１が使用済みとのことなので、Store Versionを2などに設定すれば大丈夫。

リリースしたApp Bundle(.app)は、App Bundle エクスプローラから削除できる。レビューしただけなら削除できる。

しかし内部テストではあっても、一度公開すると削除できないので注意。
使用済みのVersionCodeが増えることに怖がることはない。充分な量が用意されている。
削除しようと頑張って、時間を不毛に使わないように注意。

👇これはプラグインで解決。詳しくはパッケージ化設定のところで説明済。

👇VersionCodeを以前よりも小さくするとだめらしい。

このエラーがでたときVersionCode1のBundleを使おうとしていた。
既にVersionCode4のBundleを使用していたので、それよりも小さいVersionCodeだったためにエラーが出たのだと思う。

GooglePlayConsoleでアップグレードできないAPKの対応方法 |

ある日、アプリをバージョンアップしてGooglePlayConsoleにアップロードするときに、エラーが発生しました。『エラー このリリースの公開を開始する前に、こちらのエラーをご確認ください。このページに記載されているエラーに対応して、既存のユーザーがアプリの最新バージョンにアップグレードできるようにしてください。 ...

breakcontinue.net

アプリ起動時に下記のメッセージが出た場合、
UEのエディタのProject Settingsより
Package game data inside .apk?をtrueにする。

ただし、サイズは大きくなるので別の解決策があると助かる。
僕はこれをtrueにしないと起動できなかった。
trueにした状態で、.aabファイルをAndroid Studioで開いたらOBBが入っていた。
サイズもtrueにしたことによる増加分と同じくらい。

プライバシーポリシーを書いたURLを用意する必要がある。
自分のブログが無かったら、まず無料ブログで良いので作成する。
その後、プライバシーポリシーを書いたページを作る。
英語の方が良さそうだったので下のサイトを使い作成した。

▷ Privacy Policy Template Generator || FREE & Easy || Try NOW!

Use our Privacy Policy Template Generator: ✅ No Registration Needed ✅ Free ✅ Done in a Few Minutes ✅ Personalized for your business or industry ⇒ Try it yoursel...

www.privacypolicytemplate.net

記載するものをまとめておく。

アプリ名
簡単な説明：80字まで
詳しい説明：4000字まで
（文字数は全角半角区別しない。）
アプリのアイコン：PNGかJPEG。1 MB以下、512 x 512 ピクセル
フィーチャーグラフィック：PNGかJPEG。15 MB 以下、1,024 x 500 ピクセル
Youtube動画URL：年齢制限なし、横向き
スクリーンショット
携帯電話版（たぶんスマホのこと）
2～8 枚アップロード。
PNGかJPEG。
8 MB 以下。
アスペクト比 16:9 または 9:16 。
縦横がそれぞれ 320～3,840 ピクセル。
プロモーションの対象：縦横がそれぞれ 1,080 ピクセル以上で4 枚以上アップロード。
タブレット

最大 8 枚アップロード。
他は携帯版と同じ。
10インチタブレット

縦横がそれぞれ 1,080～7,680 ピクセル。
他はタブレットと同じ。
クロームブック

4～8 枚アップロード。
縦横がそれぞれ 1,080～7,680 ピクセル。
他は10インチタブレットと同じ。

全ての端末で同じ画像を使用するのならば、

1920×1080が最小

2880×1620が中間

3840×2160が最大

（横向きの場合）

左側のメニューから選択し、設定できる。

指示に従い記入していく。

実装内容
起動時に広告がLoadされ、Loadが終わり次第表示される。
起動から5秒後に右下にボタンが現れ、押すと広告は消える。
アプリをBackgroundにするとき広告は消えて、
Foregroundに戻ってきたときに再び表示される。
広告自体に消すボタンはついているので、消すためのボタンは不要だったかと少し後悔。
ただ、自分で使うとき広告を消しやすいので残しておく。

MyGameInstance
ただのGameInstance。
Project SettingsのMap & Modesにおいて忘れずに設定する。
Make Banner Adの部分にAd Unit IDを入力する。
Positionによって位置の調整ができる。

テスト用Ad Unit ID(Androidのバナー広告)

ca-app-pub-3940256099942544/6300978111

テスト用Ad Unit ID(IOSのバナー広告)

ca-app-pub-3940256099942544/2934735716

WB_MainUI

起動後5秒したら、バナー広告を消すボタンが現れるようにした。

BP_MyPawn

EventBeginPlayでバナーを表示。

アプリを閉じたときにバナーを消し、アプリを再起動したときに再び表示するようにした。
ここの設定だけはC++が必要。

Google AdMobと検索して、Gmailアドレスを使えば登録はすぐできる。

Google AdMobにおいて、
ホーム>アプリ>アプリを追加

下記のように選択して「次へ」をクリック。

自分のアプリを見つけて追加をクリック。

何も選択せずに「次へ」をクリック。

「アプリを追加」をクリック。

審査がはじまる。完了をクリック。

👇その日のうちに承認された。

要素を２つ追加する。
Playゲームサービスを使わないのなら必要ないかもしれない。

コピペ用

com.google.android.gms.games.APP_ID="@string/app_id"

com.google.android.gms.version="@integer/google_play_services_version"

ちなみに、記入事項は以下の公式の説明を参考にしてみた。
記入の仕方が正しいかは分からない。

👇関係あるかも。google_play_services_versionと上で入れたが、versionは具体的なものを入れるのかも。

Google Play 開発者サービスをセットアップする  |  Google Play services  |  Google for Developers

developers.google.com

要素を２つ追加する。

コピペ用

com.android.vending.BILLING

android.permission.INTERNET

とりあえず、作成してアプリの名前だけ記入しておいた。

これも名前だけ。

名前だけ。

…。