[feat] integrate CrossDesk CLI with terminal rendering and npm packaging

2026-11-02 12:02:42 +08:00 · 2026-10-30 10:42:23 +08:00
parent 2f57d0aba3
commit 699d867956
34 changed files with 3811 additions and 18 deletions
@@ -0,0 +1,120 @@
+/*
+ * @Author: DI JUNKUN
+ * @Date: 2026-10-30
+ * Copyright (c) 2026 by DI JUNKUN, All Rights Reserved.
+ */
+
+#ifndef _CONTROLLER_SESSION_H_
+#define _CONTROLLER_SESSION_H_
+
+#include <chrono>
+#include <deque>
+#include <minirtc.h>
+#include <mutex>
+#include <nlohmann/json.hpp>
+#include <optional>
+#include <remote_action.h>
+#include <set>
+#include <string>
+#include <vector>
+
+namespace crossdesk {
+struct DecodedFrame {
+  unsigned width = 0, height = 0;
+  uint64_t generation = 0, frame_id = 0;
+  std::chrono::steady_clock::time_point queued;
+  std::vector<uint8_t> nv12;
+};
+// One replaceable pending picture; Take transfers ownership to the consumer.
+// Callback memory is copied synchronously. Native descriptors never escape.
+class LatestFrame {
+public:
+  bool Submit(const MiniRtcVideoFrame &, uint64_t generation);
+  // Recycle the caller's old buffer only when a new frame is available.
+  std::optional<DecodedFrame> Take(DecodedFrame *recycle = nullptr);
+  void Reset(uint64_t generation);
+  nlohmann::json Stats() const;
+
+private:
+  mutable std::mutex mutex_;
+  std::optional<DecodedFrame> pending_;
+  std::vector<uint8_t> spare_;
+  uint64_t generation_ = 0, received_ = 0, dropped_ = 0, invalid_ = 0;
+};
+struct SessionOptions {
+  std::string host = "api.crossdesk.cn", log_directory;
+  int port = 9099, display = 0, fps = 8;
+  int preview_width = 1920, preview_height = 1080;
+  int quality = 2, max_bitrate_bps = 6000000;
+  std::chrono::seconds timeout{30};
+};
+// All public methods except the destructor run on one owner thread. Call Tick
+// regularly. Library callbacks only enqueue bounded events or copy one frame.
+class ControllerSession {
+public:
+  ControllerSession() = default;
+  ~ControllerSession();
+  void Connect(SessionOptions options, std::string device,
+               std::string password);
+  void Tick();
+  void Disconnect();
+  bool SelectDisplay(int index);
+  void SetPreview(int fps, int width, int height, int quality = -1,
+                  int max_bitrate_bps = -1);
+  void SetControl(bool enabled);
+  bool Text(const std::string &utf8);
+  bool Key(int key, bool down);
+  bool Pointer(float x, float y, int flag, int wheel = 0);
+  std::optional<DecodedFrame> TakeFrame(DecodedFrame *recycle = nullptr);
+  nlohmann::json Status() const;
+  bool Connected() const { return state_ == "connected"; }
+  bool Finished() const { return state_ == "failed" || state_ == "closed"; }
+  uint64_t Generation() const { return generation_; }
+
+private:
+  struct Event {
+    int kind, code;
+    std::string data;
+  };
+  void Enqueue(Event event) noexcept;
+  void Fail(const char *reason);
+  void ClosePeers();
+  Params Parameters();
+  bool Send(const char *stream, const std::string &payload);
+  void Preview();
+  void ReleaseInput();
+  static void Signal(SignalStatus, const char *, size_t, void *);
+  static void Connection(ConnectionStatus, const char *, size_t, void *);
+  static void Data(const char *, size_t, const char *, size_t, const char *,
+                   size_t, void *);
+  static void Video(const MiniRtcVideoFrame *, const char *, size_t,
+                    const char *, size_t, void *);
+  static void Network(const char *, size_t, TraversalMode,
+                      const MiniRtcNetTrafficStats *, const char *, size_t,
+                      void *);
+  SessionOptions options_;
+  PeerPtr *peer_ = nullptr;
+  std::string state_ = "idle", error_, device_, password_, client_id_;
+  uint64_t generation_ = 0;
+  uint32_t preview_request_ = 0, preview_ack_ = 0;
+  bool control_ = false, preview_supported_ = false, resolution_ = false;
+  bool fps15_ = false, bandwidth_ = false, text_supported_ = false;
+  bool preview_accepted_ = false;
+  std::vector<HostDisplay> displays_;
+  std::set<int> keys_, buttons_;
+  float pointer_x_ = .5f, pointer_y_ = .5f;
+  std::chrono::steady_clock::time_point deadline_;
+  mutable std::mutex mutex_;
+  std::deque<Event> events_;
+  bool stopping_ = true, overflow_ = false;
+  uint64_t callback_generation_ = 0;
+  int callback_display_ = 0;
+  MiniRtcNetTrafficStats network_{};
+  TraversalMode traversal_ = UnknownMode;
+  LatestFrame frames_;
+};
+nlohmann::json ParseBoundedJson(const std::string &text);
+std::string SafeText(const std::string &text, size_t limit = 160);
+} // namespace crossdesk
+
+#endif