roblox object event

@rbxts/object-event

แพ็คเกจ NPM สำหรับ Roblox-TS นี้ช่วยให้นักพัฒนาสามารถใช้กิจกรรมที่กำหนดเองสำหรับคลาสที่กำหนดเองโดยไม่ต้องหันไปใช้ BindableEvents

สิ่งนี้น่าจะเป็นประโยชน์อย่างยิ่งสำหรับโครงการที่พึ่งพากระบวนทัศน์ OOP สำหรับห้องสมุดและส่วนประกอบเกมอื่น ๆ อย่างมาก

โมดูลสามารถใช้ได้ทั้งในสคริปต์ Lua (U) บริสุทธิ์ (ผ่าน Rojo หรือวิธีอื่น ๆ ) หรือกับ Roblox-TS (รวมถึงการตรวจสอบประเภทเวลา)

ตัวอย่าง

 /////// Module.ts ///////

import ObjectEvent from "@rbxts/object-event"

const event = new ObjectEvent < [ number , String , Vector3 ] > ( )

event . Connect ( ( id , msg , position ) => {
    // We can safely assume that:
    // id is a number
    // msg is a string
    // position is a Vector3
} )

export event


/////// Waiter.server.ts ///////

import { event } from "./Module"

event . Fire ( 10 , "oof" , new Vector3 ( 1 , 2 , 3 ) )  // all good
event . Fire ( 10 , "oof" )                        // will not compile!

export { }

เพื่ออนุญาตให้มีการโต้แย้งทุกประเภทของหมายเลขใด ๆ :

 let event = new ObjectEvent < [ ... unknown ] > ( ) 

API ObjectEvent

• Connect(f) - f เป็นฟังก์ชั่นที่ใช้อาร์กิวเมนต์ที่พิมพ์ตามนั้นและส่งคืน void ส่งคืน ObjectEventConnection
• Wait() - ให้เธรดจนกว่าเหตุการณ์จะถูกไล่ออก ส่งคืนค่าที่พิมพ์ตามนั้น
• Fire(...) - ยิงเหตุการณ์ อาร์กิวเมนต์จะต้องเป็นตัวเลขและประเภทเดียวกัน
• Event - อินเทอร์เฟซ RBXScriptSignal ที่สนับสนุน Connect() และ Wait() ในกรณีที่คุณต้องการใช้เป็น blindableEvent
• SubscribedConnections - อาร์เรย์ของ ObjectEventConnection S กับการเชื่อมต่อทั้งหมดที่กำลังรับฟังเหตุการณ์

API ObjectEventConnection

• Disconnect() - ตัดการเชื่อมต่อจากเหตุการณ์
• Reconnect() - เปลี่ยนการตัดการเชื่อมต่อ
• IsConnected() - ส่งคืน true ถ้าการเชื่อมต่อกำลังฟังเหตุการณ์ (นี่คือไม่ใช่การตัดการเชื่อมต่อ () 'ed), false เป็นอย่างอื่น
• Event - ObjectEvent ที่เกี่ยวข้องกับการเชื่อมต่อนี้
• Listener - ฟังก์ชั่นที่เกี่ยวข้องกับการเชื่อมต่อนี้

คุณสมบัติปัจจุบัน:

• ชุดคุณสมบัติกิจกรรม roblox มาตรฐาน:
• • เชื่อมต่อกับเหตุการณ์
• • ตัดการเชื่อมต่อ;
• • ให้เกลียวจนกว่าเหตุการณ์จะถูกไล่ออก
• • ผ่านข้อโต้แย้งผ่านฟังก์ชั่น;
• คุณสมบัติที่กำหนดเอง:
• • เชื่อมต่อการเชื่อมต่อที่ตัดการเชื่อมต่ออีกครั้งโดยไม่ต้องสร้างใหม่ (ความสามารถในการใช้การเชื่อมต่อซ้ำ)
• • อ่านการเชื่อมต่อที่ใช้งานอยู่ทั้งหมดสำหรับเหตุการณ์ที่กำหนด

เป้าหมาย:

• นามธรรมจากภายใน;
• ไวยากรณ์คล้าย Roblox ในขณะที่รักษาความเหมาะสมขั้นต่ำสำหรับไวยากรณ์ typescript;
• ความสามารถในการอ่านรหัสสำหรับการใช้งาน OOP
• เติมเต็มการใช้งานของ Roblox ด้วยคุณสมบัติพิเศษ (มีประโยชน์)