createCameraContext
Bắt đầu hỗ trợ ở phiên bản:
- SDK: 2.39.0
Lưu ý
Cần xin cấp quyền tại trang Quản lý ứng dụng
Nhằm đơn giản hóa cách truy cập và sử dụng camera/micro trên nền tảng MiniApp, SDK cung cấp class ZMACamera với các chức năng như thay đổi động thông số streaming, tắt/bật camera/micro, chuyển camera, chụp ảnh với cấu hình tùy chọn, và lắng nghe các sự kiện liên quan đến camera (vd: frame realtime callback khi streaming camera).
Lưu ý:
- Các hàm thay đổi trạng thái streaming (start, pause, resume, updateMediaConstraints, setDeviceId, flip) sẽ trả về một Promise, bạn cần sử dụng await hoặc .then() để đảm bảo không xung đột trạng thái dẫn đến các chức năng hoạt động không như mong đợi.
- Sau khi sử dụng xong, bạn nên gọi hàm stop để giải phóng camera/micro. Vì lý do privacy của user khi app xuống background sẽ stop streaming, nếu app muốn tiếp tục streaming khi quay lại foreground thì cần gọi lại hàm start.
Parameters
Object object
| Property | Type | Default | Required | Description | Minimum Version |
|---|---|---|---|---|---|
| videoElement | HTMLVideoElement | true | thẻ video chính để render stream từ camera | ||
| mediaConstraints | MediaConstraints |
| Cấu hình khởi tạo streaming. Mặc định chỉ lấy stream từ camera, |
MediaConstraints object
| Property | Type | Default | Required | Description | Minimum Version |
|---|---|---|---|---|---|
| width | number | Chiều rộng của video | |||
| height | number | Chiều cao của video | |||
| facingMode | FacingMode | Hướng camera | |||
| deviceId | string | deviceId camera cần sử dụng. DeviceId lấy từ getCameraList | |||
| video | boolean | Bật/tắt stream camera | |||
| audio | boolean | Bật/tắt stream micro | |||
| mirrored | boolean | Chế độ gương, lật ngược ảnh |
FacingMode enum
- FRONT: Camera trước
- BACK: Camera sau
Return Values
<ZMACamera object>
| Property | Type | Description | Minimum Version |
|---|---|---|---|
| start | function | Bắt đầu streaming từ camera | |
| stop | function | Kết thúc streaming từ camera | |
| pause | function | Tạm dừng streaming | |
| resume | function | Tiếp tục lại streaming | |
| isUsing | function | Kiểm tra trạng thái streaming | |
| updateMediaConstraints | function | Update cấu hình streaming | |
| takePhoto | function | Chụp ảnh từ camera | |
| flip | function | Chuyển camera trước/sau | |
| setMirror | function | Bật/tắt chế độ gương cho ảnh. | |
| getCameraList | function | Lấy danh sách camera đang active trên điện thoại | |
| getSelectedDeviceId | function | Lấy deviceId của camera đang active | |
| setDeviceId | function | Chuyển camera active bằng deviceId | |
| on | function | Lắng nghe các sự kiện CameraEvents | |
| off | function | Ngừng lắng nghe sự kiện CameraEvents |
Sample Code
Code demo fallback when rendering server side!