기술 자료

Unity 엔진

Unity 엔진

Unity C# 스크립트에서 JavaScript 함수 호출

Unity 프로젝트 JavaScript 플러그인 또는 브라우저에서 함수를 호출합니다.
읽는 시간 3분최근 업데이트: 9일 전

Unity C# 코드에서 JavaScript 플러그인의 함수를 사용할 수 있습니다. 웹 페이지 또는 웹 API의 다른 요소와 통신해야 하므로 Unity JavaScript 코드를 사용하면 유용할 수 있습니다.
파일 유형과 Unity 스크립트와 상호 작용하기 위해 JavaScript 플러그인을 설정하는 방법에 대해 알아보려면 JavaScript 플러그인 설정을 참조하십시오. 대신 C/C++/C# 플러그인과 상호 작용하는 방법을 알아보려면 Unity C# 스크립트에서 C/C++/C# 함수 호출을 참조하십시오.

항목

설명

JavaScript에서 Unity로 다른 변수 전달Unity JavaScript 간에 다양한 변수를 전달하는 방법에 대한 팁입니다.
자체 범위에서 빌드 코드 실행Unity JavaScript 간의 코드 가시성을 개선하는 방법에 대한 팁입니다.
JavaScript 함수를 호출하는 Unity C# 코드 예시이 예제 코드는 Unity JavaScript 함수를 호출하는 방법을 보여 줍니다.
Unity 플러그인 참조레퍼런스로 사용할 수 있는 Unity 포함된 플러그인 리스트를 표시합니다.

JavaScript Unity 다양한 변수를 전달합니다.

JavaScript Unity 연동하려면 둘 사이에 효율적인 커뮤니케이션이 필요합니다. JavaScript Unity 다양한 데이터 유형을 전달하는 방법에 대한 다음 팁을 참고하십시오.

숫자 타입

간단한 숫자 타입을 변환하지 않고 함수 파라미터의 JavaScript 전달할 수 있습니다.
예를 들어 JavaScript 함수는 다음과 같습니다.
AddNumbers: 함수(x, y) { return x + y; },
는 전환 없이 C#의 정수 값을 허용합니다.
int 결과 = AddNumbers(5, 7);
Emscripten 힙에서 다른 데이터 유형을 포인터로 전달할 수 있습니다. Emscripten 힙은 JavaScript 메모리의 큰 배열일 뿐입니다.

문자열

문자열을 JavaScript 문자열로 변환하려면
UTF8ToString
헬퍼 함수를 사용합니다.
var stringMessage = UTF8ToString("Hello World");
문자열 값을 반환하려면
_malloc
를 호출하여 일부 메모리를 할당하고
stringToUTF8
헬퍼 함수를 호출하여 메모리에 JavaScript 문자열을 작성합니다. 문자열이 반환 값인 경우 IL2CPP 런타임이 자동으로 메모리를 확보합니다.
var returnStr = "Hello World"; var bufferSize = lengthBytesUTF8(returnStr) + 1; var buffer = _malloc(bufferSize); stringToUTF8(returnStr, buffer, bufferSize);

배열

프리미티브 타입의 배열의 경우 Emscripten은 메모리의 다른 크기의 정수, 부동 소수점 또는 부호 없는 정수(
HEAP8
,
HEAPU8
,
HEAP16
,
HEAPU16
,
HEAP32
,
HEAPU32
,
HEAPF32
,
HEAPF64
)에 대해 힙에 다른
ArrayBufferViews
를 제공합니다.
다음 함수는
HEAPF32
배열을 반복하여 각 인덱스의 값을 출력합니다.
PrintFloatArray: 함수(배열, 크기) { for(var i = 0; i < size; i++) console.log(HEAPF32[(array >> 2) + i]); },

텍스처

WebGL에서 텍스처에 액세스하기 위해 Emscripten은 Unity에서 WebGL 텍스처 오브젝트로 네이티브 텍스처 ID를 매핑하는
GL.textures
배열을 제공합니다. Emscripten의 WebGL 컨텍스트인
GLctx
에서 WebGL 함수를 호출할 수 있습니다.
예를 들어 다음 함수는 GL 텍스처 배열의 WebGL 텍스처를 2D 텍스처에 바인딩합니다.
BindWebGLTexture: 함수(텍스처) { GLctx.bindTexture(GLctx.TEXTURE_2D, GL.textures[texture]); },

자체 범위에서 빌드 코드 실행

모든 빌드 코드를 자체 범위에서 실행하는 것이 좋습니다. 자체 범위에 코드가 있는 경우 포함된 페이지 코드와 충돌하지 않고 콘텐츠를 페이지에 포함할 수 있으며, 동일한 페이지에 두 개 이상의 빌드를 포함할 수 있습니다.

.jslib 플러그인의 코드

프로젝트에 모든 JavaScript 코드가
.jslib
플러그인 형태로 있는 경우 이 JavaScript 코드는 컴파일된 빌드와 동일한 범위 내에서 실행되며 코드는 이전 Unity 버전과 동일한 방식으로 작동합니다. JavaScript 플러그인 코드에서 직접 볼 수 있는 객체 및 기능 중 일부는 다음과 같습니다.
  • Module
  • SendMessage
  • HEAP8
  • ccall

글로벌 범위에서 JavaScript 함수 호출

내부 JavaScript 함수를 내장된 페이지의 전역 범위에서 호출하려면 웹 템플릿
index.html
에서
unityInstance
변수를 사용해야 합니다.
Unity 엔진 인스턴스화가 성공한 후 다음과 같이
unityInstance
를 사용합니다.
var MyGameInstance = null; script.onload = () => { createUnityInstance(canvas, config, (progress) => { /*...*/ }).then((unityInstance) => { MyGameInstance = unityInstance;
그런 다음
MyGameInstance.SendMessage()
를 사용하여 빌드에 메시지를 보내거나
MyGameInstance.Module
를 사용하여 빌드 모듈 오브젝트에 액세스할 수 있습니다.

JavaScript 함수를 호출하는 Unity C# 코드 예

다음 JavaScript 코드는
Hello
라는 이름의 함수를 만듭니다. 이 예시에서는 Unity C# 스크립트에서 호출할 수 있도록 JavaScript 플러그인에서 이 코드를 사용합니다.
mergeInto(LibraryManager.library, { 안녕: 함수 () { window.alert("Hello, world!"); },});
그런 다음 Unity 프로젝트에서 다음 C# 코드를 사용하여 JavaScript 코드에서
Hello
함수를 호출합니다.
using UnityEngine;using System.Runtime.InteropServices;public class NewBehaviourScript : MonoBehaviour { [DllImport("__Internal")] private static extern void Hello(); void Start() { Hello(); }}
다양한 함수 유형의 더 큰 코드 예시는 다음의 코드 예시를 참조하십시오. Unity에서 JavaScript 및 C/C++/C# 함수를 호출합니다.

참고로 Unity 플러그인 사용

Unity 설치 폴더에는 다음과 같은 여러 플러그인이 있습니다.
  • PlaybackEngines/WebGLSupport/BuildTools/lib
  • PlaybackEngines/WebGLSupport/BuildTools/Emscripten/src/library*

추가 리소스