Unityの1つのコードで2つのモバイルプラットフォームを接続する

Unity開発者は、iOSやAndroidなどのプラットフォームでゲームストリームとサービスを管理することにすでに慣れています。ただし、Huaweiモバイルサービスがエコシステムに登場した後、Huaweiデバイスを持っているプレーヤーにリーチしたい場合は、ゲームの別のバージョンをサポートする必要があります。



この記事では、最小限の労力で1つのコードベースで複数のAndroidモバイルサービスとHuaweiモバイルサービス間の依存関係を管理する方法について説明します。









図1.さまざまなプラットフォームとモバイルサービスのサポートの違い上



の図でわかるように、Huawei携帯電話はAndroidオペレーティングシステムを使用しているため、Unityプロジェクトはこの会社のデバイス用にビルドするときにそれを使用する必要があります。ただし、Android用に2つの異なるAPKを開発するか、HuaweiAppGallery用に別のパッケージを開発する必要があります。

これらのAPKの違いは何ですか？

何よりも重要な違いはモバイルサービスです。これらは、アプリ内購入、広告、ゲームサービス、分析などのサービスです。HuaweiモバイルデバイスではGMSを使用できません。このため、HuaweiAppGalleryとGooglePlayでリリースするために2つのAPKを作成する必要があります。



2番目の同様に重要な違いはパッケージ名です。両方のエコシステムはAndroidで実行されるため、不整合やオーバーライドを回避するために、Huawei App Galleryには、パッケージ名が.huaweiまたは.HUAWEIで終わる必要があるというルールがあります。このアプローチは、Huaweiビルドを他のすべてのAndroidデバイスから分離するために使用されます。



ただし、心配しないでください。これらの違いは1つのコードベースで処理できます。



これらの問題を解決するのに役立つ2つの小さなトリックがあります。



1. #definesについて聞いたことがありますか？



定義のおかげで、ビルド時、および単一の開発環境のおかげで、そしてコーディング中にスレッドを制御できます。



私たちはどのストリームについて話しているのですか？



GooglePlayとHuaweiの2種類のゲームサービスを運用する必要があると想像してみてください。それらのアプリケーションを1つのコードで作成するには、定義を使用してアプリケーションを分離できます。小さな例を見てみましょう：

internal static class GameServiceFactory
{
    public static IGameServiceProvider CreateGameServiceProvider()
    {
        #if HMS_BUILD
            return new HMSGameServiceProvider();
        #else
            return new GooglePlayGameServiceProvider();                        
        #endif
    }
}

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

「HMS_BUILD」キーワードを定義リストに追加すると、ゲームはHMSGameServiceProviderを呼び出します。このようにして、1つのコードでスレッドを管理できます。



以下のスクリプトを使用して、アセンブリの前に定義を操作できます。 DefineKeywordsを変更して保存すると、IDEは指定したキーワードに従ってコードフローを更新します。

public class ManageDefines : Editor
 {
     /// <summary>
     /// Symbols that will be added to the editor
     /// </summary>
     public static readonly string [] DefineKeywords = new string[] {
        //"TEST_VERSION",
        "HMS_BUILD",
        //"GMS_BUILD",
     };
  
     /// <summary>
     /// Add define symbols as soon as Unity gets done compiling.
     /// </summary>
     static AddDefineSymbols ()
     {
         List<string> allDefines = new List<string>();
         allDefines.AddRange ( DefineKeywords.Except ( allDefines ) );
         PlayerSettings.SetScriptingDefineSymbolsForGroup (
             EditorUserBuildSettings.selectedBuildTargetGroup,
             string.Join ( ";", allDefines.ToArray () ) );
     }
 }

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

2.ビルド前後のスクリプト（ビルド前とビルド後）



したがって、前述のように、HuaweiAppGalleryバージョンのゲームのパッケージ名を変更する必要があります。



ただし、Google Playサービスを同時に使用している場合、すべての構成は既存のパッケージ名に関連付けられ、変更すると構成に影響します。さらに、ポップアップウィンドウのUnityエディターは、パッケージ名とモバイルサービスの構成が異なるため、アプリケーションパッケージ名を修正するように警告することがあります。このポップアップを何度も閉じるのは非常に面倒です。



この問題を解決し、2つの異なるパッケージ名を同時に管理するために、定義付きのビルド前およびビルド後のスクリプトで回避策を使用できます。



このコードを見てください：

class MyCustomBuildProcessor : IPreprocessBuildWithReport, IPostprocessBuildWithReport
{
    public int callbackOrder { get { return 0; } }

    public void OnPostprocessBuild(BuildReport report)
    {
        PlayerSettings.SetApplicationIdentifier(BuildTargetGroup.Android, "your.package.name");
    }

    public void OnPreprocessBuild(BuildReport report)
    {
        #if HMS_BUILD
            PlayerSettings.SetApplicationIdentifier(BuildTargetGroup.Android, "your.package.name.huawei");
        #elif GMS_BUILD
            PlayerSettings.SetApplicationIdentifier(BuildTargetGroup.Android, "your.package.name");
        #endif
    }
}

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

ご覧のとおり、すべてがシンプルです。定義の助けを借りて、HMS_BUILDのプレビルド中にのみパッケージ名を変更できます。次に、ビルド後、パッケージ名を元の名前に戻すことができます。そうすると、Unityはパッケージ名の不一致について警告しなくなります。



それで全部です。これで、HuaweiとGooglePlayの1つのコードで同時にゲームを開発する準備が整いました。

アプリケーション開発例

ゲームサービス、ゲーム内購入、広告など、AndroidとHuaweiの同じコードベースでアプリケーションを作成しましょう。



これは単なるデモであるため、各サービスのすべての機能を実装するわけではありません。各機能を自分で拡張できます。

サービスモジュールの構造

図2.サービスモジュールの操作スキームサービス



ごとに独自のものがあります。

• マネージャー：このクラスには、サービスのゲームロジックが含まれ、一般的な機能を管理します。さまざまなゲームで、要件に合わせてこのクラスを変更する必要がある場合があります。
• ファクトリクラス（ファクトリ）：このクラスには、プロバイダーを選択するためのロジックが含まれています。私たちのアプローチでは、定義を使用しますが、プロバイダーの選択メカニズムを好みに合わせて変更できます。
• プロバイダー：サービスごとに、独自のプロバイダーを作成する必要があります。プロジェクトとモバイルサービス間のすべての依存関係は、このクラス内にとどまる必要があります。
• プロバイダーインターフェイス：さまざまなモバイルサービスの使用を統合するには、共通のプロバイダーが必要です。この目的のために、プロバイダーインターフェイスが作成されます。ゲームの要件に従って、モバイルサービスからゲームで使用するすべてのメソッドを定義する必要があります。

必要に応じて、以下を有効にすることもできます。

• 一般的なエンティティ：ゲームから一部のサービスを抽象化するには、一般的なエンティティが必要になる場合があります。プロバイダークラスのみへの依存関係を維持するために、要件に従って汎用エンティティを使用できます。
• ジェネリックリスナー：ジェネリックエンティティと同様に、ジェネリックリスナーが必要な場合は、それらを作成することもできます。

図3.ゲームサービスモジュールの構造



例次に、例を見て、記事で説明されている方法で何ができるかを理解してみましょう。



ゲームロジックからモバイルサービスを抽象化するために、マネージャーを使用します。マネージャーは、ファブリックを介してプロバイダーと通信します。このようにして、プラグインなどのプロバイダーを使用できます。アクセスしたいメソッドを含む共通のインターフェースを実装する必要があります。

public interface IGameServiceProvider
{
    void Init();
    bool IsAuthenticated();
    void SignOut();
    void AuthenticateUser(Action<bool> callback = null);
    void SendScore(int score, string boardId);
    void ShowLeaderBoard(string boardId = "");
    void ShowAchievements();
    void UnlockAchievement(string key);
    CommonAuthUser GetUserInfo();
}

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

次に、サービスインターフェイスを実装するプロバイダーが少なくとも1つ必要です。前述のように、ゲームとサードパーティのモバイルサービス間のすべての依存関係は、このクラス内にとどまる必要があります。HuaweiとGooglePlayの2つのプロバイダーを作成しましょう。



ここにいくつかのコード例があります。記事の最後にあるGitHubのプロジェクトでそれらを見つけることができます。

Huaweiゲームサービスプロバイダー

public class HMSGameServiceProvider : IGameServiceProvider
 {
      private static string TAG = "HMSGameServiceProvider";

      private HuaweiIdAuthService _authService;
      private IRankingsClient _rankingClient;
      private IAchievementsClient _achievementClient;

      public AuthHuaweiId HuaweiId;

      public CommonAuthUser commonAuthUser = null;

      public void Init()
      {
          InitHuaweiAuthService();
      }

      ....
        
}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

Googleゲームサービスプロバイダー

public class GooglePlayGameServiceProvider : IGameServiceProvider
{
    private static string TAG = "GooglePlayServiceProvider";

    private PlayGamesPlatform _platform;

    public CommonAuthUser commonAuthUser = null;

    public void Init()
    {
        InitPlayGamesPlatform();
    }

    ....
}

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

次に、マネージャーとファクトリクラスを作成する必要があります。次に、定義に従ってプロバイダーを取得します。

public class GameServiceManager : Singleton<GameServiceManager>
{
        public IGameServiceProvider provider;

        protected override void Awake()
        {
            base.Awake();
            provider = GameServiceFactory.CreateGameServiceProvider();
        }
        
        .....
        
}

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

これは私たちのファクトリークラスがどのように見えるかです：

internal static class GameServiceFactory
{
    public static IGameServiceProvider CreateGameServiceProvider()
    {
        #if HMS_BUILD
            return new HMSGameServiceProvider();
        #else
            return new GooglePlayGameServiceProvider();                        
        #endif
    }
}

      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

これで、マルチプロバイダーゲームサービスの機能を管理できるGameManagerクラスができました。



GameServicesを初期化するには、必要に応じて次のコード行を使用します。

public class MainSceneManager : MonoBehaviour
{
    void Start()
    {
        GameServiceManager.Instance.Init();
        
        ....
        
    }
    
    ....
    
    private void OnClickedScoreBoardButton()
    {
        GameServiceManager.Instance.provider.ShowLeaderBoard();
    }

    private void OnClickedAchievementButton()
    {
        GameServiceManager.Instance.provider.ShowAchievements();
    }
    
    ....
}


      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

すべてのサービスモジュールは同じロジックと構造を持っているため、各サービスモジュールの作業については説明しません。プロジェクトからGitHubにコードをコピーすることで、実際の動作を確認できます。



また、UnityでHuaweiプラグインを設定する方法についてのガイダンスが必要な場合は、この投稿で説明され ています。



結論に移りましょう。



DefineConfig.csでHMS_BUILDとGMS_BUILDの間で定義を変更するには、次のようにします。

1. HuaweiAppGalleryとGooglePlayの2つの異なるAPKまたはパッケージを入手できます。
2. HMSとGMSの間で、ログインとログアウトの機能、リーダーボード、実績、ゲーム内購入が変化しています。

以下は、両方のアセンブリの短いビデオです。



「HMS_BUILD」の







場合：「GMS_BUILD」の 場合：







デモプロジェクトとHMSおよびGMS用に準備されたAPKは、GitHubのリンクにあり ます。