browser.system.display

Açıklama

Yayınlanan içerik meta verilerini sorgulamak için system.display API'yi kullanın.

İzinler

system.display

Türler

ActiveState

Chrome 117 ve sonraki sürümler

Ekranın sistem tarafından algılanıp kullanıldığını belirten bir enum. Sistem tarafından algılanmayan ekranlar (ör. bağlantısı kesilmiş veya uyku modu nedeniyle bağlantısı kesilmiş olarak kabul edilen ekranlar) "etkin değil" olarak kabul edilir. Bu durum, örneğin tüm ekranların bağlantısı kesildiğinde mevcut ekranı korumak için kullanılır.

Enum

"active"

"inactive"

Bounds

Özellikler

  • yükseklik

    sayı

    Ekranın piksel cinsinden yüksekliği.

  • sol

    sayı

    Sol üst köşenin x koordinatı.

  • üst

    sayı

    Sol üst köşenin y koordinatı.

  • genişlik

    sayı

    Ekranın piksel cinsinden genişliği.

DisplayLayout

Chrome 53 veya sonraki sürümler

Özellikler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

  • telafi etmek

    sayı

    Ekranın bağlı kenar boyunca olan uzaklığı. 0, en üstteki veya en soldaki köşelerin hizalandığını gösterir.

  • parentId

    dize

    Üst öğe ekranının benzersiz tanımlayıcısı. Kök ise boş olur.

  • position

    LayoutPosition

    Bu ekranın üst öğeye göre düzen konumu. Bu, kök için yoksayılır.

DisplayMode

Chrome 52 ve sonraki sürümler

Özellikler

  • deviceScaleFactor

    sayı

    Görüntüleme modu cihaz ölçeklendirme faktörü.

  • yükseklik

    sayı

    Cihazdan bağımsız (kullanıcı tarafından görülebilen) piksellerde ekran modu yüksekliği.

  • heightInNativePixels

    sayı

    Görüntüleme modunun doğal pikseller cinsinden yüksekliği.

  • isInterlaced

    boolean isteğe bağlı

    Chrome 74 veya daha yeni bir sürüm

    Bu mod interlaced ise doğru, sağlanmamışsa yanlış.

  • isNative

    boole

    Mod, ekranın yerel moduysa doğru (true) değerini alır.

  • isSelected

    boole

    Görüntü modu şu anda seçiliyse doğru değerini döndürür.

  • refreshRate

    sayı

    Chrome 67 veya daha yeni bir sürüm

    Hertz cinsinden ekran modu yenileme hızı.

  • uiScale

    number isteğe bağlı

    Chrome 70'ten beri kullanımdan kaldırıldı

    displayZoomFactor hareketini kullanın

    Ekran modu kullanıcı arayüzü ölçeklendirme faktörü.

  • genişlik

    sayı

    Cihazdan bağımsız (kullanıcı tarafından görülebilen) piksellerde ekran modu genişliği.

  • widthInNativePixels

    sayı

    Yerel piksellerde ekran modu genişliği.

DisplayProperties

Özellikler

  • boundsOriginX

    number isteğe bağlı

    Ayarlanırsa ekranın mantıksal sınırlarının başlangıcını x ekseni boyunca günceller. boundsOriginY ile birlikte uygulanır. Ayarlanmamışsa ve boundsOriginY ayarlanmışsa varsayılan olarak mevcut değer kullanılır. Görüntüleme kaynağı güncellenirken bazı kısıtlamalar uygulanacağından nihai sınır kaynağının, ayarlanan kaynaktan farklı olabileceğini unutmayın. Son sınırlar getInfo kullanılarak alınabilir. Sınırların başlangıç noktası birincil ekranda değiştirilemez.

  • boundsOriginY

    number isteğe bağlı

    Ayarlanırsa ekranın mantıksal sınırlarının başlangıcını y ekseni boyunca günceller. boundsOriginX parametresiyle ilgili dokümanları inceleyin.

  • displayMode

    DisplayMode isteğe bağlı

    Chrome 52 ve sonraki sürümler

    Ayarlanırsa ekran modunu bu değerle eşleşen moda günceller. Diğer parametreler geçersizse bu parametre uygulanmaz. Görüntüleme modu geçersizse uygulanmaz ve bir hata ayarlanır ancak diğer özellikler yine de uygulanır.

  • displayZoomFactor

    number isteğe bağlı

    Chrome 65 veya daha yeni bir sürüm

    Ayarlanırsa ekranla ilişkili yakınlaştırmayı günceller. Bu yakınlaştırma, yeniden düzenleme ve yeniden boyama işlemleri gerçekleştirerek yalnızca piksel piksel genişletme işlemine kıyasla daha kaliteli bir yakınlaştırma sağlar.

  • isPrimary

    boolean isteğe bağlı

    Doğru değerine ayarlanırsa ekranı birincil yapar. Yanlış olarak ayarlanırsa işlemsizdir. Not: Ayarlanırsa gösterim, diğer tüm mülkler için birincil olarak kabul edilir (ör. isUnified ayarlanabilir ve sınırların kaynağı ayarlanamayabilir).

  • isUnified

    boolean isteğe bağlı

    Chrome 59 veya daha yeni bir sürüm

    Yalnızca ChromeOS Doğru değerine ayarlanırsa ekran modunu birleşik masaüstü olarak değiştirir (ayrıntılar için enableUnifiedDesktop bölümüne bakın). Yanlış olarak ayarlanırsa birleşik masaüstü modu devre dışı bırakılır. Bu yalnızca birincil ekran için geçerlidir. Bu değer sağlanırsa mirroringSourceId sağlanmamalıdır ve diğer özellikler yoksayılır. Bu değer sağlanmazsa hiçbir etkisi olmaz.

  • mirroringSourceId

    dize isteğe bağlı

    Chrome 68'den beri kullanımdan kaldırılmıştır.

    setMirrorMode kullanın.

    Yalnızca ChromeOS Ayarlanırsa ve boş değilse yalnızca bu ekranda yansıtmayı etkinleştirir. Aksi takdirde, tüm ekranlarda yansıtma devre dışı bırakılır. Bu değer, yansıtılacak kaynak ekranın kimliğini belirtmelidir. Bu kimlik, setDisplayProperties'e iletilen kimlikle aynı olmamalıdır. Ayarlanırsa başka hiçbir özellik ayarlanamaz.

  • fazla tarama

    İç kısımlar isteğe bağlıdır.

    Ayarlanırsa ekranın overscan iç kısımlarını sağlanan değerlere ayarlar. Overscan değerlerinin negatif olamayacağını veya ekran boyutunun yarısından büyük olamayacağını unutmayın. Aşırı tarama, dahili monitörde değiştirilemez.

  • döndürme

    number isteğe bağlı

    Ayarlanırsa ekranın dönüşünü günceller. Geçerli değerler [0, 90, 180, 270] şeklindedir. Döndürme, ekranın dikey konumuna göre saat yönünde ayarlanır.

DisplayUnitInfo

Özellikler

  • activeState

    ActiveState

    Chrome 117 ve sonraki sürümler

    Ekran algılanır ve sistem tarafından kullanılırsa etkin olur.

  • availableDisplayZoomFactors

    number[]

    Chrome 67 veya daha yeni bir sürüm

    Ekran için ayarlanabilecek yakınlaştırma faktörü değerlerinin listesi.

  • sınırlar

    Sınırlar

    Ekranın mantıksal sınırları.

  • displayZoomFactor

    sayı

    Chrome 65 veya daha yeni bir sürüm

    Ekranın mevcut ve varsayılan yakınlaştırması arasındaki oran. Örneğin, 1 değeri% 100 yakınlaştırmaya, 1,5 değeri ise% 150 yakınlaştırmaya eşittir.

  • dpiX

    sayı

    X ekseni boyunca inç başına düşen piksel sayısı.

  • dpiY

    sayı

    Y ekseni boyunca inç başına düşen piksel sayısı.

  • edid

    Edid isteğe bağlı

    Chrome 67 veya daha yeni bir sürüm

    NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir.

  • hasTouchSupport

    boole

    Chrome 57 ve sonraki sürümler

    Bu ekrana dokunmatik giriş cihazı bağlıysa doğru (True) değerini döndürür.

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

  • isEnabled

    boole

    Bu ekran etkinse doğru değerini döndürür.

  • isPrimary

    boole

    Birincil ekransa doğru değerini alır.

  • isUnified

    boole

    Chrome 59 veya daha yeni bir sürüm

    Birleşik masaüstü modundayken tüm ekranlar için geçerlidir. enableUnifiedDesktop ile ilgili belgelere bakın.

  • mirroringDestinationIds

    string[]

    Chrome 64 veya daha yeni bir sürüm

    Yalnızca ChromeOS Kaynak ekranın yansıtıldığı ekranların tanımlayıcıları. Hiçbir ekran yansıtılmıyorsa boş olur. Bu değer, tüm ekranlar için aynı değere ayarlanır. Bu, mirroringSourceId içermemelidir.

  • mirroringSourceId

    dize

    Yalnızca ChromeOS Yansıtma etkinse yansıtılan ekranın tanımlayıcısı, aksi takdirde boş. Bu ayar, yansıtılan ekran da dahil olmak üzere tüm ekranlar için geçerli olur.

  • modlar

    DisplayMode[]

    Chrome 52 ve sonraki sürümler

    Kullanılabilir ekran modlarının listesi. Mevcut modda isSelected=true olur. Yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş bir dizi olarak ayarlanır.

  • ad

    dize

    Kullanıcı dostu ad (ör. "HP LCD monitör").

  • fazla tarama

    İç boşluklar

    Ekranın, kendi ekran sınırları içindeki yerleşimi. Şu anda yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda boş ekler olarak ayarlanır.

  • döndürme

    sayı

    Ekranın dikey konuma göre saat yönünde dönüşü (derece cinsinden). Şu anda yalnızca ChromeOS'te kullanılabilir. Diğer platformlarda 0 olarak ayarlanır. -1 değeri, cihaz fiziksel tablet durumundayken otomatik döndürme olarak yorumlanır.

  • workArea

    Sınırlar

    Ekran sınırları içindeki kullanılabilir ekran çalışma alanı. Çalışma alanı, işletim sistemi için ayrılmış ekran alanlarını (ör. görev çubuğu ve başlatıcı) içermez.

Edid

Chrome 67 veya daha yeni bir sürüm

Özellikler

  • manufacturerId

    dize

    3 karakterlik üretici kodu. Bkz. Bölüm 3.4.1, sayfa 21. v1.4'te zorunludur.

  • productId

    dize

    2 baytlık üretici tarafından atanmış kod, Bölüm 3.4.2, sayfa 21. v1.4'te zorunludur.

  • yearOfManufacture

    sayı

    Üretim yılı, Bölüm 3.4.4, sayfa 22. v1.4'te zorunludur.

GetInfoFlags

Chrome 59 veya daha yeni bir sürüm

Özellikler

  • singleUnified

    boolean isteğe bağlı

    Doğru olarak ayarlanırsa birleşik masaüstü modundayken getInfo tarafından yalnızca tek bir DisplayUnitInfo döndürülür (enableUnifiedDesktop bölümüne bakın). Varsayılan olarak false (yanlış) değerine ayarlanır.

Insets

Özellikler

  • alt

    sayı

    Y ekseninin alt sınıra olan uzaklığı.

  • sol

    sayı

    Sol sınırdan x ekseni uzaklığı.

  • sağ

    sayı

    Sağ sınırdan x ekseni mesafesi.

  • üst

    sayı

    Üst sınırdan y ekseni uzaklığı.

LayoutPosition

Chrome 53 veya sonraki sürümler

Düzen konumu (ör. ekranın bağlı olduğu üst öğenin kenarı).

Enum

"top"

"right"

"bottom"

"left"

MirrorMode

Chrome 65 veya daha yeni bir sürüm

Ayna modu (ör. bir ekranın diğer ekranlara yansıtılmasının farklı yolları)

Enum

"off"
Varsayılan modu (genişletilmiş veya birleşik masaüstü) belirtir.

"normal"
Varsayılan kaynak ekranın diğer tüm ekranlara yansıtılacağını belirtir.

"mixed"
Belirtilen kaynak ekranın, sağlanan hedef ekranlara yansıtılacağını belirtir. Diğer tüm bağlı ekranlar uzatılır.

MirrorModeInfo

Chrome 65 veya daha yeni bir sürüm

Özellikler

  • mirroringDestinationIds

    string[] isteğe bağlı

    Yansıtma hedefi ekranlarının kimlikleri. Bu yalnızca "karma" için geçerlidir.

  • mirroringSourceId

    dize isteğe bağlı

    Yansıtma kaynağı ekranının kimliği. Bu yalnızca "karma" için geçerlidir.

  • Ayarlanması gereken ayna modu.

Point

Chrome 57 ve sonraki sürümler

Özellikler

  • x

    sayı

    Noktanın x koordinatı.

  • y

    sayı

    Noktanın y koordinatı.

TouchCalibrationPair

Chrome 57 ve sonraki sürümler

Özellikler

  • displayPoint

    Point

    Görüntü noktasının koordinatları.

  • touchPoint

    Point

    Görüntüleme noktasına karşılık gelen dokunma noktasının koordinatları.

TouchCalibrationPairQuad

Chrome 57 ve sonraki sürümler

Özellikler

  • Dokunma kalibrasyonu için ilk dokunma ve görüntüleme noktası gerekir.

  • Dokunma kalibrasyonu için ikinci bir dokunma ve görüntüleme noktası gerekir.

  • Dokunma kalibrasyonu için üçüncü dokunma ve görüntüleme noktası gerekir.

  • Dokunma kalibrasyonu için dördüncü dokunma ve görüntüleme noktası gerekir.

Yöntemler

clearTouchCalibration()

Chrome 57 ve sonraki sürümler 
chrome.system.display.clearTouchCalibration(
  id: string,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Ekranın dokunma kalibrasyonunu sıfırlar ve ekranla ilişkili dokunma kalibrasyonu verilerini temizleyerek varsayılan durumuna geri getirir.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

completeCustomTouchCalibration()

Chrome 57 ve sonraki sürümler 
chrome.system.display.completeCustomTouchCalibration(
  pairs: TouchCalibrationPairQuad,
  bounds: Bounds,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için dokunma kalibrasyonu çiftlerini ayarlar. Bu pairs, startCustomTouchCalibration() içinde id çağrılarak dokunmatik ekranı görüntüleme için kalibre etmek üzere kullanılır. Bu yöntemi çağırmadan önce her zaman startCustomTouchCalibration çağrısı yapın. Başka bir dokunma kalibrasyonu zaten devam ediyorsa bu işlem hata verir.

Parametreler

  • Ekranı kalibre etmek için kullanılan nokta çiftleri.

  • sınırlar

    Sınırlar

    Dokunma kalibrasyonu gerçekleştirildiğinde ekranın sınırları. bounds.left ve bounds.top değerleri yok sayılır.

enableUnifiedDesktop()

Chrome 46 veya daha yeni bir sürüm 
chrome.system.display.enableUnifiedDesktop(
  enabled: boolean,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Birleşik masaüstü özelliğini etkinleştirir/devre dışı bırakır. Yansıtma etkinken etkinleştirilirse yansıtma devre dışı bırakılana kadar masaüstü modu değişmez. Aksi takdirde, masaüstü modu hemen birleşik moda geçer.

Parametreler

  • etkin

    boole

    Birleşik masaüstü etkinleştirilecekse true değerini alır.

getDisplayLayout()

Chrome 53 veya sonraki sürümler 
chrome.system.display.getDisplayLayout(): Promise<DisplayLayout[]>

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Tüm ekranların düzen bilgileri istenir.

İadeler

  • Promise<DisplayLayout[]>

    Chrome 91 veya daha yeni bir sürüm

    Sonuçlarla çözülen Promise.

getInfo()

chrome.system.display.getInfo(
  flags?: GetInfoFlags,
): Promise<DisplayUnitInfo[]>

Bağlı tüm ekran cihazlarının bilgilerini ister.

Parametreler

  • flags

    GetInfoFlags isteğe bağlı

    Chrome 59 veya daha yeni bir sürüm

    Bilgilerin nasıl döndürüleceğini etkileyen seçenekler.

İadeler

  • Promise<DisplayUnitInfo[]>

    Chrome 91 veya daha yeni bir sürüm

    Sonuçlarla çözülen Promise.

overscanCalibrationAdjust()

Chrome 53 veya sonraki sürümler 
chrome.system.display.overscanCalibrationAdjust(
  id: string,
  delta: Insets,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için mevcut fazla tarama içlerini ayarlar. Bu genellikle ekranı bir eksen boyunca hareket ettirmeli (ör. sol+sağ aynı değere sahip) veya bir eksen boyunca ölçeklendirmelidir (ör. üst+alt zıt değerlere sahip). Her Adjust çağrısı, Başlangıç'tan bu yana yapılan önceki çağrılarla birlikte kümülatif olarak hesaplanır.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

  • Aşırı tarama iç kısımlarını değiştirme miktarı.

overscanCalibrationComplete()

Chrome 53 veya sonraki sürümler 
chrome.system.display.overscanCalibrationComplete(
  id: string,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Mevcut değerleri kaydedip yer paylaşımını gizleyerek bir ekran için tam tarama ayarlamalarını tamamlayın.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

overscanCalibrationReset()

Chrome 53 veya sonraki sürümler 
chrome.system.display.overscanCalibrationReset(
  id: string,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekranın fazla tarama içlerini son kaydedilen değere (ör.Start çağrılmadan önceki değer) sıfırlar.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

overscanCalibrationStart()

Chrome 53 veya sonraki sürümler 
chrome.system.display.overscanCalibrationStart(
  id: string,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için overscan kalibrasyonunu başlatır. Bu işlem, ekranda mevcut fazla tarama iç kısımlarını gösteren bir yer paylaşımı gösterir. id ekranı için fazla tarama kalibrasyonu devam ediyorsa bu işlem kalibrasyonu sıfırlar.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

setDisplayLayout()

Chrome 53 veya sonraki sürümler 
chrome.system.display.setDisplayLayout(
  layouts: DisplayLayout[],
): Promise<void>

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Tüm ekranların düzenini ayarlayın. Dahil edilmeyen tüm ekranlarda varsayılan düzen kullanılır. Çakışan veya başka bir şekilde geçersiz olan düzenler geçerli bir düzene ayarlanır. Düzen çözüldükten sonra onDisplayChanged etkinliği tetiklenir.

Parametreler

  • düzenler

    DisplayLayout[]

    Birincil ekran dışındaki tüm ekranlar için gerekli olan düzen bilgileri.

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    İşlev tamamlandığında çözümlenen söz.

setDisplayProperties()

chrome.system.display.setDisplayProperties(
  id: string,
  info: DisplayProperties,
): Promise<void>

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. id ile belirtilen ekranın özelliklerini, info içinde verilen bilgilere göre günceller. Başarısızlık durumunda runtime.lastError ayarlanır.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

  • Değiştirilmesi gereken görüntüleme özellikleriyle ilgili bilgiler. Bir özellik yalnızca info içinde yeni bir değer belirtilirse değiştirilir.

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    İşlev tamamlandığında çözümlenen söz.

setMirrorMode()

Chrome 65 veya daha yeni bir sürüm 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
): Promise<void>

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Görüntüleme modunu belirtilen ayna moduna ayarlar. Her arama, önceki aramalardaki durumu sıfırlar. setDisplayProperties() işlevi, yansıtma hedefi ekranlarda başarısız olur.

Parametreler

  • Görüntüleme moduna uygulanması gereken ayna modu bilgileri.

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    İşlev tamamlandığında çözümlenen söz.

showNativeTouchCalibration()

Chrome 57 ve sonraki sürümler 
chrome.system.display.showNativeTouchCalibration(
  id: string,
): Promise<boolean>

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Ekran kimliği id olan ekran için yerel dokunma kalibrasyonu kullanıcı deneyimini gösterir. Bu işlem, ekranda nasıl devam edileceğiyle ilgili gerekli talimatların yer aldığı bir yer paylaşımı gösterir. Geri çağırma yalnızca kalibrasyon başarılı olduğunda çağrılır. Kalibrasyon başarısız olursa hata oluşur.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

İadeler

  • Promise<boolean>

    Chrome 91 veya daha yeni bir sürüm

    Arayana dokunma kalibrasyonunun sona erdiğini bildirmek için çözümlenen Promise. Boole değeri, kalibrasyonun başarılı olup olmadığını bildirir.

startCustomTouchCalibration()

Chrome 57 ve sonraki sürümler 
chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

NOT: Bu özellik yalnızca ChromeOS kiosk uygulamalarında kullanılabilir. Bir ekran için özel dokunma kalibrasyonunu başlatır. Bu işlev, kalibrasyon verilerini toplamak için özel bir kullanıcı deneyimi kullanılırken çağrılmalıdır. Başka bir dokunma kalibrasyonu zaten devam ediyorsa bu işlem hata verir.

Parametreler

  • id

    dize

    Ekranın benzersiz tanımlayıcısı.

Etkinlikler

onDisplayChanged

chrome.system.display.onDisplayChanged.addListener(
  callback: function,
)

Görüntü yapılandırmasında herhangi bir değişiklik olduğunda tetiklenir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    () => void