웹 플레이어 탬플릿의 사용 - 유니티3D ( Unity3D )

문서의 이전 판을 선택했습니다! 저장하면 이 자료로 새 판을 만듭니다.

======웹 플레이어 탬플릿의 사용======
======데스크탑!======
>>desktop<<
======웹 플레이어 탬플릿의 사용======

웹 플레이어 프로젝트를 빌드할 때, Unity는 그것이 브라우저에서 재생될 수 있도록 HTML에 플레이어를 내장합니다. 기본적인 페이지는 매우 간단하여, 최소한의 텍스트가 나타난 흰색 배경뿐입니다. 실제는 이 페이지의 세 가지 다른 변형이 있어, Player Settings 인스펙터에 선택할 수 있습니다(메뉴: Edit > Project Settings > Player).

내장된 HTML 페이지는 테스트와 최소한의 플레이어를 보여주는 용도로는 괜찮지만, 출시 목적에는 적합하지 않습니다. 그러므로 최종적으로 배포될 페이지 내에서 플레이어가 호스팅 되는 것을 볼 필요가 자주 생길 것 입니다. 예를 들어, Unity 콘텐트가 외부 콜 인터페이스를 통해 페이지 내에서 다른 요소(element)와 상호작용을 한다면, 그러한 사용작용을 하는 요소가 제공되는 페이지에서 테스트 되어야 합니다. Unity는 _webplayer templates_을 사용하여 그 플레이어를 호스팅 할 사용자 자신의 페이지를 제공할 수 있게 해 줍니다.

=====웹 플레이어(Webplayer Template)의 구조=====

사용자 맞춤 템플릿은 에셋 폴더 내에서 "WebPlayerTemplates"이라 불리는 폴더를 만들어 프로젝트에 추가 될 수 있습니다 – 이 템플릿 그 자체가 이 폴더 내의 하위 폴더입니다. 각 템플릿 폴더는 이미지나 스타일 시트와 같이 그 페이지에 필요한 다른 리소스와 함께 index.html 이나 index.php 파일을 포함합니다.

일단 생성되면, 그 템플릿 파일은 Player Settings 인스펙터 상의 옵션 중에 나타납니다 (그 템플릿의 이름은 그 폴더와 같을 것 입니다). 선택적으로, 그 폴더는 thumbnail.png라는 이름의 파일을 포함할 수 있는데, 이는 128x128의 크기이어야 합니다. Thumbnail 이미지는 완성된 페이지가 어떻게 보일지에 대한 힌트를 주기 위해여 인스펙터에 나타납니다.

=====탬플릿 태그(Tags)=====

빌드 과정 동안, Unity는 페이지에서 특별한 태그 문자열을 찾아 편집기에서 제공하는 값으로 바꿉니다. 이들은 이름, 화면상의 크기, 그리고 기타 여러가지 플레이어에 대한 유용한 정보를 포함합니다.

태그는 페이지 소스에서 퍼센트 기호(%)로 구분됩니다. 예를 들면, Player 설정에서 제품의 이름이 "MyPlayer"으로 정의되면:-

<file csharp><title>%UNITY_WEB_NAME%</title></file>
	
... 탬플릿의 인덱스 파일에서, 다음과 같이

<file csharp><title>MyPlayer</title></file>

... 빌드을 위해 생성된 호스트 페이지에서 이와 같이 대체됩니다. 태그의 목록 전체는 다음과 같습니다:-

//UNITY_WEB_NAME//\\
웹플레이어의 이름

//UNITY_WIDTH//\\
//UNITY_HEIGHT//\\
웹플레이어의 화면상의 넓이와 높이를 픽셀로 표시.

//UNITY_WEB_PATH//\\
웹플레이어 파일의 로컬 경로

//UNITY_UNITYOBJECT_LOCAL//\\
UnityObject.js라고 불리는 브라우저 JavaScript 파일을 사용하여 호스트 페이지에 플레이어를 내장하고 Unity와 호스트의 JavaScript 간의 상호작용을 제공합니다. 이는 보통 Unity의 웹사이트에서 다운로드 하여 페이지에 제공합니다. 하지만, 이렇게 하려면 인터넷연결이 필요하고 만일 그 페이지가 사용자의 하드디스크에서 배포되었다면 문제를 야기합니다. 이 태그는 만일 Build Settings 내의 Offline Deployment 옵션이 켜지면 UnityObject.js 파일을 생성하여 로컬 경로를 제공합니다.

//UNITY_UNITYOBJECT_URL//\\
이 페이지가 UnityObject.js을 Unity의 웹사이트에서 다운로드 하는 일반적인 경우에(예: Offline Deployment 옵션이 겨짐), 이 태그는 다운로드 하는 URL을 제공할 것입니다.

//UNITY_BETA_WARNING//\\
만일 웹플레이가 Unity의 베타 버전으로 빌드되었다면, 이 태그는 그 사실에 대한 간단한 메시지로 대체될 것 입니다. 아니면, 아무것과도 대체되지 않습니다.

//UNITY_CUSTOM_SOME_TAG//\\
만일 태그 하나를 UNITY_CUSTOM_XXX 의 형태로 인덱스 파일에 추가하면, 이 태그는 사용자 탬플릿이 선택되면 Player Settings에 나타나게 됩니다. 예를 들어, 만일 다음과 같은 것이,

<file csharp><title>Unity Web Player|%UNITY_CUSTOM_MYTAG%</title></file>

... 소스에 추가되면, 그 Player Settings은 다음과 같이 보여집니다:-

태그 이름 옆에 있는 텍스트 박스는 빌드되는 동안 그 사용자 정의 태그가 바뀌는 텍스트를 포함합니다.

=====예제=====

태그의 사용을 설명하기 위해, 다음과 같이 Unity가 디폴트 웹플레이어 빌드에 사용하는 HTML 소스를 포함합니다.

<file csharp><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<title>Unity Web Player|%UNITY_WEB_NAME%</title>
		<script type="text/javascript" src="%UNITY_UNITYOBJECT_URL%"></script>
		<script type="text/javascript">
		
		</script>
		<style type="text/css">
		
		</style>
	</head>
	<body>
		<p class="header"><span>Unity Web Player|</span>%UNITY_WEB_NAME%</p>%UNITY_BETA_WARNING%
		<div class="content">
			<div id="unityPlayer">
				<div class="missing">
					<a href="http://unity3d.com/webplayer/" title="Unity Web Player. Install now!">
						<img alt="Unity Web Player. Install now!" src="http://webplayer.unity3d.com/installation/getunity.png" width="193" height="63" />
					</a>
				</div>
			</div>
		</div>
		<p class="footer">&laquo; created with <a href="http://unity3d.com/unity/" title="Go to unity3d.com">Unity</a> &raquo;</p>
	</body>
</html></file>

{{tag>유니티 unity}}
   * 출처: [[http://unitykoreawiki.com/index.php?n=KrMain.UsingWebPlayertemplates|유니티코리아위키]] (CC BY-NC-SA 2.0)

2+1? 이 필드는 비어 있도록 유지하세요:

편집 요약

참고: 이 문서를 편집하면 내용은 다음 라이선스에 따라 배포하는 데 동의하는 것으로 간주합니다: CC Attribution-Noncommercial-Share Alike 4.0 International

연결문서