From a8e60ff3c4135dc53fae83809bb055edf6b6fbbc Mon Sep 17 00:00:00 2001 From: BlueRose <378100977@qq.com> Date: Tue, 4 Jun 2024 12:14:05 +0800 Subject: [PATCH] vault backup: 2024-06-04 12:14:05 --- .../PuerTS/Puerts（一）——学习资料归纳.md | 219 +++++++++++++++++- 1 file changed, 218 insertions(+), 1 deletion(-) diff --git a/03-UnrealEngine/Gameplay/PuerTS/Puerts（一）——学习资料归纳.md b/03-UnrealEngine/Gameplay/PuerTS/Puerts（一）——学习资料归纳.md index d680535..d1859a5 100644 --- a/03-UnrealEngine/Gameplay/PuerTS/Puerts（一）——学习资料归纳.md +++ b/03-UnrealEngine/Gameplay/PuerTS/Puerts（一）——学习资料归纳.md @@ -254,4 +254,221 @@ console.log(actor.K2_GetActorLocation().ToString()); ``` ## UE C++访问Puerts -通过UDynamicDelegateProxy，其成员记录了绑定的虚拟机与JS函数。 \ No newline at end of file +通过UDynamicDelegateProxy，其成员记录了绑定的虚拟机与JS函数。 + +# QuickStart.ts +```ts +import * as UE from 'ue' +import {$ref, $unref, $set, argv, on, toManualReleaseDelegate, releaseManualReleaseDelegate, blueprint} from 'puerts'; + +let obj = new UE.MainObject(); + +//调试器通过websocket发送断点信息，可能断点生效前脚本已经执行完备，可以通过debugger语句来主动触发断点 +//debugger; + +//成员访问 +console.log("------------------------0----------------------------"); +console.log("before set", obj.MyString) +obj.MyString = "PPPPP"; +console.log("after set", obj.MyString) + +//简单类型参数函数 +console.log("------------------------1----------------------------"); +let sum = obj.Add(100, 300); +console.log('sum', sum) + +//复杂类型参数函数 +console.log("------------------------2----------------------------"); +obj.Bar(new UE.Vector(1, 2, 3)); + +//引用类型参数函数 +console.log("------------------------3----------------------------"); +let vectorRef = $ref(new UE.Vector(1, 2, 3)) +obj.Bar2(vectorRef); +obj.Bar($unref(vectorRef)); + +//静态方法 +console.log("-----------------------4-----------------------------"); +let str1 = UE.JSBlueprintFunctionLibrary.GetName(); +let str2 = UE.JSBlueprintFunctionLibrary.Concat(', ', str1); +UE.JSBlueprintFunctionLibrary.Hello(str2); + +//扩展方法，和C#的扩展方法类似 +console.log("-----------------------5-----------------------------"); +let v = new UE.Vector(3, 2, 1) +console.log(v.ToString()); +v.Set(8, 88, 888) +console.log(v.ToString()); + +//静态wrap +console.log("-----------------------6-----------------------------"); +let vec = new UE.Vector(1, 2, 3) +console.log('vec', vec.ToString()) +vec.X = 3 +vec.Y = 2 +vec.Z = 1 +vec.Normalize(1) +console.log('vec', vec.ToString()) +console.log(vec.Projection().ToString()) +console.log('vec', vec.ToString()) + +//枚举 +console.log("-----------------------7-----------------------------"); +obj.EnumTest(UE.EToTest.V1); +obj.EnumTest(UE.EToTest.V13); + +//默认值 +console.log("-----------------------8-----------------------------"); +obj.DefaultTest(); +obj.DefaultTest("hello john"); +obj.DefaultTest("hello john", 1024); +obj.DefaultTest("hello john", 1024, new UE.Vector(7, 8, 9)); + +//定长数组 +console.log("-----------------------9-----------------------------"); +console.log("MyFixSizeArray.Num()", obj.MyFixSizeArray.Num()) +console.log("MyFixSizeArray[32]", obj.MyFixSizeArray.Get(32)) +console.log("MyFixSizeArray[33]", obj.MyFixSizeArray.Get(33)) +console.log("MyFixSizeArray[34]", obj.MyFixSizeArray.Get(34)) +obj.MyFixSizeArray.Set(33, 1000) +console.log("MyFixSizeArray[32]", obj.MyFixSizeArray.Get(32)) +console.log("MyFixSizeArray[33]", obj.MyFixSizeArray.Get(33)) +console.log("MyFixSizeArray[34]", obj.MyFixSizeArray.Get(34)) + +//TArray +console.log("------------------------10----------------------------"); +function printTArray(arr: UE.TArray) +{ + console.log("-----Num:", arr.Num()); + for(var i=0; i < arr.Num(); i++) { + console.log(i, ":", arr.Get(i)); + } +} +printTArray(obj.MyArray); +obj.MyArray.Add(888); +obj.MyArray.Set(0, 7); +printTArray(obj.MyArray); + +//TSet +console.log("------------------------11----------------------------"); +console.log(obj.MySet.Num()) +console.log(obj.MySet.Contains("John")); +console.log(obj.MySet.Contains("Che")); +console.log(obj.MySet.Contains("Hello")); + +//TMap +console.log("------------------------12----------------------------"); +console.log(obj.MyMap.Get("John")) +console.log(obj.MyMap.Get("Che")) +console.log(obj.MyMap.Get("Hello")) +obj.MyMap.Add("Che", 10) +console.log(obj.MyMap.Get("Che")) + +//ArrayBuffer +console.log("-------------------------13---------------------------"); +let ab = obj.ArrayBuffer; +let u8a1 = new Uint8Array(ab); +for (var i = 0; i < u8a1.length; i++) { + console.log(i, u8a1[i]); +} +obj.ArrayBufferTest(ab); +obj.ArrayBufferTest(new Uint8Array(ab)); +let ab2 = obj.ArrayBufferTest(new Uint8Array(ab, 5)); +let u8a2 = new Uint8Array(ab2); +console.log(u8a2.length); +for (var i = 0; i < u8a2.length; i++) { + console.log(i, u8a2[i]); +} + +//引擎方法 +console.log("--------------------------14--------------------------"); +//在FJsEnv启动，调用Start时传入的参数可以通过argv获取。如果是继承ue类方式，这里的argv是空的 +let gameInstance = (argv.getByName("GameInstance") as UE.GameInstance); +let actor = UE.GameplayStatics.BeginDeferredActorSpawnFromClass(gameInstance, UE.MainActor.StaticClass(), undefined) as UE.MainActor; +UE.GameplayStatics.FinishSpawningActor(actor, undefined); +console.log(actor.GetName()); +console.log(actor.K2_GetActorLocation().ToString()); + +//蓝图加载 +//UE.Class.Load方式 +//let bpClass = UE.Class.Load('/Game/StarterContent/TestBlueprint.TestBlueprint_C') +//let bpActor = UE.GameplayStatics.BeginDeferredActorSpawnFromClass(gameInstance, bpClass, undefined) as UE.Game.StarterContent.TestBlueprint.TestBlueprint_C; +blueprint.load(UE.Game.StarterContent.TestBlueprint.TestBlueprint_C); +const TestBlueprint_C = UE.Game.StarterContent.TestBlueprint.TestBlueprint_C; //别名 +let bpActor = UE.GameplayStatics.BeginDeferredActorSpawnFromClass(gameInstance, TestBlueprint_C.StaticClass(), undefined) as UE.Game.StarterContent.TestBlueprint.TestBlueprint_C; +UE.GameplayStatics.FinishSpawningActor(bpActor, undefined); +bpActor.Foo(false, 8000, 9000); +//如果确定后续不需要使用TestBlueprint_C了，应该unload节省内存 +blueprint.unload(TestBlueprint_C); + +//蓝图结构体加载 +//UE.UserDefinedStruct.Load方式 +//let TestStruct = UE.UserDefinedStruct.Load("UserDefinedStruct'/Game/StarterContent/TestStruct.TestStruct'"); +//let testStruct = UE.NewStruct(TestStruct) as UE.Game.StarterContent.TestStruct.TestStruct; +blueprint.load(UE.Game.StarterContent.TestStruct.TestStruct); +const TestStruct = UE.Game.StarterContent.TestStruct.TestStruct; +let testStruct = new TestStruct(); +testStruct.age = 10; +testStruct.speed = 5; +bpActor.Bar(testStruct); +blueprint.unload(TestStruct); + +//蓝图枚举 +console.log("-------------------------15---------------------------"); +console.log(UE.Game.StarterContent.TestEnum.TestEnum.Blue); +console.log(UE.Game.StarterContent.TestEnum.TestEnum.Red); +console.log(UE.Game.StarterContent.TestEnum.TestEnum.Green); + +//Delegate +console.log("--------------------------16--------------------------"); +function MutiCast1(i) { + console.warn("MutiCast1<<<", i); +} + +function MutiCast2(i) { + console.warn("MutiCast2>>>", i); + actor.NotifyWithInt.Remove(MutiCast2);//调用一次后就停掉 +} + +actor.NotifyWithInt.Add(MutiCast1) +actor.NotifyWithInt.Add(MutiCast2) + +console.log("NotifyWithString.IsBound", actor.NotifyWithString.IsBound()); +console.log("NotifyWithRefString.IsBound", actor.NotifyWithRefString.IsBound()); +actor.NotifyWithRefString.Bind((strRef) => { + //console.error("NotifyWithRefString"); + console.log("NotifyWithRefString", $unref(strRef)); + $set(strRef, "out to NotifyWithRefString");//引用参数输出 +}); +console.log("NotifyWithString.IsBound", actor.NotifyWithString.IsBound()); +console.log("NotifyWithRefString.IsBound", actor.NotifyWithRefString.IsBound()); + +actor.NotifyWithStringRet.Bind((inStr) => { + return "////" + inStr; +}); + +actor.NotifyWithInt.Broadcast(888999); +let strRef = $ref("666"); +actor.NotifyWithRefString.Execute(strRef); +console.log("out str:" + $unref(strRef)); +let retStr = actor.NotifyWithStringRet.Execute("console.log('hello world')"); +console.log("ret str:" + retStr); +console.log("waiting native call script..........."); + +//Pass JsFunction as Delegate +function IsJohn(str:string) : boolean { + return str == "John"; +} +obj.PassJsFunctionAsDelegate(toManualReleaseDelegate(IsJohn)); +//release after using +releaseManualReleaseDelegate(IsJohn); + +//unhandledRejection +on('unhandledRejection', function(reason: any) { + console.log('unhandledRejection~~~'); +}); + +new Promise(()=>{ + throw new Error('unhandled rejection'); +}); +``` \ No newline at end of file