chrome.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, 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 veya daha yeni bir sürüm

Ö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 piksel 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ış değerini döndürür.

  • isNative

    boolean

    Mod, ekranın doğal moduysa doğru değerini alır.

  • isSelected

    boolean

    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

    Ekran modunun hertz cinsinden 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ı

    Görüntüleme modunun doğal pikseller cinsinden 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 geçerli 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 veya daha yeni bir sürüm

    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 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 özellikler için birincil olarak kabul edilir (ör. isUnified ayarlanabilir ve sınırları belirleyen kaynak ayarlanmayabilir).

  • 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. Sağlanırsa mirroringSourceId sağlanmamalıdır ve diğer özellikler yoksayılır. Bu değer sağlanmazsa herhangi bir etkisi olmaz.

  • mirroringSourceId

    dize isteğe bağlı

    Chrome 68'den beri kullanımdan kaldırıldı

    setMirrorMode kullanın.

    Yalnızca ChromeOS Ayarlanırsa ve boş değilse yalnızca bu ekran için 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 bir özellik ayarlanamaz.

  • fazla tarama

    İçerikler 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ı

    Ayarlandığında 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.

  • 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ı ve web kullanıcı arayüzünde kullanılabilir.

  • hasTouchSupport

    boolean

    Chrome 57 veya sonraki bir sürüm

    Bu ekrana dokunma giriş cihazı bağlıysa doğru (True).

  • id

    dize

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

  • isEnabled

    boolean

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

  • isPrimary

    boolean

    Birincil ekransa doğru değerini döndürür.

  • isUnified

    boolean

    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

    dize[]

    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 değerini 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 veya daha yeni bir sürüm

    Kullanılabilir ekran modlarının listesi. Geçerli 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 ç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: 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 hedefinin kimlikleri gösterilir. 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 veya sonraki bir sürüm

Özellikler

  • x

    sayı

    Noktanın x koordinatı.

  • y

    sayı

    Noktanın y koordinatı.

TouchCalibrationPair

Chrome 57 veya sonraki bir sürüm

Ö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 veya sonraki bir sürüm

Özellikler

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

  • 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 veya sonraki bir sürüm 
chrome.system.display.clearTouchCalibration(
  id: string,
): void

Ekrana dokunma kalibrasyonunu sıfırlar ve ekranla ilişkili dokunma kalibrasyonu verilerini temizleyerek ekranı varsayılan durumuna geri getirir.

Parametreler

  • id

    dize

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

completeCustomTouchCalibration()

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

Bir ekran için dokunma kalibrasyonu çiftlerini ayarlar. Bu pairs, startCustomTouchCalibration() içinde id çağrılarak dokunmatik ekranı kalibre etmek için 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

Birleşik masaüstü özelliğini etkinleştirir/devre dışı bırakır. Yansıtma etkin durumdayken 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. NOT: Bu özellik yalnızca ChromeOS kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

Parametreler

  • etkin

    boolean

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

getDisplayLayout()

Promise Chrome 53 ve sonraki sürümler 
chrome.system.display.getDisplayLayout(
  callback?: function,
): Promise<DisplayLayout[]>

Tüm ekranların düzen bilgilerini ister. NOT: Bu özellik yalnızca ChromeOS kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

Parametreler

  • callback

    işlev isteğe bağlı

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

    (layouts: DisplayLayout[]) => void

İadeler

  • Promise<DisplayLayout[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getInfo()

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

Tüm bağlı ekran cihazlarının bilgilerini ister.

Parametreler

  • flags

    GetInfoFlags isteğe bağlı

    Chrome 59 veya daha yeni bir sürüm

    Bilgilerin döndürülme şeklini etkileyen seçenekler.

  • callback

    işlev isteğe bağlı

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

    (displayInfo: DisplayUnitInfo[]) => void

İadeler

  • Promise<DisplayUnitInfo[]>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

overscanCalibrationAdjust()

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

Bir ekranda geçerli olan fazla tarama iç kısımlarını 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 kümülatiftir.

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

Mevcut değerleri kaydedip yer paylaşımını gizleyerek bir ekran için fazla 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

Bir ekranın fazla tarama içlerini son kaydedilen değere (ör.Start çağrılmadan önce) 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

Bir ekran için overscan kalibrasyonunu başlatır. Bu işlem, ekranda mevcut overscan iç kısımlarını gösteren bir yer paylaşımı gösterir. Ekran id 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()

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

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 göre ayarlanır. Düzen çözüldükten sonra onDisplayChanged etkinliği tetiklenir. NOT: Bu özellik yalnızca ChromeOS kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

Parametreler

  • düzenler

    DisplayLayout[]

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setDisplayProperties()

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

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. NOT: Bu özellik yalnızca ChromeOS kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

Parametreler

  • id

    dize

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

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setMirrorMode()

Promise Chrome 65 ve sonraki sürümler 
chrome.system.display.setMirrorMode(
  info: MirrorModeInfo,
  callback?: function,
): Promise<void>

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. NOT: Bu özellik yalnızca ChromeOS kiosk uygulamaları ve web kullanıcı arayüzünde kullanılabilir.

Parametreler

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

showNativeTouchCalibration()

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

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ı.

  • callback

    işlev isteğe bağlı

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

    (success: boolean) => void

    • başarılı

      boolean

İadeler

  • Promise<boolean>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

startCustomTouchCalibration()

Chrome 57 veya sonraki bir sürüm 
chrome.system.display.startCustomTouchCalibration(
  id: string,
): void

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