목차
Working with UnityObject
Desktop!
UnityObject
는 유니티 컨텐츠를 HTML에 삽입해서 간략화하는 자바 스크립트 입니다. 이것은 유니티 Web Player
플러그인을 감지하는 기능, 웹 플레이러 설치를 시작, 유니티 컨텐츠를 삽입하는 기능이 있습니다. HTML파일과 함께 UnityObject.js 파일을 웹서버에 올리는 것도 가능하지만 그것을 [=http://webplayer.unity3d.com/download_webplayer-3.x/3.0/uo/UnityObject.js=]//에 있는 유니티 서버로 부터 직접 로드하는 것이 가장 좋습니다. 이런 방법으로 사용자는 항상 최신 버전의 UnityObject를 참조할 수 있습니다. 유니티 서버에 있는 UnityObject.js 파일은 그것을 작게 만들고 트래픽을 줄이기위해 작게 만들어져 있다는 것을 유의하세요. 소스코드를 살펴보고 싶으면 윈도우즈의 Data\Resources 폴더 또는 Mac OS X의 Contents/Resources 폴더 에서 원본 파일을 찾을수 있습니다. 기본적으로 UnityObject는 저희가 설치 타입이나 변환 비율을 식별하는데 도움을 주는 GoogleAnalytics에 익명의 데이터를 보냅니다.
=====Functions=====
====embedUnity====
HTML에 유니티 컨텐츠를 삽입하세요.
Parameters:
*id - 유니티 컨텐츠에 의해 교체될HTML 요소.
*src - 웹 플레이어 데이터 파일의 경로. 상대적 또는 절대 경로일 수 있습니다.
*width - 유니티 컨텐츠의 넓이. 픽셀 값으로 정의되며(i즉 600, "450") 또는 비율 값으로 정의됨(즉 "50%", "100%").
*height - 유니티 컨텐츠의 높이. 픽셀 값으로 정의되며(즉 600, "450") 또는 비율 값으로 정의됨(즉 "50%", "100%").
*params - Optional. 파라이터 리스트를 가직고 있는 객체. 가능한 값은 Customizing the Unity Web Player loading screen와 Customizing the Unity Web Player's Behavior를 보세요.
*attributes - Optional. 속성 리스트를 가지고 있는 객체. 이것은 브라우저에 따라 <object> 또는 <embed> 태그에 추가됩니다.
*callback - Optional. 웹 플레이어가 로드될 때 불리는함수. 함수는 다음의 속성을 가지는 하나의 인자를 받아야 합니다:
success - 작업이 성공 했는지 알려주는Boolean 값.
id - 로드된 웹 플레이어 객체 식별자(placeholder와 같음).
**ref - 로드된 웹 플레이어 객체.
주의:
이 함수는 보통 작업이 끝나기전에 리턴을 합니다. 그러므로 웹 플레이어 객체에 즉시 접근하는 것은 안전하지 않습니다. 완료를 알리기위해 콜백 함수가 제공 됩니다. 또 다르게는 getObjectById를 null 값을 리턴하지 않을 때까지 반복적으로 콜 하세요.
예:
<file csharp>
<!DOCTYPE html PUBLIC "-W3CDTD XHTML 1.0 StrictEN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head> <title>Unity Web Player|Example</title> <script type="text/javascript" src="http://webplayer.unity3d.com/download_webplayer-3.x/3.0/uo/UnityObject.js"></script> <script type="text/javascript"> <!-- if (typeof unityObject != "undefined") { unityObject.embedUnity("unityPlayer", "Example.unity3d", 600, 450, null, null, unityLoaded); } function unityLoaded(result) { if (result.success) { var unity = result.ref; var version = unity.GetUnityVersion("3.x.x"); alert("Unity Web Player loaded!nId: " + result.id + "nVersion: " + version); } else { alert("Please install Unity Web Player!"); } } --> </script> </head> <body> <!-- This will be replaced by Unity content. --> <div id="unityPlayer">Unity content can't be played. Make sure you are using compatible browser with JavaScript enabled.</div> </body>
</html> </file>
getObjectById
웹 플레이어 객체를 받아 옵니다.
Parameters:
- id - 웹 플레이어 객체 식별자.
- callback - Optional. 웹 플레이어가 로드될 때 불리는함수. 함수는 다음의 속성을 가지는 하나의 인자를 받아야 합니다.
웹 플레이어 객체 또는 웹 플레이어가 로드 되지 않았을 때 null 값을 리턴합니다.
예:
<!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|Example</title> <script type="text/javascript" src="http://webplayer.unity3d.com/download_webplayer/3.0/uo/UnityObject.js"></script> <script type="text/javascript"> <!-- if (typeof unityObject != "undefined") { unityObject.embedUnity("unityPlayer", "Example.unity3d", 600, 450, null, null, function(result) { if (result.success) { var versionButton = document.getElementById("versionButton"); versionButton.disabled = false; } }); } function versionButtonClick() { var unity = unityObject.getObjectById("unityPlayer"); var version = unity.GetUnityVersion("3.x.x"); alert(version); } --> </script> </head> <body> <!-- This will be replaced by Unity content. --> <div id="unityPlayer">Unity content can't be played. Make sure you are using compatible browser with JavaScript enabled.</div> <div> <input id="versionButton" type="button" value="Version" disabled="disabled" onclick="versionButtonClick();" /> </div> </body> </html>
enableFullInstall
완전한 웹 플레이어가 있지 않으면 설치 합니다. 보통 작은 부분의 웹 플레이어가 설치되어 있고 나머지 파일은 자동으로 나중에 다운로드 됩니다. 기본 값은 false입니다.
Parameters:
- value - 기능을 활성/비활성화 시키는 Boolean 값.
enableAutoInstall
웹 플레이어가 있지 않으면 자동으로 설치를 시작합니다. 어떤 플랫폼은 이 기능을 지원하지 않습니다. 기본 값은 false입니다.
Parameters:
- value - 기능을 활성/비활성화 시키는 Boolean 값.
enableJavaInstall
자바 기반의 설치를 활성화 합니다. 어떤 플랫폼은 이 기능을 지원하지 않습니다. 기본 값은 true입니다.
Parameters:
- value - 기능을 활성/비활성화 시키는 Boolean 값.
enableClickOnceInstall
ClickOnce 기반의 설치를 활성화 합니다. 어떤 플랫폼은 이 기능을 지원하지 않습니다. 기본 값은 true입니다.
Parameters:
- value - 기능을 활성/비활성화 시키는 Boolean 값.
enableGoogleAnalytics
유니티에게 웹 플레이어 설치를 알립니다. 이것은 웹 플레이어가 이미 설치되어 있으면 아무것도 하지 않습니다. 기본 값은 true입니다.
Parameters:
- value - 기능을 활성/비활성화 시키는 Boolean 값.
addLoadEvent
웹 페이지가 로드될 때 불리는 함수로 등록합니다.
Parameters:
- event - 웹 페이지가 로드될 때 불리는 함수. 이 함수는 파라미터를 가지지 않습니다.
addDomLoadEvent
웹 페이지의 DOM이 로드될 때 불리는 함수로 등록합니다.
Parameters:
- event - 웹 페이지가 로드될 때 불리는 함수. 이 함수는 파라미터를 가지지 않습니다.
- 출처: 유니티코리아위키 (CC BY-NC-SA 2.0)