更新履歴¶
0.1.0-alpha.7¶
改善¶
- Replay の画像サイズとキャプチャ頻度: ローリング（分単位）の予算とアダプティブなキャプチャ頻度の低減を、単一フレームのサイズ制限に置き換えました。制限は、新しい View と画面方向変更の最初のフレームにも適用されます。収集サイクルには処理時間が含まれ、画像の拡大縮小後も表示座標が保持されます。
- 導入サンプルと説明: Creator 2/3 のインタラクティブゲームサンプルを統一し、Replay API と Android 実機トラフィックの参考情報を追加しました。Creator 3 のサンプルには Android 16 KB ページアライメント設定と確認ツールを追加しました。
修正¶
- Creator 3 のカメラ: 専用のオフスクリーン Camera を使用してフレームをキャプチャし、表示画面や Camera に依存する入力座標に影響を与えないようにします。
- Creator 3 のタッチ: UI コントロールによって消費された Replay タッチを記録しつつ、通常の入力配信を維持して重複記録を回避します。
アップグレード手順¶
2つの npm パッケージは必ず同時にアップグレードしてください。インストーラーを --replay 付きで再実行し、ネイティブプロジェクトを再ビルドします。imagePolicy.maxBytesPerMinute と imagePolicy.adaptiveCapture を削除し、キャプチャ頻度、画像サイズ、単一フレームのサイズ制限を使用します。単一フレームの制限はローリングトラフィック枠とは異なります。詳細は alpha.7 へのアップグレード を参照してください。
0.1.0-alpha.6¶
新機能¶
- 独立した Replay パッケージ: セッションリプレイをオプションの
@cloudcare/cocos-session-replayに分割し、Creator 2/3 エントリ、ノードのプライバシーコンポーネント、ネイティブ Bridge を提供します。基本パッケージには Replay が含まれなくなります。 - コンポーズ API:
withSessionReplay(baseSdk)を使用して、Replay の設定、開始/停止、プライバシー、カメラ選択を提供します。また、基本パッケージに共通プラグイン API を追加しました。
改善¶
- インストールと公開:
--replay/--no-replayによるネイティブ統合スイッチをサポートし、管理対象リソースの識別子を保持します。2つの npm パッケージは完全に同じバージョンを使用し、公開時の検証と中断した公開の再開をサポートします。
アップグレード手順¶
一体型パッケージからアップグレードする場合は、同じバージョンの2つのパッケージをインストールし、start() / attach() の前にコンポーズを完了します。Replay 型のインポートを独立パッケージに移し、コンポーズしたインスタンスから setReplayCamera() を呼び出します。インストーラーを再実行してネイティブプロジェクトをビルドしてください。詳細は パッケージ分割移行 を参照してください。
0.1.0-alpha.5¶
新機能¶
- iOS Swift Package Manager 対応: Creator 2、Creator 3、Hybrid ネイティブホストでは、プロジェクト設定で CocoaPods または SPM を選択できます。デフォルトは引き続き CocoaPods です。インストーラーは既存の選択を保持し、Creator 3 の CMake 再生成後には SPM 参照を復元します。
改善¶
- ネイティブネットワーク SDK の依存関係: Android Agent を
1.7.6-alpha03に、Hybrid サンプルの Gradle Plugin を1.3.9-alpha01にアップグレードしました。CocoaPods と SPM で使用される iOS Agent と Session Replay は1.6.8-alpha.5にアップグレードしました。新しい iOS では、個別のスイッチで NSURLConnection Resource の収集と Trace 関連付けを有効化できます。2つの新しいスイッチはデフォルトでオフです。 - ネットワーク検証サンプル: Creator 2 Android エンジンの HTTP リクエストと、オプションで有効化できる iOS NSURLConnection リクエストのサンプルを追加しました。実際にアップロードされた Resource を確認する方法と、JS の自動収集または手動計測がネイティブ収集と重複しないようにする方法を説明します。
- Creator 3 Replay サンプル: ネイティブ 3D 検証シーンを追加しました。カメラ、モーション、独立した HUD コントロールを備え、フレームキャプチャ動作と現在の単一カメラ収集の制限を確認するために使用します。
ネットワーク収集スイッチと重複収集の回避方法は、Android ネットワーク収集の推奨事項 と iOS ネットワーク収集の推奨事項 を参照してください。SPM の導入手順は iOS ネイティブビルド を参照してください。
0.1.0-alpha.4¶
新機能¶
- Session Replay プライバシーコンポーネント: Creator 2 と Creator 3 に
ReplayPrivacyエディタコンポーネントを追加しました。キャプチャしたリプレイ画面でノードとプレハブをマスクまたは非表示にできます。インストーラーはコンポーネントをプロジェクトのリソースディレクトリにコピーします。コードによるオーバーライドルールが優先され、入力フィールドはデフォルトでマスクされたままです。
改善¶
- Session Replay のフレームキャプチャパフォーマンス: Android と iOS でのリプレイファイルの読み書きとネイティブ画像エンコードをゲームスレッドの外に移動しました。SDK 更新後は、非同期 Bridge を含めるためにネイティブプロジェクトを再ビルドする必要があります。
- Hybrid プライバシーサンプル: 保守中の Creator 2 と Creator 3 の Hybrid サンプルに、プライバシーコンポーネントのサンプルとマスク位置合わせテストコントロールを追加しました。
修正¶
- Android Session Replay の再生: ネイティブ依存関係インストーラーの
ft-session-replay:0.1.9-alpha02を0.1.9-alpha03にアップグレードし、セグメント圧縮を Browser SDK の形式に合わせて、影響を受けたマルチセグメントセッションの再生を復元しました。Maven に公開された成果物を使用し、ネイティブページと Cocos ページの間を旧バージョン、新バージョン、再び旧バージョンと遷移する比較方式で検証しています。
0.1.0-alpha.3¶
改善¶
- Android SDK の依存関係: Creator 2 と Creator 3 のネイティブ依存関係インストーラーで、Android Agent SDK を
1.7.6-alpha01から1.7.6-alpha02に、Session Replay を0.1.9-alpha01から0.1.9-alpha02にアップグレードしました。 - Hybrid 導入サンプル: 各世代の Creator について、最小限の Hybrid 導入プロジェクトを1つ維持します。保守中のサンプルから、旧診断プロジェクト、コピーされた SDK インストールディレクトリ、リプレイトラフィックのベンチマークツールを削除しました。
- SDK とサンプルのメッセージ: 不要なブランド名を削除し、SDK のエラーメッセージとサンプルの文言を簡素化しました。
修正¶
- npm 公開: 公開前にパッケージメタデータをチェックし、バージョンが既に存在するかどうかを検出して、その公開識別子を検証します。最初の安定版リリースまでは、最新のプレリリース版を
latestタグに公開します。
0.1.0-alpha.2¶
修正¶
- Session Replay プライバシーマスク: Creator 2 と Creator 3 で、Camera の投影によってキャプチャされたフレーム内のコントロールの位置やサイズが変わる際に、入力フィールドとカスタムノードのマスクがずれる問題を修正しました。プライバシー境界を確実に投影できない場合は、そのフレームをスキップし、マスク位置が正しくない画面の収集を回避します。
0.1.0-alpha.1¶
新機能¶
- RUM 自動収集と手動計測: シーン切り替え、タッチ操作、ランタイムがサポートする JavaScript エラー、未処理の Promise 拒否を必要に応じて収集できます。View、Action、Error、Long Task、ネットワーク Resource を手動記録して、重要なビジネスフローを監視できます。ネイティブクラッシュ、Android ANR、UI のカクつき、デバイスパフォーマンス監視も設定可能です。
- ログ収集: カスタムログの送信と、必要に応じた Console 出力の収集をサポートします。ログレベルフィルタリング、サンプリング、キャッシュポリシーを設定でき、現在の RUM セッションに関連付けて、ユーザー行動と合わせて問題を調査できます。
- ネットワーク監視とトレース関連付け: ランタイムが提供する
fetchとXMLHttpRequestの基本リクエスト、レスポンス情報、合計所要時間を自動収集し、Trace Header を注入します。カスタムネットワーク接続のために、手動の Resource 計測と Trace Header 生成をサポートします。DNS、TCP、SSL のフェーズ別所要時間は手動計測が必要です。 - Session Replay（実験的）: Cocos 画面を収集し、RUM セッションに関連付けます。サンプリング、エラーセッションの追加サンプリング、キャプチャ頻度、画像サイズを設定できます。ノードのマスクと非表示をサポートします。デフォルトで入力フィールドをマスクし、タッチ位置を非表示にします。
- リプレイ画質とトラフィック制御: 画質プリセット、単一フレームのサイズ制限、ローリングウィンドウの画像データ予算を設定できます。アダプティブ収集は予算の使用状況に応じてキャプチャ頻度、画質、サイズを調整し、リプレイの詳細とデータ使用量のバランスを取るのに役立ちます。
- ネイティブホスト Hybrid 導入: Cocos を埋め込んだネイティブアプリで初期化済みの SDK を再利用します。
guanceSdk.attach()で導入し、guanceSdk.enterCocos()とguanceSdk.leaveCocos()を使用して Cocos 収集のライフサイクルを管理し、ホスト SDK の重複初期化を回避します。 - ユーザーとビジネスコンテキスト: ユーザーのバインド/アンバインド、グローバルおよびイベントレベルのカスタム属性の追加をサポートし、ユーザー、環境、ビジネスコンテキストで監視データを絞り込めます。DataKit または DataWay を介した送信をサポートします。
- プロジェクトインストールツール: 独立した Creator 2 と Creator 3 のエントリを含む npm パッケージ、インストールコマンド、ビルド拡張を提供し、Android と iOS のネイティブ Bridge と依存関係の設定を支援します。
導入要件¶
- Cocos Creator 2.4.5–2.4.15 と 3.6.3–3.8.x をサポートします。3.0–3.6.2 はベストエフォートでサポートします。
- Android API 21+ または iOS 12+ が必要です。現在、Web、ミニゲーム、デスクトップ向けはサポートしていません。
- スタンドアロンの Cocos アプリは
guanceSdk.start()で初期化します。Hybrid アプリは、まずネイティブホストで SDK を初期化してからguanceSdk.attach()を呼び出します。2つの初期化方法は排他的です。 - RUM、ログ、分散型トレーシング、Session Replay、自動収集を必要に応じて設定します。iOS ネイティブプロジェクトを生成した後、
pod installを実行して依存関係をインストールします。