From d893f690fc6ab4bb35d4b938dbd2d70f9ebcf0a2 Mon Sep 17 00:00:00 2001 From: Youenn Fablet Date: Wed, 19 Jun 2024 13:09:28 +0200 Subject: [PATCH 1/8] Add a powerEfficient constraint --- index.html | 111 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) diff --git a/index.html b/index.html index 7057205..26a118f 100644 --- a/index.html +++ b/index.html @@ -930,9 +930,120 @@

Methods

+
+

The powerEfficient constraint

+
+

MediaTrackSupportedConstraints dictionary extensions

+
+ 
partial dictionary MediaTrackSupportedConstraints {
+  boolean powerEfficient = true;
+};
+
+

Dictionary {{MediaTrackSupportedConstraints}} Members

+
+
powerEfficient of type + {{boolean}}, defaulting to true
+
See + powerEfficient for details.
+
+
+
+
+
+

MediaTrackCapabilities dictionary extensions

+
+ 
partial dictionary MediaTrackCapabilities {
+  sequence<boolean> powerEfficient;
+};
+
+

Dictionary {{MediaTrackCapabilities}} Members

+
+
powerEfficient of type + sequence<{{boolean}}>
+
+

The source may operate in different configurations. + If all configurations have the same power efficiency + impact, a single false is reported. + Otherwise, the source reports a list with + both true and false + as possible values. See + powerEfficient for additional + details.

+
+
+
+
+
+
+

MediaTrackSettings dictionary extensions

+
+ 
partial dictionary MediaTrackSettings {
+  boolean powerEfficient;
+};
+
+

Dictionary {{MediaTrackSettings}} Members

+
+
powerEfficient of type + {{boolean}}
+
See + powerEfficient for details.
+
+
+
+

Constrainable Properties

+

The constrainable properties in this document are defined below.

+ + + + + + + + + + + + + + + +
Property NameValuesNotes
+ powerEfficient{{ConstrainBoolean}} +

+ Cameras can often operate in different configurations. + Configurations are typically selected based on constraints + that are related to observable parameters like width or height. + Configurations may have less directly observable characteristics: + power consumption, low light sensitivity, fast autofocus... + The powerEfficient constraint allows web applications to + favor selection of configurations that consume less power. + This may be useful for web applications that may use the camera + for an extended amount of time, like video conference web applications. + On the other hand, applications that may use the camera for a small amount + of time may prefer to not use the powerEfficient constraint. +

+

As a constraint, setting it to true instructs the user agent + to prefer configuration that it considers power efficient.

+
+

The powerEfficientPixelFormat constraint

+
+ This constraint is somehow redundant with the powerEfficient + constraint. It may be removed in a future version of this + specification. +

MediaTrackSupportedConstraints dictionary extensions

Date: Fri, 21 Jun 2024 11:17:02 +0200
Subject: [PATCH 2/8] Update index.html

---
 index.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/index.html b/index.html
index 26a118f..77225a6 100644
--- a/index.html
+++ b/index.html
@@ -1027,6 +1027,7 @@ 
Constrainable Properties

             for an extended amount of time, like video conference web applications.
             On the other hand, applications that may use the camera for a small amount
             of time may prefer to not use the powerEfficient constraint.
+            This constraint is solely relevant to camera sources.
             

             
As a constraint, setting it to true instructs the user agent
             to prefer configuration that it considers power efficient.


From 3235733fdeb2f18277ce47f537bf84e6e0d572f5 Mon Sep 17 00:00:00 2001
From: youennf 
Date: Fri, 21 Jun 2024 11:18:57 +0200
Subject: [PATCH 3/8] Update index.html

Co-authored-by: Harald Alvestrand 
---
 index.html | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/index.html b/index.html
index 77225a6..182ee46 100644
--- a/index.html
+++ b/index.html
@@ -1032,6 +1032,10 @@ 
Constrainable Properties

             
As a constraint, setting it to true instructs the user agent
             to prefer configuration that it considers power efficient.

           
+          

+          This constraint is not usable with getUserMedia, since it's not in allowed required constraints for device selection, and may give surprising results when specifies as a mandatory constraint for applyConstraints, so it should be most useful as an ideal constraint.
+          

+          
         
       
     

From 82454ad8046f02db8e9fb5ad2747db2a0c1a074b Mon Sep 17 00:00:00 2001
From: youennf 
Date: Fri, 21 Jun 2024 11:19:08 +0200
Subject: [PATCH 4/8] Update index.html

Co-authored-by: Jan-Ivar Bruaroey 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 182ee46..178167a 100644
--- a/index.html
+++ b/index.html
@@ -1044,7 +1044,7 @@ 
Constrainable Properties

     
The powerEfficientPixelFormat constraint

     

       

-        This constraint is somehow redundant with the  powerEfficient
         constraint. It may be removed in a future version of this
         specification.

From e5d05bd4bc44cd1e99aa6f8c122e1c7c06959004 Mon Sep 17 00:00:00 2001
From: youennf 
Date: Fri, 21 Jun 2024 11:21:51 +0200
Subject: [PATCH 5/8] Update index.html

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 178167a..0b6bb8b 100644
--- a/index.html
+++ b/index.html
@@ -1033,7 +1033,7 @@ 
Constrainable Properties

             to prefer configuration that it considers power efficient.

           
           

-          This constraint is not usable with getUserMedia, since it's not in allowed required constraints for device selection, and may give surprising results when specifies as a mandatory constraint for applyConstraints, so it should be most useful as an ideal constraint.
+          This constraint is not usable with getUserMedia as a mandatory constraint, since it's not in allowed required constraints for device selection. User Agents MAY use it for device selection though the current distance algorithm is not directly applicable as devices may have different power consumptions while having the same `powerEfficient` capabilities.
           

           
         

From f29a63bc7b62e42c635efc7a088a7ff2a62e83bb Mon Sep 17 00:00:00 2001
From: youennf 
Date: Thu, 27 Jun 2024 16:33:47 +0200
Subject: [PATCH 6/8] Update index.html

Co-authored-by: Jan-Ivar Bruaroey 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 0b6bb8b..1728b63 100644
--- a/index.html
+++ b/index.html
@@ -1027,7 +1027,7 @@ 
Constrainable Properties

             for an extended amount of time, like video conference web applications.
             On the other hand, applications that may use the camera for a small amount
             of time may prefer to not use the powerEfficient constraint.
-            This constraint is solely relevant to camera sources.
+            This constraint is only exposed for camera sources.
             

             
As a constraint, setting it to true instructs the user agent
             to prefer configuration that it considers power efficient.


From 51193baa1ef74f28b75dfb7ddbd90999fdf78960 Mon Sep 17 00:00:00 2001
From: youennf 
Date: Thu, 27 Jun 2024 16:34:54 +0200
Subject: [PATCH 7/8] Update index.html

Co-authored-by: Jan-Ivar Bruaroey 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 1728b63..7a0622e 100644
--- a/index.html
+++ b/index.html
@@ -1027,7 +1027,7 @@ 
Constrainable Properties

             for an extended amount of time, like video conference web applications.
             On the other hand, applications that may use the camera for a small amount
             of time may prefer to not use the powerEfficient constraint.
-            This constraint is only exposed for camera sources.
+            This constraint is only applicable to camera sources.
             

             
As a constraint, setting it to true instructs the user agent
             to prefer configuration that it considers power efficient.


From d52057c37125f08290aa644ff6c444d2597a12cd Mon Sep 17 00:00:00 2001
From: Youenn Fablet 
Date: Mon, 1 Jul 2024 10:55:32 +0200
Subject: [PATCH 8/8] edit fixes

---
 index.html | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/index.html b/index.html
index 6aafc93..d48ea70 100644
--- a/index.html
+++ b/index.html
@@ -928,9 +928,9 @@ 
Methods
-
+

The powerEfficient constraint

-
+

MediaTrackSupportedConstraints dictionary extensions

Dictionary {{MediaTrackSupportedConstraints}} Members
-
+

MediaTrackCapabilities dictionary extensions

Dictionary {{MediaTrackCapabilities}} Members
-
+

MediaTrackSettings dictionary extensions

Constrainable Properties
             to prefer configuration that it considers power efficient.

           
           

-          This constraint is not usable with getUserMedia as a mandatory constraint, since it's not in allowed required constraints for device selection. User Agents MAY use it for device selection though the current distance algorithm is not directly applicable as devices may have different power consumptions while having the same `powerEfficient` capabilities.
+          This constraint is not usable with getUserMedia as a mandatory
+          constraint, since it's not in allowed required constraints for
+          device selection. User Agents MAY use it for device selection
+          though the current distance algorithm is not directly applicable
+          as devices may have different power consumptions while having the
+          same `powerEfficient` capabilities.
           

-
-
+

The powerEfficientPixelFormat constraint