English Ver. README

Unityで開発したアプリを実機上で実行している時に、GameObjectの内容をほんの少しだけ変更したいだけなのに、ビルド完了迄長時間待たされることで、貴重な開発時間を無駄にして悔しい思いをした事は無いでしょうか。 UnityChoseKunは再ビルドを行うこと無く、UnityEditor上で開発機で実行中のアプリの調整を行う為のEditor拡張です。 開発機が物理的に遠い場所にある人向けに実機で時以降中の画面をUnity Editorで表示する機能も保有しています。

実機上で実行しているアプリ内の画面をUnityEditorで表示たり、GameObjectをUnityEditorから調整する事が出来る、Editor拡張です。

実機で実行中のアプリ内のComponentを調整したり・・

実機(開発機)の画面をUnityEditorに表示したり・・・

本ツールは主に下記の３機能から構成されています。

• 実機で再生されている画面を表示する(Player View)
• 実機で再生されているSceneをHierarchy形式で表示(Player Hierarchy)
• GameObjectに含まれるComponentの内容を編集し実機側へ反映させる。(Player Inspector)

下記の内容で動作の確認済を行っています。

• Unityのバージョン
  • Unity2018.4.26f1 (一部、機能制限あり)
  • Unity2019.4.11f1
  • Unity2020.2.2f1
• プラットフォーム
  • Android
    • Pixel3XL
    • Pixel4XL
  • iOS
    • iPhone 6S

• Application
• Screen
• Time
• Shader
• Texture
• QualitySettings
• SystemInfo
• OnDemandRendering
• ScalableBufferManager
• Component
  • Animator
  • Behaviour
  • Bounds
  • Camera
  • Collider
  • Light
  • Material
  • Matrix4x4
  • MeshRenderer
  • MonoBehavior
  • Object
  • ParticleSystem
  • PhysicMaterial
  • Quartanion
  • Rect
  • Renderer
  • Resolution
  • Rigidbody
  • SkinnedMeshRenderer
  • Transform
  • Vector2
  • Vector3
  • Vector4

• 万が一不測の事態が起きても一切保証は出来ませんのでご注意下さい。
• Script Debuggingと併用できません。必ずScript DebuggingをOFFにした上でビルドを行ってください。
• Player Viewを有効にすると端末が高温になります。 また、画面解像度に応じてCPUリソースを消費します。PlayerViewの再生を行う前に、Player InspectorのScreenから画面解像度を変更することをお勧めします。Pixel4XLの場合、画面解像度を604x288迄落とした場合、CPUリソースにほぼ消費せずに実行できているようでした。
• Texture,Shaderに関しては内容の確認のみで、変更を行うことは出来ません。
• Materialが参照しているShader/Textureを変更する為にはTexture/ShaderのPullを先に実行する必要があります。
• Unity2018では以下の機能に対応していません。
  • Materialが参照しているTextureの差し替え
  • PlayerViewのAsync GPU Readback機能

本リポジトリの内容を組込み先のUnityProjectのAssetフォルダ以下に丸々配置して下さい。

• 調整を行うSceneにUnityChoseKun.prefabを配置してからアプリをビルドする必要があります。
• Development BuildとAutoconnect Profilerにチェックを入れてる必要があります。
• Scripting BackEndにはIL2CPPを指定する必要があります。

実機で表示している内容をUnityEditor上で再生するViewerです。

MenuからWindow->UnityChoseKun->Player ViewでPlayerView Windowが表示されます。

接続先のデバイスを指定します。接続の仕組みはUnityProfilerと共有していますので、どちらかの接続先を切り替えると、もう片方の接続先も切り替わります。

　再生の開始/終了
　録画の開始/終了
　スクリーンショットを保存する
　録画結果の保存先を指定する

Async GPU Readbackの機能を使用して画像処理を行う為、MainThareadの負荷が軽減される場合があります。

画像の転送処理を行う間隔を指定します。 間隔を開けることでCPU負荷が軽減されます。

録画時にファイルを書き出す先のフォルダー

録画に何コマ迄録画するかを指定出来ます。 このコマまで録画を行うと録画は自動的に停止します。

録画内容をSeekすることが出来ます。

Player Viewerは非常に負荷の高い処理です。Player Inspector->Screen->SetScreenからwidthとheightを調整したり、Refresh Intervalで実行間隔を調整してから再生を実行することをオススメします。

実機で実行されているアプリケーションのScene情報を分析し、Hierarchy Treeとして展開します。 まず初めにReloadを実行し、Sceneの情報を取得することからスタートします。 GameObjectが数万個存在するような複雑なSceneの場合、Reloadには時間がかかります。

EditorのHierarchy同様にGameObjectの親子関係を変更したり、右クリックからのモーダルダイヤログでGameObjectを生成したり、基本的なComponentを追加することが出来ます。

NOTE
アプリケーションに含まれていないComponentを追加するとエラーとなります。

実機で実行しているアプリケーションのオブジェクト及びUnithEngine内のいくつかのClassの内容を編集することが出来るWindowsです。

Player Hierarchyで選択したGameObjectが持つComponentの内容を編集します。 すべてのComponetの内容を編集出来る訳ではなく、現時点では一部のComponentに限定されています。 非対応のComponentに関しては、Componentのenableのみ編集可能となっています。

• [Connect To] : 接続先のデバイスを選択します。 Profilerと共有しています。
• [Add Component] : GameObjectにComponentを追加します。(未実装)

Scene上に存在するComponentの種類と数をカウントします。 本Editor拡張で未対応なComponentは規定Classにカウントします。

実行中のアプリからScene内から参照されているTextureとResourcesに含まれているTextureの一覧表示します。

• [Pull] : Scene上のGameObjectから参照及びResourcesに含まれるTextureの一覧を取得します。

※Materialが参照しているTextureを変更する場合は、事前にPullを実行しておく必要があります。

実機で実行されているアプリのScene上から参照されているShader及びResourcesに含まれるShaderの一覧を表示します。

• [Pull] : Scene上のGameObjectから参照及びResourcesに含まれるShaderの一覧を取得します。

※Materialが参照しているShaderを変更する場合は、事前にPullを実行しておく必要があります。

Screen Classのstaticメンバーに関する内容を編集することが出来ます。

• [Pull] : Screen Classのstaticメンバーを取得します。
• [Push] : 編集した内容を実機上に書き戻します。

Time Classのstaticメンバーに関する内容を編集することが出来ます。

• [Pull] : Time Classのstaticメンバーを取得します。
• [Push] : 編集した内容を実機上に書き戻します。

Application Classのstaticメンバーに関する内容を編集することが出来ます。 また、Application.Quit()を実行することが可能です。

• [Pull] : Application Classのstaticメンバーを取得します。
• [Push] : 編集した内容を実機へ上書きします。
• [Quit] : Application.Quite()を実行します。

Androidデバイス固有の機能を編集することが出来ます。

QualitySettingを編集することが出来ます。

renderFrameInterval を調整することが出来ます。 Home画面等画面の動きが激しく無い場合、値を調整することで、バッテリー消費を抑えることが期待出来ます。

ScalableBufferManagerを編集することが出来ます。 この機能を使用する場合、下記の条件を満たしている必要があります。

• Project Settings -> Enable Frame Timing Statsにチェックを入れた状態でアプリケーションをビルドしている。
• CameraもしくはRenderTextureのAllow Dynamic Resolutionが有効になっている。
• プラットフォーム(及びGraphicドライバ)が下記のいずれかである
  • Xbox One
  • PS4
  • Nintendo Switch
  • iOS/tvOS (Metal のみ)
  • Android (Vulkan のみ)