기술 자료

Unity 엔진

Unity 엔진

Unity 웹 빌드의 JavaScript 인터페이스

JavaScript 인터페이스에서 사용할 수 있는 몇 가지 유용한 기능에 대해 알아보십시오.
읽는 시간 2분최근 업데이트: 9일 전

Unity 웹 빌드의 JavaScript 인터페이스는 웹 애플리케이션을 구성하는 데 사용할 수 있는 유용한 함수와 변수를 제공합니다. JavaScript 라이브러리 코드(.jslib 파일)에서 이러한 함수를 호출할 수 있습니다.

오류, 경고 또는 커스텀 배너 표시

unityShowBanner()
함수를 사용하여 메시지 배너를 표시하거나 함수를 오버라이드하여 사용자의 목적으로 커스터마이즈합니다.

파라미터

설명

msg
표시할 메시지입니다.
type
표시할 메시지 타입입니다. 예제는 아래와 같습니다.
  • type == error
    를 사용하여 캔버스 위에 영구적인 오류 메시지를 표시합니다.
  • type == warning
    를 사용하여 메시지 위에 노란색 하이라이트 컬러를 표시합니다.
기본 WebGL 템플릿의 다음 코드는 오류와 경고 배너의 형상을 설정합니다. 커스텀 템플릿에서 이 함수를 오버라이드하여 자체 배너 타입을 만들거나 비중요한 경고 및 오류 메시지가 표시되는 방법을 커스터마이즈할 수 있습니다.
function unityShowBanner(msg, type) { var warningBanner = document.querySelector("#unity-warning"); function updateBannerVisibility() { warningBanner.style.display = warningBanner.children.length ? 'block' : 'none'; } var div = document.createElement('div'); div.innerHTML = msg; warningBanner.appendChild(div); if (type == 'error') div.style = 'background: red; padding: 10px;'; else { if (type == 'warning') div.style = 'background: yellow; padding: 10px;'; setTimeout(function() { warningBanner.removeChild(div); updateBannerVisibility(); }, 5000); } updateBannerVisibility(); }
.jslib 파일에서 함수를 호출할 수 있습니다. 다음 배너는 오류 메시지로 표시하려는 메시지를 영구적으로 표시합니다.
unityShowBanner('The message you want to show', 'error');

WebGL 컨텍스트 속성 변경

WebGL 컨텍스트가 초기화되는 생성 속성을 커스터마이즈하려면
webglContextAttributes
를 사용합니다. 다음 속성만 변경할 수 있습니다.
  • powerPreference
  • premultipliedAlpha
  • preserveDrawingBuffer
이 옵션은 WebGL 렌더링 API 사용하는 경우에만 적용됩니다. WebGPU 렌더링 API를 사용하는 경우
webglContextAttributes
필드가 무시됩니다.
이러한 속성을 변경하려면 커스텀 WebGL 템플릿에서 구성 오브젝트를 변경합니다. 예제는 아래와 같습니다.
script.onload = () => { config['webglContextAttributes'] = { powerPreference: '고성능', premultipliedAlpha: false, preserveDrawingBuffer: true, }; createUnityInstance(canvas, config, (progress) => {
powerPreference
속성에는 다음과 같은 옵션이 있습니다.

옵션

설명

기본사용자 에이전트가 가장 적합한 GPU 구성을 결정하도록 합니다. 기본값입니다.
고성능렌더링 성능을 전력 소비보다 우선시합니다.
저전력렌더링 성능보다 전력을 절약하는 것이 우선합니다.
각 속성에 대한 자세한 내용은 HTMLCanvasElement: getContext()에 대한 Mozilla 문서를 참조하십시오.
Unity WebGL 그래픽스에 대한 자세한 내용은 WebGL 그래픽스를 참조하십시오.

프로젝트를 스트리밍 에셋으로 다이렉트

다른 CDN에서 스트리밍 에셋을 호스팅해야 하는 경우, 스트리밍 에셋이 있는 전체 URL을 가리키도록
createUnityInstance()
구성 객체의
streamingAssetsUrl
프로퍼티를 조정할 수 있습니다.
var buildUrl = "Build";var config = { dataUrl: buildUrl + "/{{ DATA_FILENAME }}}", frameworkUrl: buildUrl + "/{{{ FRAMEWORK_FILENAME }}}", codeUrl: buildUrl + "/{{{ CODE_FILENAME }}}",#if MEMORY_FILENAME memoryUrl: buildUrl + "/{{ MEMORY_FILENAME }}}",#endif#if SYMBOLS_FILENAME symbolsUrl: buildUrl + "/{{{ SYMBOLS_FILENAME }}}",#endif streamingAssetsUrl: "https://mygameserver.com/StreamingAssets/", // 기본 스트리밍 에셋 위치를 오버라이드하려면 이 줄을 추가합니다. companyName: "{{ COMPANY_NAME }}}", productName: "{{ PRODUCT_NAME }}}", productVersion: "{{ PRODUCT_VERSION }}}",};

웹 페이지의 컨트롤 캐시

cacheControl()
함수를 사용하여
UnityCache
에 캐시되는 URL을 제어합니다. 함수는 URL을 파라미터로 받으며
must-revalidate
,
immutable
또는
no-store
를 반환합니다. 고유한 목적으로 함수를 오버라이드할 수도 있습니다.
코드 예시와 자세한 내용은 웹의 캐시 동작을 참고하십시오.

추가 리소스