Unityの検索機能

効果的なベータ・テスターになるためのガイド

Unityを使用して初めてゲーム制作を始めるとき、そして Unity ベータ版テストの先行体験で最も大きな価値を実現するための実践的なガイドと参考資料です。

ようこそ

どうしてベータテストが重要なの?

弊社のQAスタッフはリリースを安定性のあるものにするために日々努力していますが、次のビルドについて Unity 開発者コミュニティのメンバーからフィードバックの提供がなければとてもできません。弊社はメンバーの皆さまのご協力に大変感謝しています。

プロジェクトをアップロードする方法、バグレポートを書く方法など、皆さまをサポートするために最高のベータテスターになれる本ガイドを作成しました。これらの手順に従っていただくことで、私たちはプロジェクトの開発に影響する問題を解決できる最も重要な情報を提供することができます。

ベータ版のフィードバックは非常に有益です。私たちは4と5 に評価されたすべてのベータ版バグレポートを分析し、低い評価のレポートを見ることに最善を尽くしています (それが何を意味するのか分からない場合は、こちらのブログ記事 をご覧ください)。バグを確認し修正が完了していることを確認した上で、次のベータ版のリリースをスケジュールします。現在のところ、どの修正プログラムがどのベータ版になるのか詳細は分かりませんが、できるだけ早く情報提供できるようにいたします。

以下では、影響を受けるバグレポートやフィードバックを送信する際のワークフローについて詳細を示します。こちらのページ(最も重要な手順の概要)でも手順の概要をご覧いただくことができます。

ベータ版についてさらにご質問がある場合は、ベータフォーラム をご覧ください。

01

インストールして使用開始

  1. 最新のベータ版でビルドできる機能をダウンロード、スタンドアローンのインストーラとして、または新しい Unity Hub 経由で直接インストールできます。このページには、多くのベータ情報とリソースも含まれています。新機能について学び、役立つドキュメントやツールを見つけたり、最新の懸賞についての情報をご確認していただけます。
  2. インストーラまたはハブを実行します。インストーラーを使用する場合は、必ずベータ版を新しいディレクトリにインストールしてください。Unity の複数のバージョンを、各ディレクトリに配置されている限り、並べて配置しても構いません。
  3. 新しいプロジェクトを始めるか、ベータ版のテストに使用する予定のプロジェクトのコピーを作成し、最新のベータ版で開きます。
    • ベータ版で既存のプロジェクトを実行する場合は、必ずバックアップコピーを作成してください。後方互換性は保証されていないため、プロジェクトをアップグレードすると、元のバージョンに戻すことができない場合があります。
    • Unity でプロジェクトを開くと、お使いの Unity バージョンにプロジェクトが自動的に移行されることにご注意ください。プロジェクトのコピーを作成することで、現在の安定版に戻ったとき再インポートする必要がなくなり時間も短縮できます。
  4. 通常通り、開発や新しい機能のテストやアップデートを行います。バグが見つかったと思われる場合は、本ガイドのパート 2、3、4 に記載されている次の手順に従ってください。

02

Unity でのバグの対処

ときに、バグを発見することもあるでしょう。ここでは最も効率的にバグを見つけやすくする方法を示します。

状況の評価

主なアクション

二次アクション

1. 状況の評価

既存のバグレポートの 課題トラッカー を確認する

課題を Google 検索して、関連するフォーラムを探す

2. 主なアクション

それは未解決の課題として知られていますか?

該当する課題 URL のエントリーに投票する

それは不明な問題ですか?

短縮 URL でバグレポートを提出し、Unity スタッフのリクエストに応える

3. 二次アクション

問題は既に報告されていますが、あなたのケースが修正によってカバーされるようにしたいですか?

短縮 URL でバグレポートを提出し、Unity スタッフのリクエストに応える

その問題に関する既存のフォーラムスレッドはありますか?

回答あり。フォーラムに回答がない場合は、Issue ID(不具合 ID)を参照する

Unity を使って問題が実行された場合、最初に行うべきことは、それが既知の問題であるか、それとも最初に経験したのかを確かめることです。この種の情報を得るための最初のアドレスは、Public Issue Tracker です。他のユーザーから報告されたバグを検索し、投票したり、コメントすることができます。問題に対する投票は、チームが最初に取り組むべきバグの優先順位付けに役立ちます。

Unity ベータフォーラムは、もう一つの素晴らしいコミュニティリソースです。他のユーザーが何を報告したかを知ることができるし、問題の回避策を見つけるまたはあなたが情報を提供することもできます。これは、Unity のスタッフとコンタクトを取るための良い方法と言えます。発生しているSubject(件名)が現在のベータに関連していることを確認して、複数の異なる問題を 1 つのスレッドにまとめないようにしましょう。

バグに関連するものが見つからない場合は、バグレポートを提出してください。レポートを提出したら、フォーラムに戻り、見つけた問題の説明を投稿することをお勧めします。そうすることで、他のユーザーが自分で報告、コンテキストを追加、または回避策を提供できるようになります。また、ベータ版のフォーラムを頻繁にモニターしており、そこで議論されている新しいケースの初期評価に優先順位が付くので、処理時間も短縮されます。

問題に関する新しいスレッドを始める場合は、送信したバグレポートを Unity チームが特定できるように、ケース番号 (確認メールに記載) を必ず投稿に含めてください。スレッドを残す場合は、最初に行っていただくようお願いします。

問題がプラットフォームやプロジェクトのバグのことを指しているか、またフォーラムやドキュメントの説明が間違いのないことなのかと疑問に思っている場合は、まずはバグレポートを提出してください。

03

バグを文書として記録・報告する

バグの報告は、最初はやや難解に思えるかもしれませんが、それほど難しいものではなく、安定性を確保するために不可欠な要素です。弊社のエンジニアがすぐに理解し対応することができる分かりやすいバグレポートを書くには、以下の簡単な手順に従ってください。

なお、レポートに書かれている情報で問題が再現できない場合は、欠けている要素を把握するためにご連絡させていただきます。

Bug Reporter を開く

Unityをご利用中に、メニューで Help → Report a Bug を選択していただくか、Unityがインストールされているディレクトリの実行可能ファイルから直接アクセスすることができます。Unity がクラッシュした場合にも、自動的に起動されます。

基本的な情報を提供する

「問題のタイプ」のフィールドで、報告するバグに最も適した当てはまる選択肢を選びます。ベータ版のバグを報告しているので、通常は「エディターの問題」または「クラッシュバグ」になります。

「どのくらいの頻度で起こるか」では、あなたが一度だけ経験した問題であるか、時々か、またはある措置を講じるたびにクラッシュに遭遇するかなど、問題があった場合の頻度を示す必要があります。

詳細について弊社からご連絡する必要がある場合に備えて、メールアドレスをご入力ください。Unity アカウントでログインしている場合、このフィールドは自動的に入力されます。

レポートが検証されたら「タイトル」および「問題の説明」のフィールドに書かれたテキストは、Issue Tracker で一般公開されます。この情報はコミュニティで役立ちます。他のユーザーは、コメント、投票 (修正の優先順位付けに役立つ)、いつ修正可能かなどを確認することができます。あなたの個人情報は一切公開されません。プロジェクトやその他の添付ファイルについては弊社の社員のみがアクセスできます。

バグを特定する

バグを記述する際には、以下のように最も簡潔な用語で、短く具体的に行うといいでしょう。

GI キャッシュの消去とプロジェクトのリロード後、コンソールにエラーが表示される

バグを分類してタイトルを作成

発見したバグは、何らかのカテゴリに分類しましょう。カテゴリについては UI、アセットのインポート、スクリプティング、固有のプラットフォーム、クラッシュなどさまざまなものがありますが、今回の場合はライティング……より具体的には Enlighten lightmapper に関連していました。

バグ分類が終わったら、バグの説明を追加しタイトルを以下の形式で作成しましょう。

[Category] の説明

このシナリオではバグのタイトルは以下のようになります。

[Enlighten] GI キャッシュの消去とプロジェクトのリロード後にコンソールにエラーが表示される

バグの再現手順

問題の診断と解決において、Unity QA および開発チームにはすべての情報を提供していただく必要があります。受け取った情報によっては、問題の根本原因を特定できないまたは判断を誤る可能性や、バグではない他の問題を修正してしまう場合があります。そのため、できるだけ多くの情報を前もって提供するのが望ましいと言えます。そのための最も簡単な方法としては、バグに遭遇する前に行った手順と同じ方法を実行することです。そこで、あなたがバグを見つける前に最初に行ったことは?

プロジェクトを閉じ、再度開く

表示されるのは Steps to Reproduce(再現する手順)の最後の手順です。 あなたはその直前に何を行いましたか?

Clean the GI cache: Edit > Preferences > GI Cache > Clean Cache

覚えている限りこの作業を続け、Unity を最初に開けたときまで行うのが理想です。より多くの情報を準備できれば、より簡単に再現して修正することができます。すべてを覚えていない場合は、バグを再現できるかどうかを確認し、実行している再現手順にもご注意ください。

手順を文書で提供する必要はありません。たとえば、画面のビデオキャプチャを使用して手順を送信することができます。最も重要なことは、エンジニアがバグを再現できるようにあなたが行った手順を正確に説明することなのです。

予測結果 vs 実際の結果を追加する

バグに遭遇する前、何が起こると思いましたか?

予測:コンソール内でエラーは出ない

代わりに何が起きたのですか?

実際: コンソール内にエラーが表示される

注記:予期しないエラーメッセージが表示された場合は、説明を追加すると便利です。

すべての情報を入力した後、レポートは以下のようになります。

プロジェクトフォルダーを添付する

Bug Reporter は、エディターから開くと、現在ロードされているプロジェクトをバグレポートに自動的に含みます。レポーターを実行ファイルで起動する場合は、プロジェクトを手動で添付する必要があります。あなたのプロジェクトが小さくなければ、アセットを必要最小限にまで減らすことをお勧めします。問題を再現するのに必要な最小限のアセットのみ提出することで、QAおよび開発チームは、対象を絞り込むことで迅速にバグを特定して、より迅速に修正を提供することができるようになります。

プロジェクトの特定のシーンで問題が発生した場合は、バグに遭遇したシーンをエクスポートしてから、新しいプロジェクトにインポートし、バグがまだ発生しているかを確認してください。発生していれば、新しい小さなプロジェクトをアップロードします。発生していなければ、プロジェクトのより大きなバージョンで試してみてください。

プロジェクトのサイズを縮小し、最小限の再現プロジェクトを作るために、必要な作業を大幅に削減するツールをご用意しております。

ツールの使用方法に関する詳細は、上記のリンクからご覧いただけます。

問題を再現するのに最小のプロジェクトは理想的ですが、もちろん大きなプロジェクトでもかまいません。弊社のレポーティングシステムは大容量の添付にも対応しているので、アセットを絞り込むことができない場合はプロジェクトフォルダー全体を送信していただくことも可能です。なお、プロジェクトには、アセットのみに存在しない関連データやファイルが含まれているため、個々のアセットはアップロードしないでください。

最終的なレポートは以下のようになります。

弊社のチームが問題を見つけて修正するために使用できる情報と簡潔なバグレポートをまとめたものが上記の画像です。 次はいよいよ最後の手順となります。

バグレポートを提出

「送信」を押すと、バグレポートが提出されます。

バグが提出されると、保持する必要があるケース番号を含む確認メールが送信されます。メール本文には、バグの現在のステータスを示す Web ページへのリンクが張られています。また、更新のためにいつでもそのページを確認することができます。このリンクにはあなたの連絡先アドレスとバグレポートの履歴も公開されていますので、フォーラムや他のパブリックスペースで共有しないでください。ケース番号は、他の人が Issue Tracker で問題を見つけるために使用するものです。

あなたの都合の良い時に、バグ報告や関連するプロジェクトフォルダを追跡することをお勧めします。以下の方法を提案します。

  1. バグレポートを送信すると、添付したプロジェクトの.zipファイルを作成します。
  2. .txt ファイルをバグレポートのままにして、アセットのディレクトリに保存すると、プロジェクトのエラーとその再現方法を知ることができます。
  3. バグレポートを提出したのち、確認メールに記載されているケース番号が手に入ったら、.zip ファイルにその番号で接頭辞を付加します。

この方法で、バグレポートが閉じられたことを通知するメールがUnityから送信されると、レポートに添付されたプロジェクトをすばやく見つけることができます。

バグレポートが閉じられているという Unity からの通知を受け取ったら、適切なプロジェクトを見つけ最新の Unity ベータ版を開き、再現する手順に従って確認することで、バグがなくなったかどうかを簡単に判断できます。

このように、高品質のバグレポートを作成することで、バグが再現および修正される可能性が高まるほか、将来のベータ版で修正されることを容易に確認できるというメリットが生じます。

04

フォローアップ

質問がある場合は、弊社スタッフがあなたと連絡を取れるようにすることが常に理想的です。バグレポートを送信した場合は、メールでご連絡いたします。フォーラムに書かれた場合は、そこに返信いたします。このようなケースの迅速な解決を確実に行うために、チームからの質問やリクエストにできるだけ早く対応してください。

フォーラムに投稿したバグが表示されない場合は、新しいスレッドを作成することをお勧めします。ただし、その前に他の人が同じ問題を経験している可能性があることにご留意ください。あなたが見つけた回避策を投稿し、ベータコミュニティで同じ問題に悩む方々とコミュニケーションを取り、解決に向けた早道を見つけましょう。

これだけです!

効果的なベータ・テスターになるためのガイドをお読みいただきありがとうございます。上記のいずれかについてご質問があり、検索エンジンで回答が表示されない場合は、フォーラムでお気軽にお問い合わせください。

OK

弊社のウェブサイトは最善のユーザー体験をお届けするためにクッキーを使用しています。詳細については、クッキーのポリシーのページをご覧ください。