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

• 提供了一個(gè) JavaScript 運(yùn)行時(shí)

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

特性

• JavaScript 生態(tài)有眾多的庫(kù)和工具鏈，結(jié)合專業(yè)商業(yè)引擎的渲染能力，快速打造游戲

• 相比游戲領(lǐng)域常用的 lua 腳本，TypeScript 的靜態(tài)類型檢查有助于編寫更健壯，可維護(hù)性更好的程序

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

• 高性能：全引擎，全平臺(tái)支持靜態(tài) Binding，兼顧了高性能的場(chǎng)景

安裝

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

• 拷貝插件到您項(xiàng)目

  • unreal engine

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

  • unity

    • 拷貝puerts/unity/Assets下的所有內(nèi)容到您項(xiàng)目的Assets目錄下，可以參考unity demo

    • Plugins要單獨(dú)下載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());

調(diào)試

• unreal
• unity

常見問題

• general faq
• unreal faq
• unity faq

使用文檔

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

支持的引擎，平臺(tái)

引擎

• unreal engine 4.22 ~ 最新版本

• unity 5 ~ 最新版本

平臺(tái)

• iOS，Android，Windows，Macos

• 任意.net環(huán)境

詳細(xì)信息

• unreal
• unity

示例

Unreal自動(dòng)綁定模式

• FPS demo?： 以一個(gè)FPS游戲例子演示如何使用Puerts的自動(dòng)綁定模式

Unreal自創(chuàng)建虛擬機(jī)模式

• QuickStart.ts?： 演示TypeScript和UE4引擎互相調(diào)用

• NewContainer.ts?： 演示容器的創(chuàng)建

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

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

Unity

• 01_JsCallCs?： js調(diào)用c#

• 02_Require?： 加載js文件

• 03_Callback?： 回調(diào)基本演示

• 04_JsBehaviour?： 用js模擬MonoBehaviour

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

• 06_UIEvent?：UI事件的演示

?