--- title: MediaTrackConstraints slug: Web/API/MediaTrackConstraints translation_of: Web/API/MediaTrackConstraints ---
{{APIRef ("ضبط رسانه و جریان")}}

MediaTrackConstraintsفرهنگ لغت استفاده می شود برای توصیف مجموعه ای از قابلیت ها و ارزش یا ارزش هر یک می تواند در را. یک فرهنگ لغت محدودیتی به {{domxref ("MediaStreamTrack.applyConstraints"، "applyConstraints ()")}}}} منتقل می شود تا یک اسکریپت بتواند مجموعه ای از مقادیر یا محدوده دقیق (موردنیاز) یا مقادیر یا محدوده های مورد نظر برای مسیر و مجموعه اخیر محدودیت های سفارشی درخواست شده توسط {{domxref ("MediaStreamTrack.getConstraints"، "getConstraints ()")}}} بازیابی می شود.

برای هر محدودیت، می توانید به طور معمول مقدار دقیق مورد نیاز خود را، ارزش ایده آل که می خواهید، محدوده ای از مقادیر قابل قبول و / یا یک مقدار که می خواهید تا حد ممکن نزدیک باشد، مشخص کنید. خصوصیات بسته به نوع ملک محدود می شود.

To learn more about how constraints work, see Capabilities, constraints, and settings.

Properties

Some combination—but not necessarily all—of the following properties will exist on the object.

Properties of all media tracks

{{domxref("MediaTrackConstraints.deviceId", "deviceId")}}
A {{domxref("ConstrainDOMString")}} object specifying a device ID or an array of device IDs which are acceptable and/or required.
{{domxref("MediaTrackConstraints.groupId", "groupId")}}
A {{domxref("ConstrainDOMString")}} object specifying a group ID or an array of group IDs which are acceptable and/or required.

Properties of audio tracks

{{domxref("MediaTrackConstraints.autoGainControl", "autoGainControl")}}
A {{domxref("ConstrainBoolean")}} object which specifies whether automatic gain control is preferred and/or required.
{{domxref("MediaTrackConstraints.channelCount", "channelCount")}}
A {{domxref("ConstrainLong")}} specifying the channel count or range of channel counts which are acceptable and/or required.
{{domxref("MediaTrackConstraints.echoCancellation", "echoCancellation")}}
A {{domxref("ConstrainBoolean")}} object specifying whether or not echo cancellation is preferred and/or required.
{{domxref("MediaTrackConstraints.latency", "latency")}}
A {{domxref("ConstrainDouble")}} specifying the latency or range of latencies which are acceptable and/or required.
{{domxref("MediaTrackConstraints.noiseSuppression", "noiseSuppression")}}
A {{domxref("ConstrainBoolean")}} which specifies whether noise suppression is preferred and/or required.
{{domxref("MediaTrackConstraints.sampleRate", "sampleRate")}}
A {{domxref("ConstrainLong")}} specifying the sample rate or range of sample rates which are acceptable and/or required.
{{domxref("MediaTrackConstraints.sampleSize", "sampleSize")}}
A {{domxref("ConstrainLong")}} specifying the sample size or range of sample sizes which are acceptable and/or required.
{{domxref("MediaTrackConstraints.volume", "volume")}}
A {{domxref("ConstrainDouble")}} specifying the volume or range of volumes which are acceptable and/or required.

Properties of image tracks

{{domxref("MediaTrackConstraints.whiteBalanceMode","whiteBalanceMode")}}
A {{jsxref("String")}} specifying one of "none", "manual", "sigle-shot", or "continuous".
{{domxref("MediaTrackConstraints.exposureMode","exposureMode")}}
A {{jsxref("String")}} specifying one of "none", "manual", "sigle-shot", or "continuous".
{{domxref("MediaTrackConstraints.focusMode","focusMode")}}
A {{jsxref("String")}} specifying one of "none", "manual", "sigle-shot", or "continuous".
{{domxref("MediaTrackConstraints.pointsOfInterest","pointsOfInterest")}}
The pixel coordinates on the sensor of one or more points of interest. This is either an object in the form { x:value, y:value } or an array of such objects, where value  is a double-precision integer.
{{domxref("MediaTrackConstraints.expsureCompensation","exposureCompensation")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying f-stop adjustment by up to ±3. 
{{domxref("MediaTrackConstraints.colorTemperature","colorTemperature")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired color temperature in degrees kelvin.
{{domxref("MediaTrackConstraints.iso","iso")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired iso setting.
{{domxref("MediaTrackConstraints.brightness","brightness")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying a desired brightness setting.
{{domxref("MediaTrackConstraints.contrast","contrast")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the degree of difference between light and dark.
{{domxref("MediaTrackConstraints.saturation","saturation")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the degree of color intensity.
{{domxref("MediaTrackConstraints.sharpness","sharpness")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the intensity of edges.
{{domxref("MediaTrackConstraints.focusDistance","focusDistance")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying distance to a focused object.
{{domxref("MediaTrackConstraints.zoom","zoom")}}
A {{domxref("ConstrainDouble")}} (a double-precision integer) specifying the desired focal length.
{{domxref("MediaTrackConstraints.torch","torch")}}
A {{jsxref("Boolean")}} whter the fill light continuously connected, meaning it stays on as long as the track is active.

Properties of video tracks

{{domxref("MediaTrackConstraints.aspectRatio", "aspectRatio")}}
A {{domxref("ConstrainDouble")}} specifying the video aspect ratio or range of aspect ratios which are acceptable and/or required.
{{domxref("MediaTrackConstraints.facingMode", "facingMode")}}
A {{domxref("ConstrainDOMString")}} object specifying a facing or an array of facings which are acceptable and/or required.
{{domxref("MediaTrackConstraints.frameRate", "frameRate")}}
A {{domxref ("ConstrainDouble")}} تعیین نرخ فریم یا دامنه نرخ فریم که قابل قبول و / یا مورد نیاز است.
{{domxref ("MediaTrackConstraints.height"، "height")}}
A {{domxref ("ConstrainLong")}} تعیین ارتفاع ویدیو یا محدوده ارتفاع که قابل قبول و / یا مورد نیاز است.
{{domxref ("MediaTrackConstraints.width"، "width")}}
A {{domxref ("ConstrainLong")}} مشخص کردن عرض ویدئو یا طیف وسیعی از عرض که قابل قبول و / یا مورد نیاز است.

مشخصات فنی

مشخصات وضعیت اظهار نظر
{{SpecName ('Media Capture'، '# dom-mediatrackconstraints'، 'applyConstraints ()')}} {{Spec2 ('رسانه ضبط')}} تعریف اولیه
{{SpecName ('MediaStream تصویر'، '# mediatrackconstraintset-section'، 'applyConstraints ()')}} {{Spec2 ('MediaStream Image')}} محدودیت های تصویر را اضافه می کند.

سازگاری مرورگر

{{CompatibilityTable}}

ویژگی کروم فایرفاکس (Gecko) اینترنت اکسپلورر اپرا سافاری
پشتیبانی پایه {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOpera (46)}} {{CompatUnknown}}
deviceId {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOpera (46)}} {{CompatUnknown}}
groupId {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOpera (46)}} {{CompatUnknown}}
خواص آهنگ صوتی {{CompatNo}} {{CompatUnknown}} {{CompatUnknown}} {{CompatNo}} {{CompatUnknown}}
خواص مسیر تصویر {{CompatChrome (63)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOpera (50)}} {{CompatUnknown}}
خواص آهنگ های ویدئویی {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOpera (46)}} {{CompatUnknown}}
ویژگی Android Webview Chrome برای آندروید فایرفاکس موبایل (Gecko) اینترنت اکسپلورر اپرا موبایل سافاری موبایل
پشتیبانی پایه {{CompatChrome (59)}} {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOperaMobile (46)}} {{CompatUnknown}}
deviceId {{CompatChrome (59)}} {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOperaMobile (46)}} {{CompatUnknown}}
groupId {{CompatChrome (59)}} {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOperaMobile (46)}} {{CompatUnknown}}
خواص آهنگ صوتی {{CompatNo}} {{CompatNo}} {{CompatUnknown}} {{CompatUnknown}} {{CompatNo}} {{CompatUnknown}}
خواص مسیر تصویر {{CompatChrome (63)}} {{CompatChrome (63)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOperaMobile (50)}} {{CompatUnknown}}
خواص آهنگ های ویدئویی {{CompatChrome (59)}} {{CompatChrome (59)}} {{CompatUnknown}} {{CompatUnknown}} {{CompatOperaMobile (46)}} {{CompatUnknown}}

همچنین نگاه کنید