puerts 是游戲引擎下的 TypeScript 編程解決方案

• 提供了一個 JavaScript 運行時

• 提供通過 TypeScript 訪問宿主引擎的能力（JavaScript 層面的綁定以及 TypeScript 聲明生成）

特性

• JavaScript 生態有眾多的庫和工具鏈，結合專業商業引擎的渲染能力，快速打造游戲

• 相比游戲領域常用的 lua 腳本，TypeScript 的靜態類型檢查有助于編寫更健壯，可維護性更好的程序

• 高效：全引擎，全平臺支持反射 Binding，無需額外（生成代碼）步驟即可開發

• 高性能：全引擎，全平臺支持靜態 Binding，兼顧了高性能的場景

安裝

• git clone?https://github.com/Tencent/puerts.git

• 拷貝插件到您項目

  • unreal engine

    • 拷貝puerts/unreal下的Puerts目錄到您項目的Plugins目錄下，可以參考unreal demo

  • unity

    • 拷貝puerts/unity/Assets下的所有內容到您項目的Assets目錄下，可以參考unity demo

    • Plugins要單獨下載releases，或者自行編譯

編程樣例

Unity

import {UnityEngine} from 'csharp'

UnityEngine.Debug.Log('hello world');
let gameObject = new UnityEngine.GameObject("testobject");
console.log(gameObject.name);
gameObject.transform.position = new UnityEngine.Vector3(1, 2, 3);

Unreal

import * as UE from 'ue'
import {argv} from 'puerts';
let world = argv.getByName("World") as UE.World;
let actor = world.SpawnActor(UE.MainActor.StaticClass(),
    undefined, UE.ESpawnActorCollisionHandlingMethod.Undefined, undefined, undefined) as UE.MainActor;
console.log(actor.GetName());
console.log(actor.K2_GetActorLocation().ToString());

調試

• unreal
• unity

常見問題

• general faq
• unreal faq
• unity faq

使用文檔

• unreal手冊
• unity手冊
• unreal下腳本和引擎交互
• 純c++api的支持

支持的引擎，平臺

引擎

• unreal engine 4.22 ~ 最新版本

• unity 5 ~ 最新版本

平臺

• iOS，Android，Windows，Macos

• 任意.net環境

詳細信息

• unreal
• unity

示例

Unreal自動綁定模式

• FPS demo?： 以一個FPS游戲例子演示如何使用Puerts的自動綁定模式

Unreal自創建虛擬機模式

• QuickStart.ts?： 演示TypeScript和UE4引擎互相調用

• NewContainer.ts?： 演示容器的創建

• AsyncTest.ts?： 將異步加載藍圖，Delay封裝成async/await

• UsingWidget.ts?： UI加載，綁定事件，獲取數據的演示

Unity

• 01_JsCallCs?： js調用c#

• 02_Require?： 加載js文件

• 03_Callback?： 回調基本演示

• 04_JsBehaviour?： 用js模擬MonoBehaviour

• 05_Typescript?： 包含了大部分TypeScript和C#互相調用的演示

• 06_UIEvent?：UI事件的演示

?