UniWindowController

Unified window controller for macOS and Windows
略称：UniWinC（ユニウィンク）

概要

Unity の Windows / macOS 向けビルドで、自ウィンドウの位置、サイズ、透過をコントロールします。

Windows、macOS それぞれではコード例やアセットが見つかりましたが、統一的に扱えるものが無さそうだったため作成しました。

https://twitter.com/i/status/1314440790945361920

ダウンロード

https://github.com/kirurobo/UniWindowController/releases に .unitypackage ファイルがあります。

また、アプリとしてビルドしたサンプルも置いています。

利用法

Unitypackage から自分の Unity プロジェクトにインポート
Prefabs にある UniWindowController プレハブをシーンに追加
そこで配置された UniWindowController をインスペクターで確認
1. ProjectSettings を適切に直す（緑のボタンでまとめて設定が変更されます）
2. Is Transparent 等、設定をお好みに合わせる
PC / Mac スタンドアローンでビルドする
ビルドしたものを起動

制限事項

Unityエディタ上では透過はできません。ビルドをしてお試しください。
- 常に最前面やウィンドウ移動等は動作しますが、実行中にゲームビューを閉じたりドッキングの配置を変えることはお勧めしません。一応、ゲームビューにフォーカスを移すとウィンドウを再取得はします。
マウスでは良いのですが、タッチ操作には適切な対応がまだ定まっていません。
あまり動作検証をできている訳でもなく、安定して動くとは限りません。

既知の問題については Issues もご覧ください。

動作環境

Unity 2018 以降
- 開発は Unity 2018.4.20f1 で行っています
Windows 10 or macOS
- macOS の開発は 10.15.7 で行っています
  - 手元の1つのMacでしか検証できないので、動かした人がいたら教えてほしいです！

ヒットテストについて

正常にウィンドウを透過できると、あたかも長方形ではないウィンドウのように見えます。
ですがそれは見た目だけで、実は長方形のウィンドウとして存在しています。
そこで、マウスカーソルの直下を見て、透明ならばマウス操作を下のウィンドウに受け流す（クリックスルー）状態とし、不透明なら通常に戻す、という"ヒットテスト"を常に行なうことで、あたかも見える部分しか存在しないように見せています。

このヒットテストについては2種類用意してあります。（自動ヒットテストを無効にして、自分で制御する、またはしないという選択も可能です。）

Name	Description	Note
Opacity	透明度を見る	見た目と一致して自然だが、処理が重い
Raycast	Coliderを見る	より動作が軽いが、Coliderの用意が必要

Raycastの方法の方がパフォーマンス的に推奨ですが、Coliderを忘れると触れなくなるため、デフォルトでは Opacity としています。

また注意として、タッチ操作だとあらかじめ指の下の色を確認できないため、操作に違和感を感じると思います。
どのように対応すべきかベストの解決策が見つかっていないため、タッチ対応に関してはすみませんが後回しとなっています。

透過方法について（Windowsのみ選択可）

タッチ操作に対応する一つの方法として、layered window の単色透過を選択できるようにしてあります。
これを選ぶと半透明が表現できず、パフォーマンスも落ちますが、ヒットテストをWindowsに任せるためタッチ操作に対しては感覚に一致するはずです。

Name	Description	Note
Alpha	レンダリング結果の透明度を反映	こちらが標準
ColorKey	RGBが一致する一色のみ透過	パフォーマンス悪いが、タッチは自然

C# スクリプト

Unityで他のスクリプトから操作できるものです。
仕様は固まってはいないため、変更される場合があります。