@sapui5/sap.ndc 1.143.0 → 1.144.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sapui5/sap.ndc",
-  "version": "1.143.0",
+  "version": "1.144.0",
   "description": "SAPUI5 Library sap.ndc",
   "homepage": "https://ui5.github.io/cli/pages/SAPUI5/",
   "author": "SAP SE (https://www.sap.com)",

package/src/sap/ndc/.library

@@ -5,7 +5,7 @@
     <vendor>SAP SE</vendor>
     <copyright>SAPUI5
  * (c) Copyright 2025 SAP SE. All rights reserved.</copyright>
-    <version>1.143.0</version>
+    <version>1.144.0</version>
 
     <documentation>SAPUI5 library with controls with native device capabilities.</documentation>
 

package/src/sap/ndc/BarcodeScanner.js

@@ -116,7 +116,7 @@ sap.ui.define([
 					}
 				},
 				deviceId: undefined,
-				preferFrontCamera: false,
+				facingMode: undefined,
 				enableGS1Header: false
 			},
 			scanDialog: {
@@ -137,6 +137,7 @@ sap.ui.define([
 				customInput: null
 			},
 			devices: {
+				loaded: false,
 				mainCamera: undefined,
 				needCheck: true,
 				all: [],
@@ -208,10 +209,36 @@ sap.ui.define([
 			// TODO: following var is not used, right now it is useless // bInitialized = false,	// Flag indicating whether the feature vector (sap.Settings) is available
 									// sap.Settings might be loaded later, so it is checked again the next scan
 		}),
+		oResourceModel = new ResourceModel({
+			bundleName: "sap.ndc.messagebundle"
+		}),
 		oStatusModel = new JSONModel({
 			scannerAPI: "unknown",
 			available: false,
 			deviceId: undefined,
+			facingMode: undefined,
+			facingModes: [
+				{
+					"key": "",
+					"text": oResourceModel.getProperty("BARCODE_DEFAULT")
+				},
+				{
+					"key": "front",
+					"text": oResourceModel.getProperty("BARCODE_FACINGMODE_FRONT")
+				},
+				{
+					"key": "back",
+					"text": oResourceModel.getProperty("BARCODE_FACINGMODE_BACK")
+				},
+				{
+					"key": "left",
+					"text": oResourceModel.getProperty("BARCODE_FACINGMODE_LEFT")
+				},
+				{
+					"key": "right",
+					"text": oResourceModel.getProperty("BARCODE_FACINGMODE_RIGHT")
+				}
+			],
 			devices: [],
 			apis: {
 				ZebraEnterpriseBrowser: {
@@ -238,11 +265,7 @@ sap.ui.define([
 					status: oScannerAPIStatus.UnAvailable
 				}
 			}
-		}).setDefaultBindingMode(BindingMode.OneWay),
-
-		oResourceModel = new ResourceModel({
-			bundleName: "sap.ndc.messagebundle"
-		});
+		}).setDefaultBindingMode(BindingMode.OneWay);
 
 	/**
 	 * Get the scanner API in data model
@@ -440,7 +463,11 @@ sap.ui.define([
 	function initFeatureAPIs() {
 		jQuery(document).ready(function() {
 			if (isEnumerateDevicesSupported()) {
-				getDeviceCameras();
+				if (isPermissionsSupported()) {
+					getDeviceCamerasWithPermissions();
+				} else {
+					getDeviceCameras();
+				}
 			}
 		});
 		initialZXingCPPAPI();
@@ -533,11 +560,21 @@ sap.ui.define([
 		return !!(window && window.navigator && window.navigator.mediaDevices && window.navigator.mediaDevices.enumerateDevices);
 	}
 
+	/**
+	 * Used to detect if browser support permissions API
+	 * @private
+	 * @returns {boolean} true is permissions API supported by browser
+	 */
+	function isPermissionsSupported() {
+		return !!(navigator.permissions && navigator.permissions.query);
+	}
+
 	/**
 	 * Get the device cameras
+	 * @param {function} resolve Function to be called when done
 	 * @private
 	 */
-	function getDeviceCameras() {
+	function getDeviceCameras(resolve) {
 		Log.debug("BarcodeScanner.getDeviceCameras: start to get device cameras");
 		// List cameras and microphones
 		window.navigator.mediaDevices.enumerateDevices()
@@ -555,15 +592,18 @@ sap.ui.define([
 								"label": device.label
 							};
 							if (oDevice.label && oDevice.label !== "") {
-								if (oDevice.label.indexOf('0, facing back') > 0) {
+								// get lower case of device label
+								var sLabel = oDevice.label.toLowerCase();
+								if (sLabel.indexOf('0, facing back') > 0) {
 									// set the main camera if one camera label contains "0, facing back"
 									Log.debug("BarcodeScanner.getDeviceCameras: has a camera with label contains '0, facing back', set it as main camera.");
 									oDevices.needCheck = false;
 									oDevices.mainCamera = oDevice;
 								}
-								if (oDevice.label.indexOf('back') > 0) {
+								// on MS Surface devices, label of back camare contains "rear", not "back"
+								if (sLabel.indexOf('back') > 0 || sLabel.indexOf('rear') > 0) {
 									oDevices.back.push(oDevice);
-								} else if (oDevice.label.indexOf('front') > 0) {
+								} else if (sLabel.indexOf('front') > 0) {
 									oDevices.front.push(oDevice);
 								}
 							} else {
@@ -573,10 +613,35 @@ sap.ui.define([
 							oDevices.all.push(oDevice);
 						}
 					});
+					// get the number n in the label if the camera label contains "camera <n>"
+					var _extractLabelNumber = function(sLabel) {
+						if (!sLabel) {
+							return Infinity;
+						}
+						sLabel = ('' + sLabel).toLowerCase();
+						// Prefer explicit "camera <n>" pattern when present
+						var mCam = sLabel.match(/camera\s*(\d+)/i);
+						if (mCam && mCam[1]) {
+							return Number.parseInt(String(mCam[1]));
+						} else {
+							return Infinity;
+						}
+					};
+					// sort the back and front camera list by the number in the label
+					if (Array.isArray(oDevices.back) && oDevices.back.length > 1) {
+						oDevices.back.sort(function(a, b) {
+							return _extractLabelNumber(a.label) - _extractLabelNumber(b.label);
+						});
+					}
+					if (Array.isArray(oDevices.front) && oDevices.front.length > 1) {
+						oDevices.front.sort(function(a, b) {
+							return _extractLabelNumber(a.label) - _extractLabelNumber(b.label);
+						});
+					}
 					if (!oDevices.mainCamera) {
 						if (oDevices.back.length === 1) {
 							// set the main camera if only has 1 back camera
-							Log.debug("BarcodeScanner.getDeviceCameras: has only one camera which label contains 'back', set it as main camera.");
+							Log.debug("BarcodeScanner.getDeviceCameras: has only one camera which label contains 'back' or 'rear', set it as main camera.");
 							oDevices.mainCamera = deepClone(oDevices.back[0]);
 							oDevices.needCheck = false;
 						} else if (oDevices.all.length === 1) {
@@ -586,17 +651,58 @@ sap.ui.define([
 							oDevices.needCheck = false;
 						}
 					}
+					oDevices.loaded = true;
 					oModel.setProperty("/devices", oDevices);
 					updateDevicesInStatusModel();
+					if (typeof resolve === "function") {
+						resolve();
+					}
 				}
 			)
 			.catch(
 				function(oErr) {
 					oModel.setProperty("/devices/needCheck", false);
 					Log.error("BarcodeScanner.getDeviceCameras: Can not get device cameras.\nError Message: " + oErr);
+					updateDevicesInStatusModel();
+					if (typeof resolve === "function") {
+						// resolve exists, means called after granted camera permissions. But getting device cameras failed, need to stop loading devices again.
+						Log.debug("BarcodeScanner.getDeviceCameras: set devices loaded to true even get device cameras failed when permissions granted.");
+						oModel.setProperty("/devices/loaded", true);
+						resolve();
+					}
 			});
 	}
 
+	/**
+	 * Get the device cameras with permissions API
+	 * @private
+	 */
+	function getDeviceCamerasWithPermissions(resolve) {
+		Log.debug("BarcodeScanner.getDeviceCamerasWithPermissions: start to get device cameras");
+		navigator.permissions.query({ name: 'camera' }).then(function(status) {
+			if (status.state === 'granted') {
+				Log.debug("BarcodeScanner.getDeviceCamerasWithPermissions: camera permission granted.");
+				getDeviceCameras(resolve);
+			} else {
+				Log.debug("BarcodeScanner.getDeviceCamerasWithPermissions: camera permission not granted, ignore getting device cameras.");
+				updateDevicesInStatusModel();
+				if (typeof resolve === "function") {
+					resolve();
+				}
+			}
+		}).catch(function(err) {
+			oModel.setProperty("/devices/needCheck", false);
+			Log.error("BarcodeScanner.getDeviceCamerasWithPermissions: query camera permissions failed.\nError Message: " + err);
+			updateDevicesInStatusModel();
+			if (typeof resolve === "function") {
+				// resolve exists, means called after granted camera permissions. But getting permissions failed, need to stop loading devices again.
+				Log.debug("BarcodeScanner.getDeviceCameras: set devices loaded to true when getting permissions failed.");
+				oModel.setProperty("/devices/loaded", true);
+				resolve();
+			}
+		});
+	}
+
 	/**
 	 * Find the main camera in the camera list
 	 * @param {Array} aCameras the camera list
@@ -673,8 +779,15 @@ sap.ui.define([
 	 */
 	function updateDevicesInStatusModel() {
 		Log.debug("BarcodeScanner.updateDevicesInStatusModel: update the devices in status model");
-		var oDevices = deepClone(oModel.getProperty("/devices/all"));
-		oStatusModel.setProperty("/devices", oDevices);
+		var aDevices = [{
+			"deviceId": "",
+			"label": oResourceModel.getProperty("BARCODE_DEFAULT")
+		}];
+		var aDevicesInModel = oModel.getProperty("/devices/all");
+		if (aDevicesInModel.length > 0) {
+			aDevices = aDevices.concat(aDevicesInModel);
+		}
+		oStatusModel.setProperty("/devices", aDevices);
 	}
 
 	/**
@@ -1315,7 +1428,7 @@ sap.ui.define([
 	 * @private
 	 */
 	function openCorrectCamera() {
-		if (!oModel.getProperty("/config/preferFrontCamera")) {
+		if (!oModel.getProperty("/config/facingMode")) {
 			delete oModel.getProperty("/config/defaultConstraints/video").facingMode;
 			var oDevices = oModel.getProperty("/devices");
 			if (!oModel.getProperty("/config/deviceId") && !oDevices.mainCamera && !Device.os.ios && !Device.os.macintosh && oDevices.needCheck && oDevices.all.length > 1) {
@@ -1334,25 +1447,40 @@ sap.ui.define([
 		Log.debug("BarcodeScanner.openCamera: start to open camera");
 		oModel.setProperty("/scanDialog/pausedOrientation", undefined);
 		var bIsMainCamera = false;
+		var oDevices = oModel.getProperty("/devices");
+		var sFacingMode = oModel.getProperty("/config/facingMode");
 		if (oModel.getProperty("/config/deviceId")) {
-			// if config/deviceId is set, use it as camera deviceId directly
+			// if user has selected a camera, open the selected camera directly
 			delete oModel.getProperty("/config/defaultConstraints/video").facingMode;
 			oModel.setProperty("/config/defaultConstraints/video/deviceId", {
 				exact: oModel.getProperty("/config/deviceId")
 			});
-		} else if (oModel.getProperty("/config/preferFrontCamera")) {
-			oModel.setProperty("/config/defaultConstraints/video/facingMode", "user");
-			delete oModel.getProperty("/config/defaultConstraints/video").deviceId;
-		} else {
-			var oDevices = oModel.getProperty("/devices");
-			if (oDevices.mainCamera && oDevices.mainCamera.deviceId !== "") {
-				bIsMainCamera = true;
-				oModel.setProperty("/config/defaultConstraints/video/deviceId", {
-					exact: oDevices.mainCamera.deviceId
-				});
+		} else if (sFacingMode) {
+			// if user defines facingMode, use it
+			if (sFacingMode === "back") {
+				// if facingMode === back, use the first back camera if found
+				if (Array.isArray(oDevices.back) && oDevices.back.length > 0) {
+					oModel.setProperty("/config/defaultConstraints/video/deviceId", {
+						exact: oDevices.back[0].deviceId
+					});
+				} else {
+					// if no back camera, use facingMode "environment"
+					oModel.setProperty("/config/defaultConstraints/video/facingMode", "environment");
+					delete oModel.getProperty("/config/defaultConstraints/video").deviceId;
+				}
 			} else {
-				oModel.setProperty("/config/defaultConstraints/video/facingMode", "environment");
+				// if facingMode === front || left || right, use facingMode directly
+				oModel.setProperty("/config/defaultConstraints/video/facingMode", sFacingMode === "front" ? "user" : sFacingMode);
+				delete oModel.getProperty("/config/defaultConstraints/video").deviceId;
 			}
+		} else if (oDevices.mainCamera && oDevices.mainCamera.deviceId !== "") {
+			bIsMainCamera = true;
+			oModel.setProperty("/config/defaultConstraints/video/deviceId", {
+				exact: oDevices.mainCamera.deviceId
+			});
+		} else {
+			oModel.setProperty("/config/defaultConstraints/video/facingMode", "environment");
+			delete oModel.getProperty("/config/defaultConstraints/video").deviceId;
 		}
 		var oConstraints = deepClone(oModel.getProperty("/config/defaultConstraints"));
 		var oVideoResolution = calculateVideoResolution();
@@ -1361,39 +1489,52 @@ sap.ui.define([
 			.getUserMedia(oConstraints)
 			.then(
 				function(stream) {
-					oStream = stream;
-					if (Device.os.ios) {
-						// can not control flashlight on ios devices since no API supported now
-						oModel.setProperty("/scanDialog/hasFlashLight", false);
-						oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", false);
-					} else {
-						if (bIsMainCamera && typeof oDevices.mainCamera.hasFlashLight === "boolean") {
-							// set flashlight
-							oModel.setProperty("/scanDialog/hasFlashLight", oDevices.mainCamera.hasFlashLight);
-							oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", oDevices.mainCamera.hasFlashLight);
+					var videoTrack;
+					if (!oModel.getProperty("/devices/loaded") && isEnumerateDevicesSupported()) {
+						// close current stream to release camera
+						videoTrack = typeof stream.stop === "function" ? stream : stream.getTracks()[0];
+						videoTrack.stop();
+						// get the device list after permission granted, then open correct camera again
+						if (isPermissionsSupported()) {
+							getDeviceCamerasWithPermissions(openCamera);
 						} else {
-							var videoTrack = typeof stream.stop === "function" ? stream : stream.getTracks()[0];
-							checkFlashLight(videoTrack).then(function() {
-								// enable flashlight
-								oModel.setProperty("/scanDialog/hasFlashLight", true);
-								if (bIsMainCamera) {
-									oDevices.mainCamera.hasFlashLight = true;
-								}
-								oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", true);
-							}, function() {
-								oModel.setProperty("/scanDialog/hasFlashLight", false);
-								if (bIsMainCamera) {
-									oDevices.mainCamera.hasFlashLight = false;
-								}
-								oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", false);
-							});
+							getDeviceCameras(openCamera);
 						}
-					}
-					if (oStream) {
-						playbackVideoAndDecode(bAttachOrientationChangeListener);
 					} else {
-						oScanDialog && oScanDialog.getModel().setProperty("/isNoScanner", true);
-						openBarcodeInputDialog(oResourceModel.getResourceBundle().getText('BARCODE_DIALOG_CAMERA_STREAM_ERROR_MSG'));
+						oStream = stream;
+						if (Device.os.ios) {
+							// can not control flashlight on ios devices since no API supported now
+							oModel.setProperty("/scanDialog/hasFlashLight", false);
+							oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", false);
+						} else {
+							if (bIsMainCamera && typeof oDevices.mainCamera.hasFlashLight === "boolean") {
+								// set flashlight
+								oModel.setProperty("/scanDialog/hasFlashLight", oDevices.mainCamera.hasFlashLight);
+								oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", oDevices.mainCamera.hasFlashLight);
+							} else {
+								videoTrack = typeof stream.stop === "function" ? stream : stream.getTracks()[0];
+								checkFlashLight(videoTrack).then(function() {
+									// enable flashlight
+									oModel.setProperty("/scanDialog/hasFlashLight", true);
+									if (bIsMainCamera) {
+										oDevices.mainCamera.hasFlashLight = true;
+									}
+									oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", true);
+								}, function() {
+									oModel.setProperty("/scanDialog/hasFlashLight", false);
+									if (bIsMainCamera) {
+										oDevices.mainCamera.hasFlashLight = false;
+									}
+									oScanDialog && oScanDialog.getModel().setProperty("/hasFlashLight", false);
+								});
+							}
+						}
+						if (oStream) {
+							playbackVideoAndDecode(bAttachOrientationChangeListener);
+						} else {
+							oScanDialog && oScanDialog.getModel().setProperty("/isNoScanner", true);
+							openBarcodeInputDialog(oResourceModel.getResourceBundle().getText('BARCODE_DIALOG_CAMERA_STREAM_ERROR_MSG'));
+						}
 					}
 				}
 			)
@@ -1600,7 +1741,7 @@ sap.ui.define([
 	 */
 	function scanWithCordova() {
 		var options;
-		if (oModel.getProperty("/config/preferFrontCamera")) {
+		if (oModel.getProperty("/config/facingMode") === "front") {
 			options = {
 				preferFrontCamera: true
 			};
@@ -2652,7 +2793,7 @@ sap.ui.define([
 	 *			alert("Value entered: " + mParams.newValue);
 	 *		},
 	 *		"Enter Product Barcode",
-	 *		true,
+	 *		"front",
 	 *		30,
 	 *		1,
 	 *		false,
@@ -2665,7 +2806,7 @@ sap.ui.define([
 	 * @param {function} [fnFail] Function to be called when the scanning is failed
 	 * @param {function} [fnLiveUpdate] Function to be called when value of the dialog's input is changed
 	 * @param {string} [dialogTitle] Defines the barcode input dialog title. If unset, a predefined title will be used.
-	 * @param {boolean} [preferFrontCamera] Flag, which defines whether the front or back camera should be used.
+	 * @param {string|boolean} [facingMode] Defines the facingMode of the camera which should be used. Value can be "", "front", "back", "left", "right", true or false (Backward Compatibility for deprecated parameter "preferFrontCamera"). If value is unset or "", the default camera of device will be used. If set to true, means the value is "front". If set to false, means the value is "" as before.
 	 * @param {float} [frameRate] Defines the frame rate of the camera.
 	 * @param {float} [zoom] Defines the zoom of the camera. This parameter is not supported on iOS.
 	 * @param {boolean} [keepCameraScan] Flag, which defines whether the camera should be used for scanning in Zebra Enterprise Browser.
@@ -2675,7 +2816,7 @@ sap.ui.define([
 	 * @public
 	 * @static
 	 */
-	BarcodeScanner.scan = function (fnSuccess, fnFail, fnLiveUpdate, dialogTitle, preferFrontCamera, frameRate, zoom, keepCameraScan, disableBarcodeInputDialog, customInput) {
+	BarcodeScanner.scan = function (fnSuccess, fnFail, fnLiveUpdate, dialogTitle, facingMode, frameRate, zoom, keepCameraScan, disableBarcodeInputDialog, customInput) {
 		if (!oModel.getProperty("/bReady")) {
 			Log.error("BarcodeScanner.scan: Barcode scanning is already in progress.");
 			return;
@@ -2704,7 +2845,24 @@ sap.ui.define([
 			oModel.setProperty("/scanDialog/title", oResourceModel.getProperty("BARCODE_DIALOG_TITLE"));
 		}
 		oModel.setProperty("/scanDialog/scanningStartTime", Date.now());
-		oModel.setProperty("/config/preferFrontCamera", preferFrontCamera);
+		// apply value of facingMode parameter
+		if (typeof facingMode === "boolean") {
+			// backward compatibility for preferFrontCamera
+			if (facingMode) {
+				oModel.setProperty("/config/facingMode", "front");
+			} else {
+				oModel.setProperty("/config/facingMode", null);
+			}
+		} else if (typeof facingMode === "string"){
+			oModel.setProperty("/config/facingMode", facingMode);
+		} else if (typeof facingMode !== "undefined") {
+			MessageToast.show(
+				oResourceModel.getResourceBundle().getText('BARCODE_DIALOG_CAMERA_UPDATE_PARAMETER_ERROR_MSG', ['facingMode']),
+				{
+					duration: 1000
+				}
+			);
+		}
 		// Reset frameRate
 		if (oModel.getProperty("/config/defaultConstraints/video/frameRate") !== undefined) {
 			delete oModel.getProperty("/config/defaultConstraints/video").frameRate;
@@ -2916,6 +3074,7 @@ sap.ui.define([
 	 * {
 	 *     "enableGS1Header": true,  //If set to true, add the symbology identifier (GS1 specification 5.4.3.7. and 5.4.6.4.) as prefix into the result text.
 	 *     "deviceId": "string" // The specific camera id to scan the Barcode. If set to "", Barcode Scanner will use default camera. This option is not working for iOS devices since do not support to get all the cameras.
+	 *     "facingMode": "string" // Defines the facingMode of the camera which should be used. Value can be "", "front", "back", "left", "right". If set to "", Barcode Scanner will use default camera.
 	 *     "multiScan": {
 	 *         "enabled": false, // If set to true, will support scan multi barcodes, and the max number of the barcodes in each scanning is 10. Default value is false. Only working for ZXingCPP.
 	 *         "showPauseButton": false, // If set to true, will show a button so that can pause/restart the scan in the scan dialog.
@@ -2941,14 +3100,27 @@ sap.ui.define([
 					var oMultiScan = Object.assign({}, oModel.getProperty("/apis/ZXingCPP/multiScan"), options.multiScan);
 					oModel.setProperty("/apis/ZXingCPP/multiScan", oMultiScan);
 					oStatusModel.setProperty("/apis/ZXingCPP/multiScan", deepClone(oMultiScan));
+					Log.debug("The parameter(multiScan) has been changed.");
 					delete oConfig.multiScan;
+				} else if (oKey === "preferFrontCamera") {
+					// backward compatibility for preferFrontCamera
+					if (typeof options.preferFrontCamera === "boolean") {
+						if (options.preferFrontCamera) {
+							oConfig.facingMode = "front";
+							oStatusModel.setProperty("/facingMode", "front");
+						} else {
+							oConfig.facingMode = null;
+							oStatusModel.setProperty("/facingMode", null);
+						}
+					}
+					Log.debug("The parameter(preferFrontCamera) has been changed.");
 				} else if (oConfig.hasOwnProperty(oKey)) {
 					oConfig[oKey] = options[oKey];
 					if (checkZebraEBScanAvailable() && oKey === "enableGS1Header") {
 						oModel.setProperty("/apis/ZebraEnterpriseBrowser/enableBarcodeState", false);
 						EB.Barcode.disable(zebraEBScanEnable);
 					}
-					if (oKey === "deviceId") {
+					if (oKey === "deviceId" || oKey === "facingMode") {
 						oStatusModel.setProperty("/" + oKey, options[oKey]);
 					}
 					Log.debug("The parameter(" + oKey + ") has been changed.");
@@ -2957,6 +3129,7 @@ sap.ui.define([
 				}
 			}
 			oModel.setProperty("/config", oConfig);
+			oModel.checkUpdate();
 			oStatusModel.checkUpdate();
 		} else {
 			Log.error("The options are not available.");

package/src/sap/ndc/BarcodeScannerButton.js

@@ -57,9 +57,20 @@ sap.ui.define([
 
 				/**
 				 * If set to true, the front camera will be used to decode.
+				 * @deprecated As of version 1.144.0, use the 'facingMode' property with value 'front' instead.
 				 */
 				preferFrontCamera : {type : "boolean", defaultValue : false},
 
+				/**
+				 * Defines the facing mode of the camera to use.
+				 * If unset, use the default camera of device.
+				 * <li><code>front</code> - facing mode: front.
+				 * <li><code>back</code> - facing mode: back.
+				 * <li><code>left</code> - facing mode: left. Useless now since most devices have no facing left camera.
+				 * <li><code>right</code> - facing mode: right. Useless now since most devices have no facing right camera.
+				 */
+				facingMode : {type : "string", defaultValue : null},
+
 				/**
 				 * Defines the frame rate of the camera.
 				 */
@@ -173,7 +184,7 @@ sap.ui.define([
 			this._onScanFail.bind(this),
 			this._onInputLiveUpdate.bind(this),
 			this.getProperty("dialogTitle"),
-			this.getProperty("preferFrontCamera"),
+			this.getProperty("facingMode"),
 			this.getProperty("frameRate"),
 			this.getProperty("zoom"),
 			this.getProperty("keepCameraScan"),
@@ -182,6 +193,23 @@ sap.ui.define([
 		);
 	};
 
+	/**
+	 * Sets the preferFrontCamera
+	 * @deprecated As of version 1.144.0, use the 'facingMode' property instead.
+	 * @param {boolean} bValue use front camera or not
+	 */
+	BarcodeScannerButton.prototype.setPreferFrontCamera = function (bValue) {
+		if (typeof bValue === "boolean") {
+			this.setProperty("preferFrontCamera", bValue);
+			if (bValue) {
+				this.setProperty("facingMode", "front");
+			} else {
+				this.setProperty("facingMode", null);
+			}
+		}
+		return this;
+	};
+
 	BarcodeScannerButton.prototype._onScanSuccess = function (mArguments) {
 		this.fireScanSuccess(mArguments);
 	};

package/src/sap/ndc/library.js

@@ -33,7 +33,7 @@ sap.ui.define([
 		],
 		elements: [],
 		noLibraryCSS: true,
-		version: "1.143.0"
+		version: "1.144.0"
 	});
 
 	return thisLib;

package/src/sap/ndc/messagebundle.properties

@@ -102,3 +102,18 @@ BARCODE_DIALOG_CAMERA_SECURITYERROR_ERROR_MSG=SecurityError: User media support
 
 #XMSG: TypeError message for User Media
 BARCODE_DIALOG_CAMERA_TYPEERROR_ERROR_MSG=TypeError: Empty constraint list or all constraints set to false, or getUserMedia method called in insecure context.
+
+#XLST: Label for 'defatult'
+BARCODE_DEFAULT=Default
+
+#XLST: Label for facing mode 'front'
+BARCODE_FACINGMODE_FRONT=Front
+
+#XLST: Label for facing mode 'back'
+BARCODE_FACINGMODE_BACK=Back
+
+#XLST: Label for facing mode 'left'
+BARCODE_FACINGMODE_LEFT=Left
+
+#XLST: Label for facing mode 'right'
+BARCODE_FACINGMODE_RIGHT=Right

package/src/sap/ndc/messagebundle_ar.properties

@@ -102,3 +102,18 @@ BARCODE_DIALOG_CAMERA_SECURITYERROR_ERROR_MSG=SecurityError\: \u062A\u0645 \u062
 
 #XMSG: TypeError message for User Media
 BARCODE_DIALOG_CAMERA_TYPEERROR_ERROR_MSG=TypeError\: \u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0642\u064A\u0648\u062F \u0641\u0627\u0631\u063A\u0629 \u0623\u0648 \u062A\u0645 \u062A\u0639\u064A\u064A\u0646 \u062C\u0645\u064A\u0639 \u0627\u0644\u0642\u064A\u0648\u062F \u0639\u0644\u0649 "\u062E\u0637\u0623"\u060C \u0623\u0648 \u062A\u0645 \u0627\u0633\u062A\u062F\u0639\u0627\u0621 \u0627\u0644\u0623\u0633\u0644\u0648\u0628 getUserMedia \u0641\u064A \u0633\u064A\u0627\u0642 \u063A\u064A\u0631 \u0622\u0645\u0646.
+
+#XLST: Label for 'defatult'
+BARCODE_DEFAULT=\u0627\u0644\u0627\u0641\u062A\u0631\u0627\u0636\u064A
+
+#XLST: Label for facing mode 'front'
+BARCODE_FACINGMODE_FRONT=\u0623\u0645\u0627\u0645\u064A
+
+#XLST: Label for facing mode 'back'
+BARCODE_FACINGMODE_BACK=\u0627\u0644\u062E\u0644\u0641
+
+#XLST: Label for facing mode 'left'
+BARCODE_FACINGMODE_LEFT=\u064A\u0633\u0627\u0631
+
+#XLST: Label for facing mode 'right'
+BARCODE_FACINGMODE_RIGHT=\u064A\u0645\u064A\u0646

package/src/sap/ndc/messagebundle_bg.properties

@@ -102,3 +102,18 @@ BARCODE_DIALOG_CAMERA_SECURITYERROR_ERROR_MSG=SecurityError\: \u041F\u043E\u0434
 
 #XMSG: TypeError message for User Media
 BARCODE_DIALOG_CAMERA_TYPEERROR_ERROR_MSG=TypeError\: \u041F\u0440\u0430\u0437\u0435\u043D \u0441\u043F\u0438\u0441\u044A\u043A \u0441 \u043E\u0433\u0440\u0430\u043D\u0438\u0447\u0435\u043D\u0438\u044F \u0438\u043B\u0438 \u0437\u0430 \u0432\u0441\u0438\u0447\u043A\u0438 \u043E\u0433\u0440\u0430\u043D\u0438\u0447\u0435\u043D\u0438\u044F \u0435 \u0437\u0430\u0434\u0430\u0434\u0435\u043D\u043E \u201E\u041D\u0435\u0432\u044F\u0440\u043D\u043E\u201D, \u0438\u043B\u0438 \u043C\u0435\u0442\u043E\u0434\u044A\u0442 getUserMedia \u0435 \u0438\u0437\u0432\u0438\u043A\u0430\u043D \u0432 \u043D\u0435\u0441\u0438\u0433\u0443\u0440\u0435\u043D \u043A\u043E\u043D\u0442\u0435\u043A\u0441\u0442.
+
+#XLST: Label for 'defatult'
+BARCODE_DEFAULT=\u041F\u043E \u043F\u043E\u0434\u0440\u0430\u0437\u0431\u0438\u0440\u0430\u043D\u0435
+
+#XLST: Label for facing mode 'front'
+BARCODE_FACINGMODE_FRONT=\u041E\u0442\u043F\u0440\u0435\u0434
+
+#XLST: Label for facing mode 'back'
+BARCODE_FACINGMODE_BACK=\u041E\u0442\u0437\u0430\u0434
+
+#XLST: Label for facing mode 'left'
+BARCODE_FACINGMODE_LEFT=\u041E\u0442\u043B\u044F\u0432\u043E
+
+#XLST: Label for facing mode 'right'
+BARCODE_FACINGMODE_RIGHT=\u041E\u0442\u0434\u044F\u0441\u043D\u043E

package/src/sap/ndc/messagebundle_ca.properties

@@ -102,3 +102,18 @@ BARCODE_DIALOG_CAMERA_SECURITYERROR_ERROR_MSG=SecurityError\: El suport de mitja
 
 #XMSG: TypeError message for User Media
 BARCODE_DIALOG_CAMERA_TYPEERROR_ERROR_MSG=TypeError\: La llista de restriccions buida o totes les restriccions estan definides com a falses; o, s'ha cridat al m\u00E8tode getUserMedia en un context no segur.
+
+#XLST: Label for 'defatult'
+BARCODE_DEFAULT=Predeterminat
+
+#XLST: Label for facing mode 'front'
+BARCODE_FACINGMODE_FRONT=Frontal
+
+#XLST: Label for facing mode 'back'
+BARCODE_FACINGMODE_BACK=Posterior
+
+#XLST: Label for facing mode 'left'
+BARCODE_FACINGMODE_LEFT=Esquerra
+
+#XLST: Label for facing mode 'right'
+BARCODE_FACINGMODE_RIGHT=Dreta

package/src/sap/ndc/messagebundle_cnr.properties

@@ -102,3 +102,18 @@ BARCODE_DIALOG_CAMERA_SECURITYERROR_ERROR_MSG=SecurityError\: Korisni\u010Dka po
 
 #XMSG: TypeError message for User Media
 BARCODE_DIALOG_CAMERA_TYPEERROR_ERROR_MSG=TypeError\: Prazna lista ograni\u010Denja ili sva ograni\u010Denja postavljena na false ili je metod getUserMedia pozvan u nesigurnom kontekstu.
+
+#XLST: Label for 'defatult'
+BARCODE_DEFAULT=Standardno
+
+#XLST: Label for facing mode 'front'
+BARCODE_FACINGMODE_FRONT=Naprijed
+
+#XLST: Label for facing mode 'back'
+BARCODE_FACINGMODE_BACK=Nazad
+
+#XLST: Label for facing mode 'left'
+BARCODE_FACINGMODE_LEFT=Lijevo
+
+#XLST: Label for facing mode 'right'
+BARCODE_FACINGMODE_RIGHT=Desno