Ứng dụng
Fomoxa phù hợp ở bất cứ đâu hai chương trình, thường viết bằng hai ngôn ngữ, phải thống nhất dữ liệu đến từng byte. Dưới đây là bốn nơi như vậy, kèm những gì chạy tốt và những điều cần biết trước khi bắt đầu.
01 · Game
Server bằng Rust hoặc C#, client Unity bằng C#, client Unreal bằng C++. Một schema, và mọi engine đọc ghi cùng một chuỗi byte.
com.fomoxa.networking nhận Vector3, Quaternion, Color và các kiểu khác của Unity làm kiểu field, và tự sinh codec cho chúng.// Unity · model có kiểu của Unity, cho com.fomoxa.networking
[Network]
[Codec("game")]
public class PlayerState
{
[Network("u32")] [Codec("game")] public uint Id { get; set; }
[Network("Vector3")] [Codec("game")] public Vector3 Position { get; set; }
[Network("Quaternion")] [Codec("game")] public Quaternion Rotation { get; set; }
[Network("u8")] [Codec("game")] public byte Health { get; set; }
}
So với các format khác: Protobuf và FlatBuffers cho phép nhiều encoding hợp lệ cho cùng một snapshot, còn canonical form của Cap'n Proto là tuỳ chọn. Với chúng, hai engine muốn so sánh snapshot phải cùng chạy một bước canonical hoá. Với Fomoxa, bước đó chính là format.
Đã chạy thật: fomoxa-example-game đưa client Unity, Unreal và Go vào cùng một trận với server Rust. Server một luồng giữ vững 30 Hz với 1000 bot, mỗi bot nhận trạng thái của 999 bot khác, và phần encode chỉ tốn 0.02 ms trong tick 33.3 ms.
02 · Service
Các service viết bằng Go, Rust, C# và Node.js trao đổi message mà chính các byte mang ý nghĩa: được ký, hash, cache hoặc so sánh.
fomoxac ci so schema với nhánh đích và làm build thất bại khi có breaking change..fomoxa/schema.json và dùng fomoxa-inspect.// Go ký, Rust kiểm tra: cả hai encode lại cùng một Order và ra cùng byte go payload := encode(order) // 2A 00 00 00 ... sig := ed25519.Sign(key, payload) rust let payload = encode(&order); // 2A 00 00 00 ... giống hệt verifying_key.verify(&payload, &sig)?;
So với các format khác: tài liệu Protobuf nói serialization của nó không canonical, nên bên kiểm tra phải dùng đúng các byte đã nhận chứ không encode lại. Với Fomoxa, bên nào cũng dựng lại được payload từ giá trị và ra đúng các byte đã được ký.
03 · Nhúng
Vi điều khiển và gateway nói chuyện với server và công cụ viết bằng ngôn ngữ khác. Specification được viết sao cho một encoder bằng assembly trên MCU 8-bit cũng làm theo được.
static inline header-only, không dependency.-fno-exceptions.string, bytes và array trong code C sinh ra có gọi malloc. Trên target không có heap, hãy để những field đó ngoài model./* Một frame telemetry kích thước cố định: luôn 4 + 4 + 2 + 1 = 11 byte */
FOMOXA_MODEL
FOMOXA_CODEC("uplink")
struct Telemetry
{
FOMOXA_FIELD(u32) FOMOXA_CODEC("uplink") uint32_t sequence;
FOMOXA_FIELD(f32) FOMOXA_CODEC("uplink") float temperature;
FOMOXA_FIELD(u16) FOMOXA_CODEC("uplink") uint16_t millivolts;
FOMOXA_FIELD(u8) FOMOXA_CODEC("uplink") uint8_t status;
};
So với các format khác: với varint, kích thước message phụ thuộc giá trị, nên các thư viện Protobuf cho hệ nhúng phải cấp buffer theo trường hợp xấu nhất. Một model Fomoxa chỉ gồm field độ rộng cố định có đúng một kích thước, bất kể giá trị.
04 · Công cụ
Bộ ghi replay, binary log, pipeline cho level và asset, plugin editor: các công cụ viết bằng một ngôn ngữ đọc dữ liệu do ngôn ngữ khác tạo ra.
.fomoxa/schema.json mô tả mọi model độc lập với ngôn ngữ, công cụ đọc được ngay.fomoxa-inspect và byte inspector decode bất kỳ payload nào theo một schema.# decode một frame trong file replay theo schema đã ghi ra nó fomoxa-inspect --schema replays/v3/schema.json --message WorldSnapshot.game --file frame-0042.bin # kiểm tra thay đổi schema so với schema lúc ghi các bản replay fomoxac compat --base replays/v3/schema.json
So với các format khác: đánh địa chỉ bản ghi theo nội dung bằng một binary format khác vẫn làm được, miễn là mọi bên ghi đều đồng ý canonical hoá trước, như canonical form của Cap'n Proto cho phép. Fomoxa không có dạng thứ hai, nên bên ghi nào tuân thủ cũng ra cùng một file.
Chưa chắc Fomoxa có hợp không? Xem so sánh với Protobuf, FlatBuffers, Cap'n Proto, Borsh, BCS, JSON và MessagePack.