UVCDrawer.cs 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495
  1. //#define ENABLE_LOG
  2. /*
  3. * Copyright (c) 2014 - 2022 t_saki@serenegiant.com
  4. */
  5. using System;
  6. using System.Collections;
  7. using System.Collections.Generic;
  8. using UnityEngine;
  9. using UnityEngine.Events;
  10. using UnityEngine.UI;
  11. namespace Serenegiant.UVC
  12. {
  13. public class UVCDrawer : MonoBehaviour, IUVCDrawer
  14. {
  15. /**
  16. * IUVCSelectorがセットされていないとき
  17. * またはIUVCSelectorが解像度選択時にnullを
  18. * 返したときのデフォルトの解像度(幅)
  19. */
  20. public int DefaultWidth = 1280;
  21. /**
  22. * IUVCSelectorがセットされていないとき
  23. * またはIUVCSelectorが解像度選択時にnullを
  24. * 返したときのデフォルトの解像度(高さ)
  25. */
  26. public int DefaultHeight = 720;
  27. /**
  28. * 可能な場合にUACから音声取得を行うかどうか
  29. */
  30. public bool UACEnabled = false;
  31. /**
  32. * 接続時及び描画時のフィルタ用
  33. */
  34. public UVCFilter[] UVCFilters;
  35. /**
  36. * UVC機器からの映像の描画先Materialを保持しているGameObject
  37. * 設定していない場合はこのスクリプトを割当てたのと同じGameObjecを使う。
  38. */
  39. public List<GameObject> RenderTargets;
  40. /**
  41. * UVC機器のUAC機能で取得した音声を再生するために使用するAudioSourceを保持するGameObject
  42. * 設定していない場合はこのスクリプトを割当てたのと同じGameObjecを使う。
  43. */
  44. public GameObject AudioTarget;
  45. [HideInInspector]
  46. public Action<Texture> StartPreviewAction;
  47. [HideInInspector]
  48. public Action StopPreviewAction;
  49. public UnityEvent<Texture> StartPreviewEvent;
  50. //--------------------------------------------------------------------------------
  51. private const string TAG = "UVCDrawer#";
  52. /**
  53. * UVC機器からの映像の描画先Material
  54. * TargetGameObjectから取得する
  55. * 優先順位:
  56. * TargetGameObjectのSkybox
  57. * > TargetGameObjectのRenderer
  58. * > TargetGameObjectのRawImage
  59. * > TargetGameObjectのMaterial
  60. * いずれの方法でも取得できなければStartでUnityExceptionを投げる
  61. */
  62. private UnityEngine.Object[] TargetMaterials;
  63. /**
  64. * オリジナルのテクスチャ
  65. * UVCカメラ映像受け取り用テクスチャをセットする前に
  66. * GetComponent<Renderer>().material.mainTextureに設定されていた値
  67. */
  68. private Texture[] SavedTextures;
  69. private Quaternion[] quaternions;
  70. //================================================================================
  71. // Start is called before the first frame update
  72. void Start()
  73. {
  74. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  75. Console.WriteLine($"{TAG}Start:");
  76. #endif
  77. UpdateRenderTarget();
  78. }
  79. // // Update is called once per frame
  80. // void Update()
  81. // {
  82. //
  83. // }
  84. //================================================================================
  85. /**
  86. * UVC機器が接続された
  87. * IOnUVCAttachHandlerの実装
  88. * @param manager 呼び出し元のUVCManager
  89. * @param device 対象となるUVC機器の情報
  90. * @return true: UVC機器を使用する, false: UVC機器を使用しない
  91. */
  92. public bool OnUVCAttachEvent(UVCManager manager, UVCDevice device)
  93. {
  94. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  95. Console.WriteLine($"{TAG}OnUVCAttachEvent:{device}");
  96. #endif
  97. // XXX 今の実装では基本的に全てのUVC機器を受け入れる
  98. // ただしTHETA SとTHETA VとTHETA Z1は映像を取得できないインターフェースがあるのでオミットする
  99. // IsUVCEnabledと同様にUVC機器フィルターをインスペクタで設定できるようにする
  100. var result = !device.IsRicoh || device.IsTHETA;
  101. result &= UVCFilter.Match(device, UVCFilters);
  102. return result;
  103. }
  104. /**
  105. * UVC機器が取り外された
  106. * IOnUVCDetachEventHandlerの実装
  107. * @param manager 呼び出し元のUVCManager
  108. * @param device 対象となるUVC機器の情報
  109. */
  110. public void OnUVCDetachEvent(UVCManager manager, UVCDevice device)
  111. {
  112. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  113. Console.WriteLine($"{TAG}OnUVCDetachEvent:{device}");
  114. #endif
  115. }
  116. // /**
  117. // * 解像度選択
  118. // * IOnUVCSelectSizeHandlerの実装
  119. // * @param manager 呼び出し元のUVCManager
  120. // * @param device 対象となるUVC機器の情報
  121. // * @param formats 対応している解像度についての情報
  122. // */
  123. // public SupportedFormats.Size OnUVCSelectSize(UVCManager manager, UVCDevice device, SupportedFormats formats)
  124. // {
  125. //#if (!NDEBUG && DEBUG && ENABLE_LOG)
  126. // Console.WriteLine($"{TAG}OnUVCSelectSize:{device}");
  127. //#endif
  128. // if (device.IsTHETA_V || device.IsTHETA_Z1)
  129. // {
  130. //#if (!NDEBUG && DEBUG && ENABLE_LOG)
  131. // Console.WriteLine($"{TAG}OnUVCSelectSize:THETA V/Z1");
  132. //#endif
  133. // return FindSize(formats, 3840, 1920);
  134. // }
  135. // else if (device.IsTHETA_S)
  136. // {
  137. //#if (!NDEBUG && DEBUG && ENABLE_LOG)
  138. // Console.WriteLine($"{TAG}OnUVCSelectSize:THETA S");
  139. //#endif
  140. // return FindSize(formats, 1920, 1080);
  141. // }
  142. // else
  143. // {
  144. //#if (!NDEBUG && DEBUG && ENABLE_LOG)
  145. // Console.WriteLine($"{TAG}OnUVCSelectSize:other UVC device,{device}");
  146. //#endif
  147. // return formats.Find(DefaultWidth, DefaultHeight);
  148. // }
  149. // }
  150. /**
  151. * IUVCDrawerが指定したUVC機器の映像を描画できるかどうかを取得
  152. * IUVCDrawerの実装
  153. * @param manager 呼び出し元のUVCManager
  154. * @param device 対象となるUVC機器の情報
  155. */
  156. public bool IsUVCEnabled(UVCManager manager, UVCDevice device)
  157. {
  158. return UVCFilter.Match(device, UVCFilters);
  159. }
  160. /**
  161. * 映像取得を開始した
  162. * IUVCDrawerの実装
  163. * @param manager 呼び出し元のUVCManager
  164. * @param device 対象となるUVC機器の情報
  165. * @param tex UVC機器からの映像を受け取るTextureインスタンス
  166. */
  167. public void OnUVCStartEvent(UVCManager manager, UVCDevice device, Texture tex)
  168. {
  169. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  170. Console.WriteLine($"{TAG}OnUVCStartEvent:{device}");
  171. #endif
  172. HandleOnStartPreview(tex);
  173. StartPreviewEvent.Invoke(tex);
  174. StartPreviewAction?.Invoke(tex);
  175. }
  176. /**
  177. * 映像取得を終了した
  178. * IUVCDrawerの実装
  179. * @param manager 呼び出し元のUVCManager
  180. * @param device 対象となるUVC機器の情報
  181. */
  182. public void OnUVCStopEvent(UVCManager manager, UVCDevice device)
  183. {
  184. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  185. Console.WriteLine($"{TAG}OnUVCStopEvent:{device}");
  186. #endif
  187. HandleOnStopPreview();
  188. StopPreviewAction?.Invoke();
  189. }
  190. /**
  191. * IUVCDrawerが指定したUAC機器kからの音声を取得を有効にするかどうか取得
  192. * XXX とりあえずUACに対応した機器であればtrueを返す, 必要に応じて書き換えること
  193. * IUVCDrawerの実装
  194. * @param manager 呼び出し元のUVCManager
  195. * @param device 対象となるUAC機器の情報
  196. */
  197. public bool IsUACEnabled(UVCManager manager, UVCDevice device)
  198. {
  199. return UACEnabled && device.isUAC;
  200. }
  201. /**
  202. * UAC機器からの音声取得を開始した
  203. * @param manager 呼び出し元のUVCManager
  204. * @param device 接続されたUVC機器情報
  205. * @param audioClip UAC機器からの音声を受け取るAudioClipオブジェクト
  206. */
  207. public void OnUACStartEvent(UVCManager manager, UVCDevice device, AudioClip audioClip)
  208. {
  209. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  210. Console.WriteLine($"{TAG}OnUACStartEvent:{device}");
  211. #endif
  212. HandleOnStartAudio(audioClip);
  213. }
  214. /**
  215. * UAC機器からの音声取得を終了した
  216. * @param manager 呼び出し元のUVCManager
  217. * @param device 接続されたUVC機器情報
  218. */
  219. public void OnUACStopEvent(UVCManager manager, UVCDevice device)
  220. {
  221. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  222. Console.WriteLine($"{TAG}OnUACStopEvent:{device}");
  223. #endif
  224. HandleOnStopAudio();
  225. }
  226. //================================================================================
  227. /**
  228. * 描画先を更新
  229. */
  230. private void UpdateRenderTarget()
  231. {
  232. bool found = false;
  233. if ((RenderTargets != null) && (RenderTargets.Count > 0))
  234. {
  235. TargetMaterials = new UnityEngine.Object[RenderTargets.Count];
  236. SavedTextures = new Texture[RenderTargets.Count];
  237. quaternions = new Quaternion[RenderTargets.Count];
  238. int i = 0;
  239. foreach (var target in RenderTargets)
  240. {
  241. if (target != null)
  242. {
  243. var material = TargetMaterials[i] = GetTargetMaterial(target);
  244. if (material != null)
  245. {
  246. found = true;
  247. }
  248. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  249. Console.WriteLine($"{TAG}UpdateRenderTarget:material={material}");
  250. #endif
  251. }
  252. i++;
  253. }
  254. }
  255. if (!found)
  256. { // 描画先が1つも見つからなかったときはこのスクリプトが
  257. // AddComponentされているGameObjectからの取得を試みる
  258. // XXX RenderTargetsにgameObjectをセットする?
  259. TargetMaterials = new UnityEngine.Object[1];
  260. SavedTextures = new Texture[1];
  261. quaternions = new Quaternion[1];
  262. TargetMaterials[0] = GetTargetMaterial(gameObject);
  263. found = TargetMaterials[0] != null;
  264. }
  265. if (!found)
  266. {
  267. throw new UnityException("no target material found.");
  268. }
  269. }
  270. /**
  271. * テクスチャとして映像を描画するMaterialを取得する
  272. * 指定したGameObjectにSkybox/Renderer/RawImage/MaterialがあればそれからMaterialを取得する
  273. * それぞれが複数割り当てられている場合最初に見つかった使用可能ものを返す
  274. * 優先度: Skybox > Renderer > RawImage > Material
  275. * @param target
  276. * @return 見つからなければnullを返す
  277. */
  278. UnityEngine.Object GetTargetMaterial(GameObject target/*NonNull*/)
  279. {
  280. // Skyboxの取得を試みる
  281. var skyboxs = target.GetComponents<Skybox>();
  282. if (skyboxs != null)
  283. {
  284. foreach (var skybox in skyboxs)
  285. {
  286. if (skybox.isActiveAndEnabled && (skybox.material != null))
  287. {
  288. RenderSettings.skybox = skybox.material;
  289. return skybox.material;
  290. }
  291. }
  292. }
  293. // Skyboxが取得できなければRendererの取得を試みる
  294. var renderers = target.GetComponents<Renderer>();
  295. if (renderers != null)
  296. {
  297. foreach (var renderer in renderers)
  298. {
  299. if (renderer.enabled && (renderer.material != null))
  300. {
  301. return renderer.material;
  302. }
  303. }
  304. }
  305. // SkyboxもRendererも取得できなければRawImageの取得を試みる
  306. var rawImages = target.GetComponents<RawImage>();
  307. if (rawImages != null)
  308. {
  309. foreach (var rawImage in rawImages)
  310. {
  311. if (rawImage.enabled && (rawImage.material != null))
  312. {
  313. return rawImage;
  314. }
  315. }
  316. }
  317. // SkyboxもRendererもRawImageも取得できなければMaterialの取得を試みる
  318. var material = target.GetComponent<Material>();
  319. if (material != null)
  320. {
  321. return material;
  322. }
  323. return null;
  324. }
  325. private void RestoreTexture()
  326. {
  327. for (int i = 0; i < TargetMaterials.Length; i++)
  328. {
  329. var target = TargetMaterials[i];
  330. try
  331. {
  332. if (target is Material)
  333. {
  334. (target as Material).mainTexture = SavedTextures[i];
  335. }
  336. else if (target is RawImage)
  337. {
  338. (target as RawImage).texture = SavedTextures[i];
  339. }
  340. }
  341. catch
  342. {
  343. Console.WriteLine($"{TAG}RestoreTexture:Exception cought");
  344. }
  345. SavedTextures[i] = null;
  346. quaternions[i] = Quaternion.identity;
  347. }
  348. }
  349. private void ClearTextures()
  350. {
  351. for (int i = 0; i < SavedTextures.Length; i++)
  352. {
  353. SavedTextures[i] = null;
  354. }
  355. }
  356. /**
  357. * 映像取得開始時の処理
  358. * @param tex 映像を受け取るテクスチャ
  359. */
  360. private void HandleOnStartPreview(Texture tex)
  361. {
  362. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  363. Console.WriteLine($"{TAG}HandleOnStartPreview:({tex})");
  364. #endif
  365. int i = 0;
  366. foreach (var target in TargetMaterials)
  367. {
  368. if (target is Material)
  369. {
  370. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  371. Console.WriteLine($"{TAG}HandleOnStartPreview:assign Texture to Material({target})");
  372. #endif
  373. SavedTextures[i++] = (target as Material).mainTexture;
  374. (target as Material).mainTexture = tex;
  375. }
  376. else if (target is RawImage)
  377. {
  378. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  379. Console.WriteLine($"{TAG}HandleOnStartPreview:assign Texture to RawImage({target})");
  380. #endif
  381. SavedTextures[i++] = (target as RawImage).texture;
  382. (target as RawImage).texture = tex;
  383. }
  384. }
  385. }
  386. /**
  387. * 映像取得が終了したときのUnity側の処理
  388. */
  389. private void HandleOnStopPreview()
  390. {
  391. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  392. Console.WriteLine($"{TAG}HandleOnStopPreview:");
  393. #endif
  394. // 描画先のテクスチャをもとに戻す
  395. RestoreTexture();
  396. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  397. Console.WriteLine($"{TAG}HandleOnStopPreview:finished");
  398. #endif
  399. }
  400. /**
  401. * UACの音声再生を行うAudioSourceを取得する
  402. */
  403. private AudioSource GetAudioSource()
  404. {
  405. AudioSource result = null;
  406. if (AudioTarget != null)
  407. {
  408. result = AudioTarget.GetComponent<AudioSource>();
  409. }
  410. if (result == null)
  411. {
  412. result = GetComponent<AudioSource>();
  413. }
  414. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  415. if (result == null)
  416. {
  417. Console.WriteLine($"{TAG}GetAudioSource:audio source not found");
  418. }
  419. #endif
  420. return result;
  421. }
  422. /**
  423. * 音声取得開始した時のUnity側の処理
  424. * @param audioClip
  425. */
  426. private void HandleOnStartAudio(AudioClip audioClip)
  427. {
  428. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  429. Console.WriteLine($"{TAG}HandleOnStartAudio:");
  430. #endif
  431. var audioSource = GetAudioSource();
  432. if (audioSource != null)
  433. {
  434. audioSource.Stop();
  435. audioSource.clip = audioClip;
  436. audioSource.Play();
  437. }
  438. }
  439. /**
  440. * 音声取得終了した時のUnity側の処理
  441. */
  442. private void HandleOnStopAudio()
  443. {
  444. #if (!NDEBUG && DEBUG && ENABLE_LOG)
  445. Console.WriteLine($"{TAG}HandleOnStopAudio:");
  446. #endif
  447. var audioSource = GetAudioSource();
  448. if (audioSource != null)
  449. {
  450. audioSource.Stop();
  451. audioSource.clip = null;
  452. }
  453. }
  454. } // class UVCDrawer
  455. } // namespace Serenegiant.UVC