HTTPDNS:Unity 統合ガイド

1.3.1 Unity パッケージのインポート

1. httpdns_unity_demo ディレクトリをダウンロードします。

2. Assets/Plugins ディレクトリ全体をご利用の Unity プロジェクトにコピーします。

3. Assets/Editor ディレクトリ (オプション、テスト UI の作成に使用) をご利用のプロジェクトにコピーします。

プロジェクトの構造は次のようになります:

YourUnityProject/
├── Assets/
│   ├── Plugins/
│   │   ├── HttpDnsHelper.cs           # メインインターフェイスファイル
│   │   ├── AndroidHttpDnsHelper.cs     # Android プラットフォーム実装
│   │   ├── iOSHttpDnsHelper.cs        # iOS プラットフォーム実装  
│   │   ├── CHttpDnsHelper.cs          # C SDK プラットフォーム実装
│   │   ├── Android/                   # Android JAR ライブラリ
│   │   ├── iOS/                       # iOS ブリッジファイル
│   │   └── C/                         # C SDK
│   └── Editor/                        # テスト UI クリエーター
├── ProjectSettings/
└── ...

1.3.2 ネイティブ SDK バージョンの確認

このプラグインは、対応するプラットフォーム用のネイティブ HTTPDNS SDK を統合しています。現在のバージョンは次のとおりです：

• Android: com.aliyun.ams:alicloud-android-httpdns:2.6.5

• iOS: AlicloudHTTPDNS:3.2.1

• C: alibabacloud-httpdns-c-sdk:2.2.5

2.2.1 Android SDK バージョンの更新

Android SDK は Maven の依存関係を通じて管理されます。Assets/Plugins/Android/mainTemplate.gradle の dependencies セクションでバージョン番号を変更します：

dependencies {
    // 他の依存関係...
    implementation 'com.aliyun.ams:alicloud-android-httpdns:2.6.5' // 必要なバージョンに変更
}

Android、iOS、および C プラットフォームの API 操作は異なる場合があることにご注意ください。詳細については、各プラットフォームの公式ドキュメントをご参照ください。

カスタム Gradle テンプレート (Custom Main/Base Gradle Template、Custom Proguard) を有効にすると、Unity Build はリポジトリから対応するバージョンを自動的にプルします。

利用可能なバージョンについては、「Android SDK リリースノート」をご参照ください。

2.2.2 iOS SDK バージョンの更新

ビルド後のプロセッサで CocoaPods の依存関係バージョンを編集します:

// HttpDnsIOSPostProcessor.cs でバージョンを更新
podfileContent += "  pod 'AlicloudHTTPDNS', '~> 3.2.1'\n";

// 必要なバージョンに更新
podfileContent += "  pod 'AlicloudHTTPDNS', '~> new_version_number'\n";

利用可能なバージョンについては、「iOS SDK リリースノート」をご参照ください。

2.2.3 C SDK バージョンの更新

次の手順を実行します:

• 更新された C SDK のソースコードをダウンロードします。

• ローカルマシンでソースコードをコンパイルして、ネイティブライブラリファイルを生成します。

• 生成されたライブラリファイルを Unity プロジェクトのプラグインディレクトリに配置します。たとえば、Windows 用の .dll ファイルまたは macOS 用の .dylib ファイルを Assets/Plugins/C/x86_64/ ディレクトリに配置します。

• Unity に戻り、プロジェクトをリビルドして変更を有効にします。

詳細とバージョンの詳細については、「C SDK リリースノート」をご参照ください。

2.2.4 プロジェクトのリビルド

バージョンを更新した後、プロジェクトをリビルドする必要があります。

Android:

# Unity エディター内
File -> Build Settings -> Android -> Build

iOS:

# Unity エディターでビルド後、cd [iOS ビルドディレクトリ]
pod install --repo-update
open Unity-iPhone.xcworkspace

C (Windows/macOS):

# Unity エディター内
File -> Build Settings -> PC, Mac & Linux Standalone -> Build

3.1.1 ログ構成

アプリケーション開発中に、ログ出力制御メソッドを呼び出すことで HTTPDNS のログ記録を有効にできます。以下のコードは例です：

HttpDnsHelper.debug(true);
Debug.Log("Log output is enabled");

3.1.2 SessionId の記録

アプリケーションの実行中に、getSessionId メソッドを呼び出して sessionId を取得し、アプリケーションのデータ収集システムに記録できます。sessionId は特定のアプリケーションセッションを識別します。これを使用して、オンラインでのトラブルシューティング中に特定のセッションの名前解決ログをクエリできます。以下のコードは例です：

string sessionId = HttpDnsHelper.getSessionId();
Debug.Log($"SessionId = {sessionId}");

3.2 ドメイン名の名前解決

var hosts = new List<string> { "www.aliyun.com", "www.example.com" };
HttpDnsHelper.setPreResolveHosts(hosts, "both");
Debug.Log("Preresolution is set successfully");

public void ResolveDomain(string hostname)
{
    // 同期非ブロッキング解決
    var result = HttpDnsHelper.resolveHostSyncNonBlocking(hostname, "auto");
    if (result != null)
    {
        Debug.Log($"IPv4 addresses: {result.IPv4.Count}");
        Debug.Log($"IPv6 addresses: {result.IPv6.Count}");
        Debug.Log($"TTL: {result.TTL} seconds");
    }
}

4.2.1 HttpClient

using System;
using System.Net.Http;
using UnityEngine;

public class HttpDnsHttpClient : MonoBehaviour
{
    private static readonly HttpClient httpClient = new HttpClient();
    
    public async void MakeRequest(string url)
    {
        try
        {
            var uri = new Uri(url);
            string hostname = uri.Host;
            
            // HTTPDNS を使用してドメイン名を解決
            var result = HttpDnsHelper.resolveHostSyncNonBlocking(hostname, "auto");
            if (result != null && result.IPv4 != null && result.IPv4.Count > 0)
            {
                string resolvedIP = result.IPv4[0];
                string newUrl = url.Replace(hostname, resolvedIP);
                
                using (var requestMessage = new HttpRequestMessage(HttpMethod.Get, newUrl))
                {
                    // 重要: SSL/SNI の正確性を確保するために Host ヘッダーを設定
                    requestMessage.Headers.Host = hostname;
                    
                    var response = await httpClient.SendAsync(requestMessage);
                    string content = await response.Content.ReadAsStringAsync();
                    
                    Debug.Log($"Request successful: {response.StatusCode}");
                }
            }
        }
        catch (Exception e)
        {
            Debug.LogError($"Request failed: {e.Message}");
        }
    }
}

4.2.2 HttpWebRequest

using System;
using System.IO;
using System.Net;
using UnityEngine;

public class HttpDnsWebRequest : MonoBehaviour
{
    public void MakeRequest(string url)
    {
        try
        {
            var uri = new Uri(url);
            string hostname = uri.Host;
            
            // HTTPDNS を使用してドメイン名を解決
            var result = HttpDnsHelper.resolveHostSyncNonBlocking(hostname, "auto");
            if (result != null && result.IPv4 != null && result.IPv4.Count > 0)
            {
                string resolvedIP = result.IPv4[0];
                string newUrl = url.Replace(hostname, resolvedIP);
                
                HttpWebRequest request = (HttpWebRequest)WebRequest.Create(newUrl);
                request.Method = "GET";
                // 重要: SSL/SNI の正確性を確保するために Host ヘッダーを設定
                request.Host = hostname;
                
                using (HttpWebResponse response = (HttpWebResponse)request.GetResponse())
                using (Stream stream = response.GetResponseStream())
                using (StreamReader reader = new StreamReader(stream))
                {
                    string content = reader.ReadToEnd();
                    Debug.Log($"Request successful: {response.StatusCode}");
                }
            }
        }
        catch (Exception e)
        {
            Debug.LogError($"Request failed: {e.Message}");
        }
    }
}

4.2.3 UnityWebRequest (非推奨)

using System;
using System.Collections;
using UnityEngine;
using UnityEngine.Networking;

public class HttpDnsUnityWebRequest : MonoBehaviour
{
    public IEnumerator MakeRequest(string url)
    {
        var uri = new Uri(url);
        string hostname = uri.Host;
        
        // HTTPDNS を使用してドメイン名を解決
        var result = HttpDnsHelper.resolveHostSyncNonBlocking(hostname, "auto");
        if (result != null && result.IPv4 != null && result.IPv4.Count > 0)
        {
            string resolvedIP = result.IPv4[0];
            string newUrl = url.Replace(hostname, resolvedIP);
            
            using (UnityWebRequest request = UnityWebRequest.Get(newUrl))
            {
                // 重要: Host ヘッダーを設定
                request.SetRequestHeader("Host", hostname);
                
                yield return request.SendWebRequest();
                
                if (request.result == UnityWebRequest.Result.Success)
                {
                    Debug.Log($"Request successful: {request.responseCode}");
                }
                else
                {
                    Debug.LogError($"Request failed: {request.error}");
                }
            }
        }
    }
}

init

HTTPDNS サービスを初期化します。

// 基本的な初期化
HttpDnsHelper.init(string accountId, string secretKey);

// 完全な初期化
HttpDnsHelper.init(string accountId, string secretKey, string aesSecretKey);

パラメーター:

• accountId： HTTPDNS アカウント ID (必須)。

• secretKey： AccessKey ペア (オプション、認証に使用)。

• aesSecretKey： AES 暗号鍵 (オプション、暗号化に使用)。

build

HTTPDNS サービスインスタンスをビルドします。すべての設定を行った後にこのメソッドを呼び出します。

bool success = HttpDnsHelper.build();

戻り値:

• true： インスタンスは正常にビルドされました。

• false： インスタンスのビルドに失敗しました。

debug

デバッグログを出力するかどうかを制御します。

HttpDnsHelper.debug(bool enable);

setHttpsRequestEnabled

DNS クエリに HTTPS を使用するかどうかを設定します。

HttpDnsHelper.setHttpsRequestEnabled(bool enable);

setTimeout

DNS クエリのタイムアウト期間を設定します。

HttpDnsHelper.setTimeout(int timeoutMs);

setPersistentCacheIPEnabled

永続キャッシュを有効にするかどうかを設定します。

HttpDnsHelper.setPersistentCacheIPEnabled(bool enable, int cacheTTL);

パラメーター：

• enable: 機能を有効にするかどうかを指定します。

• cacheTTL: キャッシュの存続時間 (TTL) (秒単位)。

setReuseExpiredIPEnabled

期限切れの IP アドレスの再利用を許可するかどうかを設定します。

HttpDnsHelper.setReuseExpiredIPEnabled(bool enable);

setPreResolveAfterNetworkChanged

ネットワークが変更されたときに、事前解決されたドメイン名を自動的に更新するかどうかを設定します。

HttpDnsHelper.setPreResolveAfterNetworkChanged(bool enable);

getIpsByHostAsync

ドメイン名を非同期で解決します。

List<string> ips = HttpDnsHelper.getIpsByHostAsync(string hostname);

戻り値： IP アドレスのリスト。解決に失敗した場合は、null または空のリストを返します。

getIpsByHost

ドメイン名を同期的に解決します。

List<string> ips = HttpDnsHelper.getIpsByHost(string hostname);

resolveHostSyncNonBlocking

同期非ブロッキング名前解決を実行し、詳細情報を返します。

HttpDnsResult result = HttpDnsHelper.resolveHostSyncNonBlocking(string hostname, string ipType);

パラメーター:

• hostname: 解決するドメイン名。

• ipType： IP アドレスの種類 ("auto"、"ipv4"、"ipv6"、または "both")。

返されるオブジェクトには以下が含まれます:

• IPv4: IPv4 アドレスのリスト。

• IPv6: IPv6 アドレスのリスト。

• TTL： キャッシュの TTL。

• Extra: 追加情報。

setPreResolveHosts

事前解決するドメイン名のリストを設定します。

// 単一のドメイン名
HttpDnsHelper.setPreResolveHosts(string hostname);

// 複数のドメイン名
HttpDnsHelper.setPreResolveHosts(List<string> hostnames, string ipType);

clearCache

指定したドメイン名のキャッシュをクリアします。

HttpDnsHelper.clearCache();

cleanAllHostCache

すべてのドメイン名のキャッシュをクリアします。

HttpDnsHelper.cleanAllHostCache();

getSessionId

現在のセッション ID を取得します。

string sessionId = HttpDnsHelper.getSessionId();