Interceptor MultiLang for Dart and Flutter Windows

Direct dart:ffi bindings for Windows x64. The native DLL is bundled; no Python, compiler, external executable or third-party Dart package is required at runtime.

dart pub add interceptor_multilang

For Flutter desktop use flutter pub add interceptor_multilang. These commands become available after pub.dev publication. Windows x64 and Dart 3.4+ are required.

import 'package:interceptor_multilang/interceptor_multilang.dart';

Future<void> main() async {
  final io = await Interceptor.open();
  try { print(io.info()); } finally { io.close(); }
}

The DLL is resolved from this package's lib/native directory. A standalone compiled app may pass an explicit libraryPath to its deployed DLL. Separately install the combined Interceptor 1.4.22.0 driver for capture and run the capture process as administrator. Package installation never installs a driver.

Capture and Flutter isolates

Native calls, including receive, are synchronous. Create the SDK client and run the capture loop in a worker isolate, rather than on Flutter's UI isolate. Use a finite receive timeout so the worker can process control messages between batches. Only one SDK context may be open per process. Always close it in finally.

final batch = io.receive(timeout: 1000);
for (final input in batch.events) {
  if (input.kind == 'mouse') input.field('y').value *= -1;
}
io.send(batch);

Always send the complete batch or explicitly block/discard events. Batches retain their owner/ticket and become invalid after the next receive, including a failed receive. Repeating a partial send forwards only its unaccepted remainder. Errors expose code, message and accepted. Repeated HID fields stay separate with collection/usage metadata; ambiguous name lookups are rejected. Unsigned sequence, timestamp and large info counters use BigInt to preserve 64 bits. Signed state values use int. Binary/report values use Uint8List; do not resize a received binary field.

API: initialize, info, devices, receive, send, discard, cancel, descriptor(token, report: true), inject('mouse', {'x': 200}), close. Full event and descriptor guide, an example and MIT LICENSE are bundled. Driver demo restrictions and licensing remain separate.

Libraries

interceptor_multilang
Direct Windows x64 FFI bindings. Capture calls are synchronous: use a worker isolate for a Flutter UI. Installing this package does not install a driver.