diff options
Diffstat (limited to 'files/fa/web/api/mediatrackconstraints/index.html')
-rw-r--r-- | files/fa/web/api/mediatrackconstraints/index.html | 264 |
1 files changed, 264 insertions, 0 deletions
diff --git a/files/fa/web/api/mediatrackconstraints/index.html b/files/fa/web/api/mediatrackconstraints/index.html new file mode 100644 index 0000000000..11f3c9e37f --- /dev/null +++ b/files/fa/web/api/mediatrackconstraints/index.html @@ -0,0 +1,264 @@ +--- +title: MediaTrackConstraints +slug: Web/API/MediaTrackConstraints +translation_of: Web/API/MediaTrackConstraints +--- +<div><font><font>{{APIRef ("ضبط رسانه و جریان")}}</font></font></div> + +<p><strong><code>MediaTrackConstraints</code></strong><font><font>فرهنگ لغت استفاده می شود برای توصیف مجموعه ای از قابلیت ها و ارزش یا ارزش هر یک می تواند در را. </font><font>یک فرهنگ لغت محدودیتی به {{domxref ("MediaStreamTrack.applyConstraints"، "applyConstraints ()")}}}} منتقل می شود تا یک اسکریپت بتواند مجموعه ای از مقادیر یا محدوده دقیق (موردنیاز) یا مقادیر یا محدوده های مورد نظر برای مسیر و مجموعه اخیر محدودیت های سفارشی درخواست شده توسط {{domxref ("MediaStreamTrack.getConstraints"، "getConstraints ()")}}} بازیابی می شود.</font></font></p> + +<p><font><font>برای هر محدودیت، می توانید به طور معمول مقدار دقیق مورد نیاز خود را، ارزش ایده آل که می خواهید، محدوده ای از مقادیر قابل قبول و / یا یک مقدار که می خواهید تا حد ممکن نزدیک باشد، مشخص کنید. </font><font>خصوصیات بسته به نوع ملک محدود می شود.</font></font></p> + +<p>To learn more about how constraints work, see <a href="/en-US/docs/Web/API/Media_Streams_API/Constraints">Capabilities, constraints, and settings</a>.</p> + +<h2 id="Properties">Properties</h2> + +<p>Some combination—but not necessarily all—of the following properties will exist on the object.</p> + +<h3 id="Properties_of_all_media_tracks">Properties of all media tracks</h3> + +<dl> + <dt>{{domxref("MediaTrackConstraints.deviceId", "deviceId")}}</dt> + <dd>A {{domxref("ConstrainDOMString")}} object specifying a device ID or an array of device IDs which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.groupId", "groupId")}}</dt> + <dd>A {{domxref("ConstrainDOMString")}} object specifying a group ID or an array of group IDs which are acceptable and/or required.</dd> +</dl> + +<h3 id="Properties_of_audio_tracks">Properties of audio tracks</h3> + +<dl> + <dt>{{domxref("MediaTrackConstraints.autoGainControl", "autoGainControl")}}</dt> + <dd>A {{domxref("ConstrainBoolean")}} object which specifies whether automatic gain control is preferred and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.channelCount", "channelCount")}}</dt> + <dd>A {{domxref("ConstrainLong")}} specifying the channel count or range of channel counts which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.echoCancellation", "echoCancellation")}}</dt> + <dd>A {{domxref("ConstrainBoolean")}} object specifying whether or not echo cancellation is preferred and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.latency", "latency")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} specifying the latency or range of latencies which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.noiseSuppression", "noiseSuppression")}}</dt> + <dd>A {{domxref("ConstrainBoolean")}} which specifies whether noise suppression is preferred and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.sampleRate", "sampleRate")}}</dt> + <dd>A {{domxref("ConstrainLong")}} specifying the sample rate or range of sample rates which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.sampleSize", "sampleSize")}}</dt> + <dd>A {{domxref("ConstrainLong")}} specifying the sample size or range of sample sizes which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.volume", "volume")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} specifying the volume or range of volumes which are acceptable and/or required.</dd> +</dl> + +<h3 id="Properties_of_image_tracks">Properties of image tracks</h3> + +<dl> + <dt>{{domxref("MediaTrackConstraints.whiteBalanceMode","whiteBalanceMode")}}</dt> + <dd>A {{jsxref("String")}} specifying one of <code>"none"</code>, <code>"manual"</code>, <code>"sigle-shot"</code>, or <code>"continuous"</code>.</dd> + <dt>{{domxref("MediaTrackConstraints.exposureMode","exposureMode")}}</dt> + <dd>A {{jsxref("String")}} specifying one of <code>"none"</code>, <code>"manual"</code>, <code>"sigle-shot"</code>, or <code>"continuous"</code>.</dd> + <dt>{{domxref("MediaTrackConstraints.focusMode","focusMode")}}</dt> + <dd>A {{jsxref("String")}} specifying one of <code>"none"</code>, <code>"manual"</code>, <code>"sigle-shot"</code>, or <code>"continuous"</code>.</dd> + <dt>{{domxref("MediaTrackConstraints.pointsOfInterest","pointsOfInterest")}}</dt> + <dd>The pixel coordinates on the sensor of one or more points of interest. This is either an object in the form { x:<em>value</em>, y:<em>value</em> } or an array of such objects, where <em>value </em> is a double-precision integer.</dd> + <dt>{{domxref("MediaTrackConstraints.expsureCompensation","exposureCompensation")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying f-stop adjustment by up to ±3. </dd> + <dt>{{domxref("MediaTrackConstraints.colorTemperature","colorTemperature")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired color temperature in degrees kelvin.</dd> + <dt>{{domxref("MediaTrackConstraints.iso","iso")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired iso setting.</dd> + <dt>{{domxref("MediaTrackConstraints.brightness","brightness")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired brightness setting.</dd> + <dt>{{domxref("MediaTrackConstraints.contrast","contrast")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the degree of difference between light and dark.</dd> + <dt>{{domxref("MediaTrackConstraints.saturation","saturation")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the degree of color intensity.</dd> + <dt>{{domxref("MediaTrackConstraints.sharpness","sharpness")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the intensity of edges.</dd> + <dt>{{domxref("MediaTrackConstraints.focusDistance","focusDistance")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying distance to a focused object.</dd> + <dt>{{domxref("MediaTrackConstraints.zoom","zoom")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the desired focal length.</dd> + <dt>{{domxref("MediaTrackConstraints.torch","torch")}}</dt> + <dd>A {{jsxref("Boolean")}} whter the fill light continuously connected, meaning it stays on as long as the track is active.</dd> +</dl> + +<h3 id="Properties_of_video_tracks">Properties of video tracks</h3> + +<dl> + <dt>{{domxref("MediaTrackConstraints.aspectRatio", "aspectRatio")}}</dt> + <dd>A {{domxref("ConstrainDouble")}} specifying the video aspect ratio or range of aspect ratios which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.facingMode", "facingMode")}}</dt> + <dd>A {{domxref("ConstrainDOMString")}} object specifying a facing or an array of facings which are acceptable and/or required.</dd> + <dt>{{domxref("MediaTrackConstraints.frameRate", "frameRate")}}</dt> + <dd><font><font>A {{domxref ("ConstrainDouble")}} تعیین نرخ فریم یا دامنه نرخ فریم که قابل قبول و / یا مورد نیاز است.</font></font></dd> + <dt><font><font>{{domxref ("MediaTrackConstraints.height"، "height")}}</font></font></dt> + <dd><font><font>A {{domxref ("ConstrainLong")}} تعیین ارتفاع ویدیو یا محدوده ارتفاع که قابل قبول و / یا مورد نیاز است.</font></font></dd> + <dt><font><font>{{domxref ("MediaTrackConstraints.width"، "width")}}</font></font></dt> + <dd><font><font>A {{domxref ("ConstrainLong")}} مشخص کردن عرض ویدئو یا طیف وسیعی از عرض که قابل قبول و / یا مورد نیاز است.</font></font></dd> +</dl> + +<h2 id="مشخصات_فنی"><font><font>مشخصات فنی</font></font></h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col"><font><font>مشخصات</font></font></th> + <th scope="col"><font><font>وضعیت</font></font></th> + <th scope="col"><font><font>اظهار نظر</font></font></th> + </tr> + <tr> + <td><font><font>{{SpecName ('Media Capture'، '# dom-mediatrackconstraints'، 'applyConstraints ()')}}</font></font></td> + <td><font><font>{{Spec2 ('رسانه ضبط')}}</font></font></td> + <td><font><font>تعریف اولیه</font></font></td> + </tr> + <tr> + <td><font><font>{{SpecName ('MediaStream تصویر'، '# mediatrackconstraintset-section'، 'applyConstraints ()')}}</font></font></td> + <td><font><font>{{Spec2 ('MediaStream Image')}}</font></font></td> + <td><font><font>محدودیت های تصویر را اضافه می کند.</font></font></td> + </tr> + </tbody> +</table> + +<h2 id="سازگاری_مرورگر"><font><font>سازگاری مرورگر</font></font></h2> + +<p><font><font>{{CompatibilityTable}}</font></font></p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th><font><font>ویژگی</font></font></th> + <th><font><font>کروم</font></font></th> + <th><font><font>فایرفاکس (Gecko)</font></font></th> + <th><font><font>اینترنت اکسپلورر</font></font></th> + <th><font><font>اپرا</font></font></th> + <th><font><font>سافاری</font></font></th> + </tr> + <tr> + <td><font><font>پشتیبانی پایه</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOpera (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><code>deviceId</code></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOpera (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><code>groupId</code></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOpera (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><font><font>خواص آهنگ صوتی</font></font></td> + <td><font><font>{{CompatNo}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatNo}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><font><font>خواص مسیر تصویر</font></font></td> + <td><font><font>{{CompatChrome (63)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOpera (50)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><font><font>خواص آهنگ های ویدئویی</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOpera (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th><font><font>ویژگی</font></font></th> + <th><font><font>Android Webview</font></font></th> + <th><font><font>Chrome برای آندروید</font></font></th> + <th><font><font>فایرفاکس موبایل (Gecko)</font></font></th> + <th><font><font>اینترنت اکسپلورر</font></font></th> + <th><font><font>اپرا موبایل</font></font></th> + <th><font><font>سافاری موبایل</font></font></th> + </tr> + <tr> + <td><font><font>پشتیبانی پایه</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOperaMobile (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><code>deviceId</code></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOperaMobile (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><code>groupId</code></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOperaMobile (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><font><font>خواص آهنگ صوتی</font></font></td> + <td><font><font>{{CompatNo}}</font></font></td> + <td><font><font>{{CompatNo}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatNo}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><font><font>خواص مسیر تصویر</font></font></td> + <td><font><font>{{CompatChrome (63)}}</font></font></td> + <td><font><font>{{CompatChrome (63)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOperaMobile (50)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + <tr> + <td><font><font>خواص آهنگ های ویدئویی</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatChrome (59)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + <td><font><font>{{CompatOperaMobile (46)}}</font></font></td> + <td><font><font>{{CompatUnknown}}</font></font></td> + </tr> + </tbody> +</table> +</div> + +<h2 id="همچنین_نگاه_کنید"><font><font>همچنین نگاه کنید</font></font></h2> + +<ul> + <li><font><font>{{domxref ("MediaDevices.getUserMedia ()")}}</font></font></li> + <li><font><font>{{domxref ("MediaStreamTrack.getConstraints ()")}}</font></font></li> + <li><font><font>{{domxref ("MediaStreamTrack.applyConstraints ()")}}</font></font></li> + <li><font><font>{{domxref ("MediaDevices.getSupportedConstraints ()")}}</font></font></li> + <li><font><font>{{domxref ("MediaTrackSupportedConstraints")}}</font></font></li> + <li><font><font>{{domxref ("MediaStreamTrack.getSettings ()")}}</font></font></li> +</ul> |