Android & iOS

v4.25.6.0¶

ダウンロード¶

開発環境¶

Cocos2d-x¶

• Cocos2d-x 3.17.2

アンドロイド¶

iOS¶

• Xcode 16.1 以上
• Xcode のバージョンは、Apple App Store ポリシーに従って更新する必要があります。

ノート¶

• 認証セキュリティプロトコルの変更により、Hive SDK v4 Cocos 25.0.0 以上を使用する場合、セキュリティキーをHive コンソール > セキュリティキー設定で発行する必要があります。セキュリティキーがないと、アプリへのログインはできません。

• PG決済プロセスの変更により、Hive SDK v4 Cocos 25.1.3以上でPG決済を使用するには、PG決済フローを参照し、コードの実装を更新してください。

新機能¶

チャット¶

• すべて 特定のチャットメッセージに「いいね」を表現または表示する機能を追加しました。
• すべて 特定のチャットメッセージに「返信」を書き、返信関係に関する情報を提供する機能を追加しました。
• すべて 特定のユーザーに言及し、ユーザーの言及に関する情報を提供する機能を追加しました。

変更された機能¶

チャット¶

• すべて チャネルメッセージクエリメソッドをインデックスベースからメッセージIDベースに変更しました。

v4.25.5.1¶

新機能¶

認証¶

• すべて 新しいmulti-account login機能を提供しました。詳細は以下の通りです: * 現在ログインしているアカウントをデバイスに保存 * 保存されたアカウントを表示 * ログアウトして保存されたアカウントを削除 * 別の保存されたアカウントで迅速にログイン

プロモーション¶

• すべて 新しいダイレクトリンク機能を追加しました。

通知¶

• すべて 新しいプッシュアクションボタン機能が追加されました。 * プッシュ通知を受信した際に、プッシュアクションボタンを介して事前定義されたアクションを実行できます。

チャット¶

• すべて メッセージ送信 * ユーザーの言語へのチャットメッセージの自動翻訳と特定のメッセージを翻訳する機能を追加しました。 * 特定の言語のユーザーのみが受信できるアナウンスメッセージを送信する機能を追加しました。 * コールバックの順序を保証するために、ウェブソケットメッセージにメッセージIDを追加しました。
• すべて チャンネル * チャットチャンネルに入る際に、過去のチャット履歴を表示する機能を追加しました。 * 現在のチャンネルの参加者数を提供しました。 * チャンネルリストを取得する際のソートオプションを追加しました。
• すべて イベント管理 * バイナリでカスタムデータイベントを送信する機能を追加しました。
• すべて 接続管理 * 再接続機能を追加しました。

変更された機能¶

共通¶

• Android ビルドに必要な難読化ルールが更新されました。
• iOS 以前は別々だった HiveAppTrackingTransparents.framework ライブラリが Service.framework に統合されました。

認証¶

• すべて Hiveメンバーシップアカウントを使用していない場合、showMyInquiryメソッドは現在、問い合わせページを表示します。
• Android VK認証ポップアップをウェブビューからアプリ内ブラウザに変更しました。

マーケティング帰属¶

• iOS は、Firebaseの購入イベントの自動収集をサポートするようになりました。

ヘラクレス¶

• すべて ヘラクレスライブラリを更新しました。 * Android 20250527 * iOS 20250218

修正されたバグ¶

プロビジョニング¶

• iOS 利用規約が表示されているときにウェブビューがスクロールしないように修正しました。

プロモーション¶

• iOS iPadデバイスのニュースUIの角の半径を修正しました。

アナリティクス¶

• iOS 利用規約に同意した後、アナリティクスログをすぐに送信できるようにロジックを修正しました。

v4.25.2.0¶

変更された機能¶

プロビジョニング¶

• すべて 条件の詳細とレビューのページでは、リンクが条件のURLでない場合やハイパーリンクタグを含む場合、外部ブラウザで開くようになりました。

認証¶

• すべて VK認証方法が変更されました。新しい方法はnew VK開発者コンソールで使用できます。

• iOS Apple GameCenterのログインに使用されている廃止されたGameKit APIの検証プロトコルを更新しました。

• Android Google Sign-Inライブラリのサポート終了に伴い、認証は現在、Google Credential ManagerおよびAuthorizationClient APIを使用して、暗黙的および明示的なログインの両方を行います。

請求¶

• Android PG決済を通じて購入された商品が返金されると、以前の取引と区別するためにorder_id値が追加されます。
• Android PG決済取引が完了すると、購入完了ログがクライアントから送信されるようになりました。

プロモーション¶

• Android ユーザー獲得共有のためにTelegramを露出リストに追加しました。
• Android webview露出のキャッシングポリシーを変更しました。

マーケティングアトリビューション¶

• すべて Hive SDK識別子を MMPサービスとの統合のために追加しました。
• すべて 手動でイベントを追跡する際に、カスタム属性を追加できるようになりました。
• Android Airbridgeを初期化する際に、市場ソース情報が送信されるようになりました。
• iOS sendEventWithAttributes APIを使用する際、semantic value型の浮動小数点値の精度範囲がfloatからdoubleに変更されました。

チャット¶

• すべて メッセージデータを送受信する際に、extraDataが送信および受信されるようになりました。
• すべて チャットサーバーに接続する際に、extraDataが送信されなくなりました。
• すべて 整数の時間値が文字列の時間値に加えて受信されるようになりました。
• すべて ネットワークがブロックされ、ウェブソケットが適切に切断できない場合、再接続の試行が重複接続によって失敗しないように変更されました。

その他¶

• 外部ライブラリを更新しました。 * Airbridge(Android) v4.1.0 → v4.3.0 * Airbridge(iOS) v4.1.1 → v4.3.0 * Adjust(Android) v5.0.1 → v5.2.0 * Adjust(iOS) v5.0.1 → v5.2.0 * Singular(Android) v12.6.1 → v12.7.0 * Singular(iOS) v12.6.1 → v12.7.1 * AppsFlyer(Android) v6.15.2 → v6.16.2 * AppsFlyer(iOS) v6.15.3 → v6.16.1 * QQ(iOS) 3.5.17.3 → 3.5.17.4

修正されたバグ¶

共通¶

• Android 通信の再試行が必要な場合や分散サーバーに接続する場合、最大タイムアウト前に応答が受信された場合は、タイムアウトを待たずにすぐに再試行または接続を行います。

• iOS サーバーグループゾーンをConfigurationクラスのsetZoneメソッドを使用して変更する際に、_hive_config.xml_内のgameLanguage値がリセットされるエラーを修正しました。

プロビジョニング¶

• すべて SDKの初期化前に広告モジュール（Adiz）を初期化し、COPPAまたはGDPRに準拠する際に、hive_config.xmlに設定された値に基づいてAgeGateの値が操作されるエラーを修正しました。

認証¶

• iOS iOS 18 以上のデバイスで QQ ウェブログインが正しく機能しないエラーを修正しました。

マーケティングアトリビューション¶

• Android インストール状況を判断するためにAdjustを使用しているときに、空のプッシュ通知が表示される問題を修正しました。

• Android Airbridgeを使用する際、複数のアイテムが購入された場合に、単価と数量に応じて販売情報が送信されるように修正されました。

チャット¶

• Android チャットに接続する際の断続的な接続失敗を修正しました。

v4.25.1.3¶

変更された機能¶

マーケティングアトリビューション¶

• iOS 新たにAirbridgeの遅延ディープリンクトラッキングをサポートしました。

請求¶

• Android PG決済の動作を他の請求（IAPv4）マーケットに合わせて変更しました。PG決済を使用している場合は、PG決済フローを参照し、コードを更新してください。

v4.25.1.0¶

修正されたバグ¶

マーケティングアトリビューション¶

• iOS Adizを介して送信された広告収益情報がAirbridgeでAdMobとして送信されるエラーを修正しました。

請求¶

• iOS 消費情報を送信することに同意するためのポップアップUIが不透明な背景で表示されるエラーを修正しました。

• iOS ポップアップUIを閉じる際に、アプリの画面が意図せず回転するエラーを修正しました。

プロモーション¶

• iOS 画像付きのレビューポップアップで回転イベントが発生した際に画像が消えるエラーを修正しました。

v4.25.0.0¶

新機能¶

認証¶

• すべて 新しい認証方法 (IdP) としてTelegramを追加しました。 ログインのためのTelegramボットの設定を参照してください。

請求¶

• iOS は、Apple App Storeにアプリ内製品の消費情報を送信するための同意をユーザーに求めることをサポートしています。

マーケティングアトリビューション¶

• すべて 新たにマーケティングトラッキングイベントのためにAirbridgeに追加属性を送信することをサポートします。
• Android 新たにAirbridgeの遅延ディープリンクトラッキングをサポートします。

チャット¶

• すべて 新たにチャット機能をサポートしています。

マッチメイキング¶

• すべて マッチメイキング機能を更新し、新たにgroup matchmakingをサポートしました。

   <span style='color:#FF0000;'>※ 前の Hive SDK インターフェースとは互換性がありません。更新されたマッチメイキング機能を使用するには、Hive SDK v4 25.0.0 以上を使用してください。</span>
  

変更された機能¶

認証¶

• すべて 使用されていないAuthモジュールのクラス、インターフェース、メソッド、デリゲート、およびリスナーを削除しました。
• すべて JWTトークンを使用して、より強力なセキュリティプロトコルを適用しました。
• すべて TalkPlusサポートの終了に伴い、TalkPlus認証トークンメソッドを削除しました。
• Android ログインだけでなく、AppleログインWebビューでのパスワード回復などのブラウジングを許可しました。

プロモーション¶

• すべて 招待コードを入力したユーザーがアプリをインストールしたときに報酬を与えるために、ログインイベントを収集します。詳細はこちらを参照してください。

マーケティングアトリビューション¶

• すべて Adjust v5をサポートするように更新されました。 * Adjust Signatureライブラリを削除しました。
• すべて Adjustで広告収益を集計する際、AdMobを広告収益のソースとして送信します。
• Android Appsflyer広告収益集計ライブラリの統合がメインライブラリに反映されました。 * 6.14.2 → 6.15.2 * Appsflyer広告収益ライブラリを削除しました。

その他¶

• すべて ヘラクレスライブラリのバージョンが更新されました。 * Android: 20241120 * iOS: 20241120

修正されたバグ¶

認証¶

• Android signIn メソッドの実行中にネットワーク応答が遅れた場合にUIスレッドが断続的に占有される問題を修正しました。

請求¶

• iOS UserEngagementを使用してアプリ内製品の購入を誘発する際に、余分なIAP_UPDATEイベントが発生するエラーを修正しました。

v4.24.5.0¶

新機能¶

認証¶

• すべて 新たにSteamとX（旧Twitter）を認証方法としてサポートします。 * 準備: 共通 * 準備: Android * 準備: iOS * ブランディングガイド
• すべて 認証されたセッションを共有するin-appウェブブラウジング機能を提供します。

マッチメイキング¶

• すべて 新たにマッチメイキングサービスをサポートします。

プロモーション¶

• すべて スポットバナー は、現在広告の露出をサポートしています。
• Android ユーザー招待共有においてX（旧Twitter）へのサポートを追加しました。

変更された機能¶

認証¶

• すべて 競合ポップアップに表示される修正されたプロバイダー名。

修正されたバグ¶

請求¶

• iOS 浮動小数点数として正確に表現できない価格が、JSON形式で正確な小数として表示されるように修正されました。 * 例: 4.99$ (文字列) → 4.9900000000000011 (倍精度) → 4.99 (JSON数値)

v4.24.4.0¶

新機能¶

マーケティングアトリビューション¶

• すべて は、Hive SDKに特化したサービスとしてAirbridgeをサポートします。 - Airbridgeでイベントを自動的に追跡する - Airbridgeでイベントを手動で追跡する

請求¶

• Android は、PG決済を通じて単一製品の希望数量を購入することをサポートしています。

修正されたバグ¶

アナリティクス¶

• iOS 同意バナーで1つのオプションのみを選択した場合に正しく反映されないエラーを修正しました。

v4.24.3.0¶

新機能¶

プロビジョニング¶

• すべて 利用規約画面で法定代理人の同意が得られたかどうかを確認する機能を追加しました。

変更された機能¶

認証¶

• すべて ログアウト動作が変更されました。 * 以前: Hive SDKはsignOutが呼ばれたときにユーザーアカウントをログアウトしました。ゲストアカウントはsignOut APIを呼び出すとサーバーから失敗レスポンスを受け取りました。 * 後: signOutが呼ばれたとき、Hive SDKはHiveサーバーにユーザーアカウントがログアウトできるか確認を依頼し、レスポンスに基づいてログアウトします。
• すべて ゲストアカウントのログアウト時に、もはや成功レスポンスを返さず、エラーコードを返します。Hive SDKとHiveサーバーはゲストアカウントセッションを維持します。
• すべて 停止されたアカウントの場合、同じIdPで別のアカウントがログインできるようにIdPを自動的にログアウトします。自動ログインが不可能な場合のみ適用されます。
• すべて AuthV4.connectでIdPをリンクする際に、停止されたアカウントに切り替えるとログアウトがトリガーされます。
• すべて デバイス管理サービスは、デバイス地域に基づいて国際電話の国コードを自動的に適用します。
• iOS Facebookログインは、アプリの追跡透明性（ATT）同意が拒否されていても可能になりました。

プロモーション¶

• すべて 不要な情報がadditionalInfoを介して送信される値に含まれないように修正されました。
• すべて 2:3または3:2の比率で全画面バナーを許可するように変更されました。
• すべて 全画面バナーの「1日表示しない」というテキストを「今日表示しない」に変更しました。

マーケティングアトリビューション¶

• すべて 変更された 署名を調整 バージョンを v1 から v3 に変更しました。

修正されたバグ¶

Hive SDK 共通¶

• Android リソース参照ロジックによりメモリが解放されないエラーを修正しました。
• iOS iOS 14デバイスでATT同意状況を確認する際の間欠的なクラッシュを修正しました。
• iOS 写真アルバムで制限された写真アクセスを選択した際のクラッシュを修正しました。

通知¶

• Android サポートされていないtype設定がローカルプッシュ通知でプッシュメッセージが表示されないエラーを修正しました。
• iOS アプリのバージョン情報を送信するように変更しました。

v4.24.2.0¶

新機能¶

Hive SDK 共通¶

• すべて EUおよびEEA地域でGDPRが適用される場合に、16歳未満のユーザーが利用規約に同意したかどうかを返す機能を提供します。
• Android Android OS 11以上またはサポートされているモジュールでは、写真アルバムへのアクセスのデフォルトとしてPhotoPickerを使用します。
• iOS Hive SDKのデバッグログは、MacOSのコンソールアプリで確認できるようになり、特定のログタイプをフィルタリングできます。

認証¶

• すべて 最大アカウント数を超えた後に認証コードを要求すると、エラーメッセージが表示されます: "同じ電話番号で作成できるアカウントの数を超えました。"

プロモーション¶

• すべて クロスプロモーションの露出を制御します。
• すべて N日間表示しないをサポートするために「今日表示しない」機能を改善しました。

変更された機能¶

通知¶

• Android は新しいAmazon Fireデバイス用のランタイムライブラリ（Push Amazon Device Message 1.2.0）をサポートしています。

プロモーション¶

• iOS ゲーム招待（UA）機能を使用する際のクリップボードの権限ポップアップを最小限に抑えることで、使いやすさが向上しました。 * ポップアップの表示タイミングをアプリ起動からHive SDKの初期化に変更しました。 * 招待者のURLデータがクリップボードに存在する場合のみポップアップが表示されるようになりました。

アナリティクス¶

• iOS オプションsaveAnalyticsLogBeforeCrashのデフォルト値は、クラッシュ時に未送信のログをファイルに保存するため、現在はfalseです。

修正されたバグ¶

認証¶

• すべて 中国のユーザーの実名確認において、残り時間がリセットされず、SMS送信制限を超えた際にエラーメッセージが表示されるように修正されました。
• Android Google Playログイン中にバックキーを押した際にコールバックが提供されないエラーを修正しました。
• Android 低解像度デバイスでキーボード入力ができないエラーを修正しました。

プロモーション¶

• iOS ニュースビューで新しいフレームビューを表示する際のフリーズ問題を修正しました。

マーケティングの帰属¶

• Android カスタマイズされた条件で初期化する際のAdjustイベント送信の固定遅延。

v4.24.1.2¶

修正されたバグ¶

認証¶

• Android Googleログイン中にバックボタンを押した際にコールバックが提供されないというエラーを修正しました。このバグは、HiveコンソールでGoogleレガシーサポートが有効になっている場合にのみ発生しました。
• Android 低解像度デバイスでキーボード入力ができないというエラーを修正しました。

v4.24.1.0¶

変更された機能¶

アナリティクス¶

• iOS デバイストラッキングの同意に基づいて同意バナーの表示を決定するように変更されました。 * トラッキングの同意が拒否された場合、同意バナーは表示されません。

v4.24.0.0¶

新機能¶

プロモーション¶

• Android は、外部ページの表示にデバイスのデフォルトブラウザを使用してカスタムタブをサポートしています。PlatformHelper クラスのshowInAppBrowser メソッドを使用してアプリ内ブラウザを表示します。
• iOS は、外部ページの表示にSafariViewControllerをサポートしています。PlatformHelper クラスのshowInAppBrowser メソッドを使用してアプリ内ブラウザを表示します。

請求¶

• iOS 製品が最初のサブスクリプション割引を持っている場合、製品情報クエリは割引情報のためにoriginal_priceとpriceフィールドの両方をIAPV4Productオブジェクトで返します。

変更された機能¶

Hive SDK 共通¶

• iOS は、アプリのバージョンを区別するために、CFBundleShortVersionString も使用するようになりました。

請求¶

• すべて 返金UIのPG支払いタイプの表記を「HiveStore」から「PG支払い」に変更しました。
• Android PG支払いページをアプリ内ブラウザではなくアプリ内ウェブビューで表示するように変更しました。アプリ内ブラウザをサポートしていないデバイスでのPG支払いをサポートしています。

アナリティクス¶

• Android Firebaseイベント収集における広告識別子の収集のデフォルト値は現在trueです。

v4.23.0.0¶

ダウンロード¶

開発環境¶

Cocos2d-x¶

• 3.17.2

Android¶

iOS

• Xcode 15.0+
• Xcodeのバージョンは、Apple App Storeのポリシーに従って更新する必要があります。

変更された機能¶

Hive SDK 共通¶

• Android Java Enum インターフェース ResultAPI クラスへのアクセスが変更されました。以下の例を参照してください。
  • 以前: ResultAPI.Companion.getSUCCESS() のみがサポートされていました。
  • 変更: ResultAPI.Companion.getSUCCESS() と ResultAPI.SUCCESS の両方がサポートされます。
• Android インスタンスメソッドスタイルとクラスメソッドスタイルの両方がJavaでサポートされています。以下の例を参照してください。
  • 以前: IAPV4.INSTANCE.getProductInfo のみがサポートされていました。
  • 変更: IAPV4.INSTANCE.getProductInfo と IAPV4.getProductInfo の両方がサポートされます。
• Android Z-Flip 5のフロントディスプレイで、問い合わせウィンドウ、チャットボット、および成人認証ウィンドウが画面範囲を超えないように調整が行われました。
• iOS サポートされる開発環境がXcode 15以上に変更されました。macOS Ventura13.5以上で使用できます。サポートされるOSは以下の通りです:
  • iOS 12以上
  • iPadOS 13以上

認証¶

• すべて デバイス管理、中国の実名確認などについて、ユーザーがSMS確認の時間制限内にSMSを入力しない場合、送信ボタンは無効になります。
• Android 各IDPはオプションのアプリケーション用にライブラリに分けられています。以下のライブラリを追加で適用できます:
  • Apple サインイン
  • Weverse
  • メンバーシップ
• Android Hive サーバーによって直接確認されたログイン情報のみを信頼するように変更され、Google Play Games ログイン中のAuthV4ServerResponseErrorのいくつかのケースが解決されます。
• iOS Hive SDKによって使用されるreCAPTCHAライブラリが公式バージョンに更新されました。
• iOS 各IDPはオプションのアプリケーション用にライブラリに分けられています。以下のライブラリを追加で適用できます:
  • Apple サインイン
  • GameCenter
  • メンバーシップ

プロモーション¶

• すべて ニュースまたはインタースティシャルバナーのいずれか一方のみが画面に表示されるように変更が行われます。最初に呼ばれたウィンドウのみが表示され、後に呼ばれたウィンドウは表示されません。
• すべて campaignId を UA キャンペーン情報に含めます。
• iOS SDWebImage ライブラリを更新し、画像のキャッシングおよびダウンロードに関連するLRU キャッシュポリシーを適用します。

Billing¶

• すべて はもはやIAPv2インターフェースと機能をサポートしていません。
• Android 保留中の購入がある場合、遅延した購入結果が現在進行中の支払いに影響を与えないように変更が行われました。

プロビジョニング¶

• すべて アカウントに基づいて利用規約を公開する機能を追加します

Hercules

• すべて Hercules ライブラリのバージョンを更新します。
  • Android: 20231122
  • iOS: 20231116

<

修正されたバグ¶

認証¶

• Android ポルトガル語で使用制限ポップアップが表示されるときにボタンが正しく表示されない問題を修正しました。
• iOS プロフィール画像を編集しているときにカメラキャプチャボタンを迅速にタップするとアプリがクラッシュする問題を修正しました。

プロモーション¶

• Android アプリがフォアグラウンドからバックグラウンド、再びフォアグラウンドに変更される際に、ゲーム終了ポップアップが表示されているときに改行が正しく機能しないエラーを修正しました。
• iOS プロモーションバナーを通じてコミュニティウェブビューなどを表示する際に、上部のノッチエリアが切り取られる問題を修正しました。

プロビジョニング¶

• iOS 停止されたユーザーの停止解除までの残り時間を表示しないように修正されました。

データストア¶

• iOS 引数としてsetメソッドに空の値を設定すると、以前に設定された値が削除され、適切に動作することが保証されます。

通知¶

• Android アプリが再起動されたときにプッシュメッセージを表示するための取得プロセスに問題があり、プッシュメッセージの内容が表示されない問題を修正しました。

Analytics

• すべて 同時ユーザーログ送信において、不明な国に送信される国コードをUnknownから2つの空白文字に変更しました。

<

知られている問題¶

このHive SDKバージョンのリリースに関する既知の問題はありません。
<

開発者ガイドの変更¶

一般的な

• COPPA ageGateU13の値を直接設定できる値に変更しました。
• hive_config.xmlの例を更新しました。
• こちらからサポートされていないIdPであるWEIBOに関連するコンテンツを削除しました。
• アプリ内更新の説明を改訂しました。

Android

• Gradle、Android Gradle Plugin、Kotlin Gradle Pluginの最小バージョンを追加しました。
• Android Gradleファイルの内容を変更しました。Hive SDKの機能が内部で別のライブラリに分離されたためです。
• AndroidManifest.xml設定から関連する内容を削除しました。Hive SDKによってWeChat Authが自動的に追加されるためです。また、Hive SDKが直接FOREGROUND SERVICEを使用しないため、内容を削除しました。
• Facebook Cloud Gameビルドのためにbuild.gradleで必要なライブラリの設定に関連する内容を変更しました。
• Firebase Analyticsを追加するためにモジュールレベルのbuild.gradleファイルの内容を変更しました。
• Huaweiのビルド設定を更新しました。
• Google Play GamesのPCビルドのためにbuild.gradleで必要なライブラリの設定に関連する内容を変更しました。
• Googleログインをサポートするためにモジュールレベルのbuild.gradleファイルの内容を変更しました。
• ONE Storeのバージョンが21.01.00に更新されたため、説明を改訂しました。

iOS

• Apple Game CenterをIdP統合ガイドに追加しました。
• Hive SDKの機能が内部で別々のライブラリに分割されたため、iOS Podfileの内容を変更しました。