Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
React Native Godot은 React Native 환경에서 Godot 엔진을 통합할 수 있게 해주는 도구입니다. 이를 통해 개발자는 네이티브 성능과 GPU 가속 렌더링을 활용하여 몰입감 있는 3D 경험이나 인터랙티브 게임을 만들 수 있습니다. 모든 Godot 기능에 접근하며, 런타임 GDScript 컴파일 및 React Native와의 양방향 통신 기능을 제공합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub GameDev의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Godot을 React Native 🔮으로 가져오세요. React Native 내에서 몰입감 있는 3D 경험이나 인터랙티브 게임을 직접 만드세요.
npm version
godot engine
Expo SDK
<img src="https://raw.githubusercontent.com/calico-games/react-native-godot/HEAD/screenshots/screenshot1.jpeg" alt="Multiple Cubes demo" align="center" width="150" hspace="2" vspace="10">
<img src="https://raw.githubusercontent.com/calico-games/react-native-godot/HEAD/screenshots/screenshot2.jpeg" alt="Earth demo" align="center" width="150" hspace="2" vspace="10">
iOS 지원은 구현되었으며, 전체 Android 지원은 곧 제공될 예정입니다.
| Platform | Supported |
|---|---|
| iOS Device | ✅ |
| ... |
npm install react-native-godot
# 또는
yarn add react-native-godot
GodotProvider로 앱을 감싸서 Godot를 올바르게 초기화합니다:
// App.tsx
import React from 'react';
import { GodotProvider } from 'react-native-godot';
...
// MyGameScreen.tsx
import React, { useEffect, useState } from 'react';
import { GodotView, useGodot, useGodotRef } from 'react-native-godot';
...
React Native에서 Godot 씬을 임베딩하기 위한 주요 컴포넌트입니다. 여러 개의 GodotView 컴포넌트를 같은 화면에 사용할 수 있으며, 각각은 다른 씬을 렌더링하지만 동일한 Godot 엔진 인스턴스를 공유합니다.
| Prop | Type | Description |
|---|---|---|
source | `string | ImageSourcePropType` |
| ... |
| Method | 설명 |
|---|---|
getRoot(): Node | 로드된 씬의 루트 노드를 가져옵니다. |
| ... |
| Method | 설명 |
|---|---|
GodotView.startDrawing(): void | Godot 렌더링 엔진을 시작합니다 (앱당 한 번 호출). |
GodotView.stopDrawing(): void | Godot 렌더링 엔진을 중지합니다. |
단일 GodotView 예제:
const MyGame = () => {
const godotRef = useGodotRef();
...
다중 GodotView 예제:
const MultiSceneApp = () => {
const gameRef = useGodotRef();
const uiRef = useGodotRef();
...
💡 참고 사항 (Note): 모든 GodotView 인스턴스는 동일한 Godot 엔진을 공유하므로, 여러 뷰를 가지고 있더라도 앱당 한 번만 GodotView.startDrawing()을 호출하면 됩니다. 어떤 씬이 활발하게 렌더링되고 있는지 제어하려면 개별 뷰 인스턴스에 대해 pause()와 resume()을 사용하세요.
예제: 개별 씬 제어:
// 필요하지 않을 때 미니맵 일시 정지 (Pause)
minimapRef.current?.pause();
...
모든 Godot 변형 타입은 전체 메서드 및 속성 지원과 함께 사용 가능합니다:
사용 가능한 타입:
AABB | Basis | Color | Plane | Projection | Quaternion | Rect2 | Rect2i | Transform2D | Transform3D | Vector2 | Vector2i | Vector3 | Vector3i | Vector4 | Vector4i
사용법 (Usage):
const { Vector3, Color, Transform3D } = useGodot();
// 변형 타입 생성
...
완벽한 문서: Godot 변형 타입
GDScript를 런타임에 생성하고 컴파일한 다음, 동적으로 생성된 노드에 연결합니다:
const { Script, Node } = useGodot();
// 스크립트 생성 및 컴파일
...
| Method | 설명 |
|---|---|
Script() | 새로운 빈 스크립트를 생성합니다. |
setSourceCode(source: string): boolean | GDScript 소스 코드를 설정하고 컴파일합니다. |
| Method | Description |
|---|---|
Node() | 새 빈 노드 생성 |
| ... | |
💡 팁: 더 나은 TypeScript 사용성을 위해, node.call("methodName", args) 대신 (node as any).methodName(args)를 사용하여 스크립트 메서드를 직접 호출할 수 있습니다. |
로드된 Godot 장면의 노드에 접근하고 상호 작용합니다:
effect(() => {
if (!isGodotReady || !godotRef.current) return;
...
React Native에서 Godot 스크립트로 메시지 전송:
// 구조화된 데이터를 Godot으로 전송
godotRef.current?.emitMessage({
type: 'player_action',
...
Godot 스크립트에서 React Native로 메시지 수신:
<GodotView
onMessage={(instance, message) => {
console.log('Received from Godot:', message);
...
extends Node
@onready var rn_singleton = Engine.get_singleton("ReactNative")
...
기존 Godot 프로젝트를 React Native에서 사용하려면:
Godot 프로젝트 디렉터리에 export_presets.cfg 파일을 생성합니다:
[preset.0]
name="main"
...
제공된 스크립트를 실행합니다 (OS에 맞게 경로 수정):
./gen-pck PROJECT_FOLDER_PATH
생성된 .pck 파일을 React Native의 assets 폴더로 이동합니다.
project.godot 파일을 Xcode 프로젝트 번들에 추가합니다.
metro.config.js에 PCK 파일 지원을 추가합니다:
const config = getDefaultConfig(__dirname);
// pck 파일을 에셋으로 추가
...
텍스처나 3D 모델을 가져올 때, VRAM Compressed 형식을 사용하지 않도록 주의하세요. 이 형식은 PCK 파일에 제대로 내보내지지 않을 수 있습니다.
현재 런타임에 PCK 에셋을 교체할 수 없습니다. 새로운 PCK 파일을 로드하려면 앱을 다시 시작해야 합니다. 이는 저희가 조사 중인 Godot 엔진의 제한 사항으로 보입니다.
여러분의 기여를 환영합니다! 핵심 개발은 비공개 저장소에서 이루어지지만, 기여하고 싶으시다면 다음을 따라주세요:
[email protected]로 문의해 주세요.MIT 라이선스입니다. 자세한 내용은 LICENSE를 참조하세요.