uvc 1.2.0 uvc: ^1.2.0 copied to clipboard
A Dart package for controlling UVC compliant webcams on macOS and Windows.
A Dart package for controlling UVC compliant webcams.
You can find more information about UVC USB devices here on Wikipedia.
Platform Support #
Android | iOS | MacOS | Web | Linux | Windows |
---|---|---|---|---|---|
❌ | ❌ | ✅ | ❌ | ❌ | ✅ |
Example #
import 'package:uvc/uvc.dart';
void main() {
final uvc = UvcLib(); // Load the libusb library
final camera = UVCControl(vendorId: 0x1532, productId: 0x0E05);
final value = camera.zoom.min;
camera.zoom.current = value == null ? 225 : value + 1;
camera.close();
uvc.dispose();
}
Usage #
First, add uvc
as a dependency in your pubspec.yaml file. Then run dart pub get
or flutter pub get
.
Next, you need to instantiate the UvcLib
class which will open and setup the libusb
library for use in the app.
final uvc = UvcLib();
To open a camera and start controlling it, you must use UVCControl
. Include the
vendor ID and product ID of the camera to control.
final camera = UVCControl(vendorId: 0x1532, productId: 0x0E05);
To find a list of cameras with their IDs, you can use:
final uvcDevices = uvc.getDevices(onlyUvcDevices: true);
final device = uvcDevices.first;
final vendorId = device.deviceDescriptor.vendorId;
final productId = device.deviceDescriptor.productId;
To get the zoom current value:
final value = camera.zoom.current;
To set the zoom current value:
camera.zoom.current = 225;
Close the camera when you are done.
camera.close();
It is always a good idea to unload the library when you are done using it.
uvc.dispose();
To get the range of valid values for zoom:
final min = camera.zoom.min;
final max = camera.zoom.max;
To use the pan or tilt values, just use the same code as zoom, but substitute the name pan and tilt for zoom:
camera.pan.current;
camera.pan.min;
camera.tilt.current;
camera.tilt.min;
Controls #
Pan #
camera.pan.current;
Tilt #
camera.tilt.current;
Zoom #
final camera = UVCControl(vendorId: 0x1532, productId: 0x0E05);
camera.zoom.current;
camera.zoom.defaultValue;
camera.zoom.max;
camera.zoom.min;
camera.zoom.resolution;
Backlight Compensation #
camera.backlightCompensation.current;
Brightness #
camera.brightness.current;
Contrast #
camera.contrast.current;
Saturation #
camera.contrast.saturation;
Sharpness #
camera.contrast.sharpness;
White Balance #
camera.contrast.whitebalance;
Focus #
camera.zoom.current;
Focus (auto) #
camera.focusAuto.current;
Powerline Frequency #
camera.powerlineFrequency.current;
Debugging #
You can enable logging in UvcLib
for troubleshooting. Just pass true
to debugLogging
when creating UvcLib
.
final uvc = UvcLib(debugLogging: true);
You can also enable libusb
logging in UvcLib
for troubleshooting. Just pass true
to debugLoggingLibUsb
when creating UvcLib
.
final uvc = UvcLib(debugLoggingLibUsb: true);
libusb #
This uvc
package utilizes the libusb library
via Dart FFI and it is
included as a dependency with the libusb Dart package.
Contributing #
All comments and pull requests are welcome.
Donations / Sponsor #
Please sponsor or donate to the creator of uvc
on Patreon.