chrome.printing

Açıklama

İzinler

Kullanılabilirlik

Tüm chrome.printing yöntem ve etkinlikleri, uzantı manifestinde "printing" iznini beyan etmenizi gerektirir. Örneğin:

{
  "name": "My extension",
  ...
  "permissions": [
    "printing"
  ],
  ...
}

Örnekler

Aşağıdaki örneklerde, yazdırma ad alanında yöntemlerin her birinin kullanımı gösterilmektedir. Bu kod, uzantı örnekleri GitHub deposundaki api-samples/printing kaynağından veya buna dayalı olarak kopyalanır.

cancelJob()

Bu örnekte bir 'cancel' öğesini gizlemek için onJobStatusChanged işleyicisi kullanılmaktadır PENDING veya IN_PROGRESS olmadığında jobStatus düğmesini tıklayın. Bazı ağlarda veya Chromebook doğrudan yazıcıya bağlandığında bu durumların, iptal düğmesinin çağrılacak kadar uzun süre görünür hale gelmeyeceği kadar hızlı geçebileceğini unutmayın. Bu, son derece basitleştirilmiş bir yazdırma örneğidir.

chrome.printing.onJobStatusChanged.addListener((jobId, status) => {
  const cancelButton = document.getElementById("cancelButton");
  cancelButton.addEventListener('click', () => {
    chrome.printing.cancelJob(jobId).then((response) => {
      if (response !== undefined) {
        console.log(response.status);
      }
      if (chrome.runtime.lastError !== undefined) {
        console.log(chrome.runtime.lastError.message);
      }
    });
  });
  if (status !== "PENDING" && status !== "IN_PROGRESS") {
    cancelButton.style.visibility = 'hidden';
  } else {
    cancelButton.style.visibility = 'visible';
  }
}

getPrinters() and getPrinterInfo()

Yazıcı bilgilerini almak için getPrinters() çağrısı yapılarak alınan bir yazıcı kimliği gerektiğinden bu işlevler için tek bir örnek kullanılır. Bu örnekte, varsayılan yazıcının adı ve açıklaması konsola kaydedilir. Bu, yazdırma örneğinin basitleştirilmiş bir sürümüdür.

​​const printers = await chrome.printing.getPrinters();
const defaultPrinter = printers.find((printer) => {
  const printerInfo = await chrome.printing.getPrinterInfo(printer.id);
  return printerInfo.isDefault;
}
console.log(`Default printer: ${defaultPrinter.name}.\n\t${defaultPrinter.description}`);

submitJob()

submitJob() yöntemi için üç şey gerekir.

• Yazıcının hangi özelliklerinin kullanılacağını belirten ticket yapısı. Kullanıcının mevcut özellikler arasından seçim yapması gerekiyorsa bu verileri belirli bir yazıcı için getPrinterInfo() kullanarak alabilirsiniz.
• Kullanılacak yazıcıyı ve yazdırılacak dosyayı veya tarihi belirten SubmitJobRequest yapısı. Bu yapı, ticket yapısına bir referans içerir.
• Yazdırılacak dosyanın veya verilerin blob'u.

submitJob() çağrısı yapıldığında, kullanıcıdan yazdırmayı onaylamasının istendiği bir iletişim kutusu tetiklenir. Onayı atlamak için PrintingAPIExtensionsAllowlist öğesini kullanın.

Bu, yazdırma örneğinin basitleştirilmiş bir sürümüdür. ticket öğesinin SubmitJobRequest yapısına (8. satır) ekli olduğuna ve yazdırılacak verilerin bloba (10. satır) dönüştürüldüğüne dikkat edin. Yazıcının kimliğini (1. satır) öğrenmek örnekte burada gösterilenden daha karmaşıktır.

const defaultPrinter = getDefaultPrinter();
const ticket = getPrinterTicket(defaultPrinter);
const arrayBuffer = getPrintData();
const submitJobRequest = {
  job: {
    printerId: defaultPrinter,
    title: 'test job',
    ticket: ticket,
    contentType: 'application/pdf',
    document: new Blob([new Uint8Array(arrayBuffer)], {
      type: 'application/pdf'
    });
  }
};

chrome.printing.submitJob(submitJobRequest, (response) => {
  if (response !== undefined) {
    console.log(response.status);
  }
  if (chrome.runtime.lastError !== undefined) {
    console.log(chrome.runtime.lastError.message);
  }
});

Rulo baskı

Bu örnekte, genellikle makbuz yazdırmayla kullanılan sürekli (veya rulo) yazdırma için bir yazıcı biletinin nasıl oluşturulacağı gösterilmektedir. Rulo yazdırma için submitJobRequest nesnesi, submitJob() örneğinde gösterilenle aynıdır.

Kağıt kesme için varsayılan değeri değiştirmeniz gerekiyorsa vendor_ticket_item tuşunu kullanın. (Varsayılan ayar yazıcıdan yazıcıya değişir.) Değeri değiştirmek için tek üyeli bir dizi sağlayın: id değeri 'finishings' olan bir nesne. Değer, yazdırma işleminin sonunda ruloyu kesen yazıcılar için 'trim' veya yazdırma işinin yırtılması gereken yazıcılar için 'none' olabilir.

const ticket = {
  version: '1.0',
  print: {
    vendor_ticket_item: [{id: 'finishings', value: 'trim'}],
    color: {type: 'STANDARD_MONOCHROME'},
    duplex: {type: 'NO_DUPLEX'},
    page_orientation: {type: 'PORTRAIT'},
    copies: {copies: 1},
    dpi: {horizontal_dpi: 300, vertical_dpi: 300},
    media_size: {
      width_microns: 72320,
      height_microns: 100000
    },
    collate: {collate: false}
  }
};

Bazı yazıcılar "finishings" seçeneğini desteklemez. Yazıcınızın uyumlu olup olmadığını belirlemek için getPrinterInfo() numaralı telefonu arayın ve "display_name"/"finishings/11" olup olmadığına bakın.

"vendor_capability": [
  {
    "display_name": "finishings/11",
    "id": "finishings/11",
    "type": "TYPED_VALUE",
    "typed_value_cap": {
      "value_type": "BOOLEAN"
    }
  },
  ...
]

Biletin media_size anahtarındaki değerler her yazıcıya özeldir. Uygun boyutta bir çağrı seçmek için getPrinterInfo() çağrısı yapın. Döndürülen GetPrinterResponse, "media_size"."option" konumunda desteklenen medya boyutları dizisi içerir. "is_continuous_feed" değeri doğru olan bir seçenek belirleyin. Bilet için yükseklik ve genişlik değerlerini kullanın.

"media_size": {
  "option": [
  {
    "custom_display_name": "",
    "is_continuous_feed": true,
    "max_height_microns": 2000000,
    "min_height_microns": 25400,
    "width_microns": 50800
  },
  ...
  ]
}

chrome.printing.cancelJob(
  jobId: string,
  callback?: function,
)

chrome.printing.getPrinterInfo(
  printerId: string,
  callback?: function,
)

chrome.printing.getPrinters(
  callback?: function,
)

chrome.printing.submitJob(
  request: SubmitJobRequest,
  callback?: function,
)

chrome.printing.onJobStatusChanged.addListener(
  callback: function,
)