Herramientas para capturar y convertir la web

Cliente GrabzIt con PHPAPI PHP

Descripción

Esta clase maneja toda la comunicación con los servicios web de captura de pantalla de GrabzIt.

Métodos públicos

GetResult($ id)

Este método devuelve la captura de pantalla en sí. Si no se devuelve nada, entonces algo salió mal o la captura de pantalla aún no está lista.

parámetros

  • id: el identificador único de la captura de pantalla
    • Requerido

Valor de retorno

La captura


URLToAnimation($ url, $ opciones = nulo)

Especifique la URL del video en línea que debe convertirse into un GIF animado.

parámetros

  • url: la URL del video en línea para convertir into un GIF animado.
    • Requerido
    • Acepta URL de videos de Vimeo y YouTube
      • La advertencia de animación de videos de Vimeo y YouTube depende de un tercero y, por lo tanto, puede no proporcionar resultados consistentes.
  • opciones - una instancia de GrabzItAnimationOptions clase que define cualquier opción especial para usar al crear el GIF animado.

Valor de retorno

vacío

GrabzItAnimationOptions

La clase representa todas las opciones disponibles al crear un GIF animado.

Propiedades publicas

  • setCustomId($value) - Identificador personalizado que puede pasar al servicio web animado GIF. Esto se devolverá con la URL de devolución de llamada que ha especificado.
    • Predeterminado: vacío
  • setWidth($value) - el ancho del GIF animado resultante en píxeles.
    • Predeterminado: 180px
    • Máximo: ancho máximo para el paquete
    • Tamaño automático: -1 (pasando -1 significa que el ancho de la GIF animado se escala en relación con su altura, si el ancho se ajusta automáticamente, la altura no puede)
  • setHeight($value) - la altura del GIF animado resultante en píxeles.
    • Predeterminado: 120px
    • Máximo: altura máxima para el paquete
    • Tamaño automático: -1 (pasando -1 significa que la altura de la GIF animado se escala en relación con su ancho, si la altura se está dimensionando automáticamente, el ancho no puede)
  • setStart($value) - la posición inicial del video que debe convertirse into un GIF animado.
    • Predeterminado: 0 segundos
  • setDuration($value) - la duración en segundos del video que debe convertirse into un GIF animado.
    • Valor predeterminado: longitud máxima para el paquete
  • setSpeed($value) - La velocidad del GIF animado.
    • Predeterminado: 1
    • Mínimo: 0.2
    • Máxima: 10
  • setFramesPerSecond($value) - la cantidad de fotogramas por segundo que deben capturarse del video.
    • Predeterminado: 10
    • Mínimo: 0.2
    • Máxima: 60
  • setRepeat($value) - Número de veces para recorrer el GIF animado.
    • Predeterminado: 0
    • Bucle continuo: 0
  • setReverse($value) - si es cierto, los cuadros del GIF animado se invierten
    • Predeterminado: falso
  • setCustomWaterMarkId($value) - Agregar marca de agua personalizada al GIF animado
    • Predeterminado: vacío
  • setQuality($value) - el calidad de la imagen devuelta, que tiene una compresión predeterminada de 85%.
    • Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
    • Predeterminado: -1
    • Mínimo: -1
    • Máxima: 100
  • setCountry($value) - el país el GIF animado debe tomarse de.
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Valor predeterminado: la ubicación más rápida actual
    • Opciones: "SG", "Reino Unido", "EE. UU."
  • setExportURL($value) - el exportar URL que especifica dónde se debe exportar la captura también
    • Predeterminado: vacío
  • setEncryptionKey($value) - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
    • Predeterminado: vacío
  • setProxy($value) - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
    • Predeterminado: vacío

URLToImage($ url, $ opciones = nulo)

Especifica la URL que se debe convertir into una captura de pantalla de imagen.

parámetros

  • url: la URL de la que debe estar hecha la captura de pantalla
    • Requerido
  • opciones - una instancia de GrabzItImageOptions clase que define cualquier opción especial para usar al crear la captura de pantalla.

Valor de retorno

vacío

HTMLToImage($ html, $ opciones = nulo)

Especifica el HTML que se debe convertir intuna imagen

parámetros

  • html - el HTML para convertir intuna imagen
    • Requerido
  • opciones - una instancia de GrabzItImageOptions clase que define cualquier opción especial para usar al crear una imagen.

Valor de retorno

vacío

FileToImage($ ruta, $ opciones = nulo)

Especifica un archivo HTML que debe convertirse intuna imagen

parámetros

  • ruta de acceso: la ruta del archivo HTML para convertir intuna imagen
    • Requerido
  • opciones - una instancia de GrabzItImageOptions clase que define cualquier opción especial para usar al crear una imagen.

Valor de retorno

vacío

GrabzItImageOptions

La clase representa todas las opciones disponibles al crear capturas de imágenes.

Propiedades publicas

  • setCustomId($value) - Identificador personalizado que puede pasar al servicio web de captura de pantalla. Esto se devolverá con la URL de devolución de llamada que ha especificado.
    • Predeterminado: vacío
  • setBrowserWidth($value) - el ancho del navegador en píxeles
    • Predeterminado: 1024
    • Máxima: 10000
  • setBrowserHeight($value) - la altura del navegador en píxeles
    • Predeterminado: 768
    • Máxima: 10000
    • Longitud total: -1 (pasar -1 significa que se toma una captura de pantalla de toda la página web)
  • setWidth($value) - el ancho de la miniatura resultante en píxeles
    • Valor predeterminado: la relación más alta posible del ancho del navegador que se ajusta al ancho máximo para el paquete de usuarios
    • Máximo: ancho máximo para el paquete
    • Ancho completo: -1 (pasar -1 significa que el ancho de la miniatura no se reduce)
  • setHeight($value) - la altura de la miniatura resultante en píxeles
    • Valor predeterminado: la relación más alta posible de altura del navegador que se ajusta a la altura máxima para el paquete de usuarios
    • Máximo: altura máxima para el paquete
    • Altura completa: -1 (pasar -1 significa que la altura de la miniatura no se reduce)
  • setFormat($value) - el formato en el que debe estar la captura de pantalla.
    • Predeterminado: "jpg"
    • Opciones: "bmp8", "bmp16", "bmp24", "bmp", "tiff", "webp", "jpg", "png"
  • setDelay($value) - el número de milisegundos a espera antes de tomar la captura de pantalla
    • Predeterminado: 0
    • Máxima: 30000
  • setTargetElement($value) - la identificación o clase Selector de CSS del único elemento HTML en la página web de destino que se va a convertir into una captura de pantalla, se ignoran todas las otras partes de la página web. Si hay varios elementos HTML coincidentes, se elige el primero.
    • Predeterminado: vacío
  • setHideElement($value) - la identificación o clase Selectores CSS de uno o más elementos HTML en la página web para ocultar, para especificar múltiples elementos HTML para ocultar, separe cada selector con una coma
    • Predeterminado: vacío
  • setWaitForElement($value) - la identificación o clase Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
    • Predeterminado: vacío
  • setRequestAs($value) - el tipo de agente de usuario que desea utilizar
    • Predeterminado: 0
    • Opciones:
      • 0 = indica que se debe usar el agente de usuario de un navegador estándar
      • 1 = indica que se debe usar el agente de usuario de un navegador móvil
      • 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
      • 3 = indica que se debe usar el agente de usuario de un navegador básico
  • setCustomWaterMarkId($value) - agregue una marca de agua personalizada a la imagen
    • Predeterminado: vacío
  • setQuality($value) - el calidad de la imagen devuelta. Actualmente, esto solo afecta a las imágenes JPG, que tienen una compresión predeterminada de 85%.
    • Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
    • Predeterminado: -1
    • Mínimo: -1
    • Máxima: 100
  • setTransparent($value) - si es cierto el la captura de imagen debe ser transparente. Esto solo es compatible con imágenes png y tiff.
    • Predeterminado: falso
  • setHD($value) - si es verdad la imagen la captura será en alta definición esto duplica el tamaño de las dimensiones de la imagen.
    • Predeterminado: 0
  • setCountry($value) - el país la captura de pantalla debe tomarse de.
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Valor predeterminado: la ubicación más rápida actual
    • Opciones: "SG", "Reino Unido", "EE. UU."
  • setExportURL($value) - el exportar URL que especifica dónde se debe exportar la captura también
    • Predeterminado: vacío
  • setEncryptionKey($value) - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
    • Predeterminado: vacío
  • setNoAds($value) - si es verdad los anuncios deben ocultarse automáticamente.
    • Predeterminado: falso
  • setNoCookieNotifications($value) - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
    • Predeterminado: falso
  • setAddress($value) - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
    • Predeterminado: vacío
  • setProxy($value) - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
    • Predeterminado: vacío

Métodos públicos

  • AddPostParameter ($ nombre, $ valor) - define un parámetro HTTP Post y, opcionalmente, un valor, este método se puede llamar varias veces para agregar múltiples parámetros. El uso de este método obligará a GrabzIt a realizar una publicación HTTP.
    • nombre: el nombre del parámetro HTTP Post
    • valor: el valor del parámetro HTTP Post

URLToRenderedHTML($ url, $ opciones = nulo)

Especifica la URL que se debe convertir into HTML procesado.

parámetros

  • url: la URL de la que debe estar hecho el HTML representado
    • Requerido
  • opciones - una instancia de GrabzItHTMLOptions clase que define cualquier opción especial para usar al crear el HTML representado.

Valor de retorno

vacío

HTMLToRenderedHTML($ html, $ opciones = nulo)

Especifica el HTML que se debe convertir into HTML procesado.

parámetros

  • html - el HTML para convertir into HTML procesado
    • Requerido
  • opciones - una instancia de GrabzItHTMLOptions clase que define cualquier opción especial para usar al crear HTML renderizado.

Valor de retorno

vacío

FileToRenderedHTML($ ruta, $ opciones = nulo)

Especifica un archivo HTML que debe convertirse into HTML procesado.

parámetros

  • ruta de acceso: la ruta del archivo HTML para convertir into HTML procesado
    • Requerido
  • opciones - una instancia de GrabzItHTMLOptions clase que define cualquier opción especial para usar al crear HTML renderizado.

Valor de retorno

vacío

GrabzItHTMLOptions

La clase representa todas las opciones disponibles cuando crear capturas HTML representadas.

Propiedades publicas

  • setCustomId($value) - Identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado.
    • Predeterminado: vacío
  • setBrowserWidth($value) - el ancho del navegador en píxeles
    • Predeterminado: 1024
    • Máxima: 10000
  • setBrowserHeight($value) - la altura del navegador en píxeles
    • Predeterminado: 768
    • Máxima: 10000
  • setDelay($value) - el número de milisegundos a espera antes de tomar la captura
    • Predeterminado: 0
    • Máxima: 30000
  • setWaitForElement($value) - la identificación o clase Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
    • Predeterminado: vacío
  • setRequestAs($value) - el tipo de agente de usuario que desea utilizar
    • Predeterminado: 0
    • Opciones:
      • 0 = indica que se debe usar el agente de usuario de un navegador estándar
      • 1 = indica que se debe usar el agente de usuario de un navegador móvil
      • 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
      • 3 = indica que se debe usar el agente de usuario de un navegador básico
  • setCountry($value) - el país la captura de pantalla debe tomarse de.
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Valor predeterminado: la ubicación más rápida actual
    • Opciones: "SG", "Reino Unido", "EE. UU."
  • setExportURL($value) - el exportar URL que especifica dónde se debe exportar la captura también
    • Predeterminado: vacío
  • setEncryptionKey($value) - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
    • Predeterminado: vacío
  • setNoAds($value) - si es verdad los anuncios deben ocultarse automáticamente.
    • Predeterminado: falso
  • setNoCookieNotifications($value) - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
    • Predeterminado: falso
  • setAddress($value) - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
    • Predeterminado: vacío
  • setProxy($value) - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
    • Predeterminado: vacío

Métodos públicos

  • AddPostParameter ($ nombre, $ valor) - define un parámetro HTTP Post y, opcionalmente, un valor, este método se puede llamar varias veces para agregar múltiples parámetros. El uso de este método obligará a GrabzIt a realizar una publicación HTTP.
    • nombre: el nombre del parámetro HTTP Post
    • valor: el valor del parámetro HTTP Post

URLToPDF($ url, $ opciones = nulo)

Especifica la URL que se debe convertir intoa PDF.

parámetros

  • url: la URL a la que se debe convertir intoa PDF
    • Requerido
  • opciones - una instancia de la clase GrabzItPDFOptions que define las opciones especiales que se utilizarán al crear un PDF.

Valor de retorno

vacío

HTMLToPDF($ html, $ opciones = nulo)

Especifica el HTML que se debe convertir intoa PDF.

parámetros

  • html - el HTML para convertir intoa PDF
    • Requerido
  • opciones - una instancia de la clase GrabzItPDFOptions que define las opciones especiales que se utilizarán al crear un PDF.

Valor de retorno

vacío

FileToPDF($ ruta, $ opciones = nulo)

Especifica un archivo HTML que debe convertirse intoa PDF.

parámetros

  • ruta de acceso: la ruta del archivo HTML para convertir intoa PDF
    • Requerido
  • opciones - una instancia de la clase GrabzItPDFOptions que define las opciones especiales que se utilizarán al crear un PDF.

Valor de retorno

vacío

GrabzItPDFOptions

La clase representa todas las opciones disponibles al crear capturas de PDF.

Propiedades publicas

  • setCustomId($value) - un identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado.
    • Predeterminado: vacío
  • setIncludeBackground($value) - si es cierto, el fondo de la página web debe incluirse en la captura de pantalla
    • Predeterminado: verdadero
  • setPageSize($value) - el tamaño de página del PDF
    • Valor predeterminado: "A4"
    • Opciones: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Carta"
  • setOrientation($value) - la orientación del documento PDF
    • Valor predeterminado: "Retrato"
    • Opciones: "Retrato", "Paisaje"
  • setCSSMediaType($value) - el Tipo de medio CSS del documento PDF
    • Pantalla predeterminada"
    • Opciones: "Pantalla", "Print"
  • setIncludeLinks($value) - verdadero si los enlaces deben incluirse en el PDF
    • Predeterminado: verdadero
  • setIncludeOutline($value) - cierto si Marcadores PDF debe ser incluido
    • Predeterminado: falso
  • setTitle($value) - proporcione un título para el documento PDF
    • Predeterminado: vacío
  • setCoverURL($value) - la URL de una página web que debe usarse como portada del PDF
    • Predeterminado: vacío
  • setMarginTop($value) - el margen en milímetros que debería aparecer en la parte superior de la página del documento PDF
    • Predeterminado: 10
  • setMarginLeft($value) - el margen en milímetros que debería aparecer a la izquierda de la página del documento PDF
    • Predeterminado: 10
  • setMarginBottom($value) - el margen en milímetros que debería aparecer en la parte inferior de la página del documento PDF
    • Predeterminado: 10
  • setMarginRight($value) - el margen en milímetros que debería aparecer a la derecha del documento PDF
    • Predeterminado: 10
  • setBrowserWidth($value) - el ancho del navegador en píxeles
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Predeterminado: 1024
    • Máxima: 10000
    • Ancho automático: -1 (pasar -1 significa que el ancho del navegador coincide con el ancho del documento PDF)
  • setPageWidth($value) - el ancho personalizado del PDF resultante en mm
  • setPageHeight($value) - el altura personalizada del PDF resultante en mm
  • setDelay($value) - el número de milisegundos a espera antes de tomar la captura de pantalla
    • Predeterminado: 0
    • Máxima: 30000
  • setRequestAs($value) - el tipo de agente de usuario que desea utilizar
    • Predeterminado: 0
    • Opciones:
      • 0 = indica que se debe usar el agente de usuario de un navegador estándar
      • 1 = indica que se debe usar el agente de usuario de un navegador móvil
      • 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
      • 3 = indica que se debe usar el agente de usuario de un navegador básico
  • setTemplateId($value) - Agrega un plantilla ID que especifica el encabezado y pie de página del documento PDF
    • Predeterminado: vacío
  • setTargetElement($value) - la identificación o clase Selector de CSS del único elemento HTML en la página web de destino que se va a convertir into PDF, todas las otras partes de la página web se ignoran. Si hay varios elementos HTML coincidentes, se elige el primero.
    • Predeterminado: vacío
  • setHideElement($value) - la identificación o clase Selectores CSS de uno o más elementos HTML en la página web para ocultar, para especificar múltiples elementos HTML para ocultar, separe cada selector con una coma
    • Predeterminado: vacío
  • setWaitForElement($value) - la identificación o clase Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
    • Predeterminado: vacío
  • setCustomWaterMarkId($value) - agregue una marca de agua personalizada a cada página del documento PDF
    • Predeterminado: vacío
  • setQuality($value) - el calidad del PDF devuelto. El valor predeterminado utiliza la calidad recomendada para un PDF.
    • Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
    • Predeterminado: -1
    • Mínimo: -1
    • Máxima: 100
  • setCountry($value) - el país la captura de pantalla debe tomarse de.
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Valor predeterminado: la ubicación más rápida actual
    • Opciones: "SG", "Reino Unido", "EE. UU."
  • setExportURL($value) - el exportar URL que especifica dónde se debe exportar la captura también
    • Predeterminado: vacío
  • setEncryptionKey($value) - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
    • Predeterminado: vacío
  • setNoAds($value) - si es verdad los anuncios deben ocultarse automáticamente.
    • Predeterminado: falso
  • setNoCookieNotifications($value) - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
    • Predeterminado: falso
  • setAddress($value) - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
    • Predeterminado: vacío
  • setProxy($value) - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
    • Predeterminado: vacío
  • setMergeId($value) - la identificación de una captura que debería ser fusionado al comienzo del nuevo documento PDF
    • Predeterminado: vacío
  • setPassword($value) - el contraseña para proteger el documento PDF con
    • Predeterminado: vacío

Métodos públicos

  • AddPostParameter ($ nombre, $ valor) - define un parámetro HTTP Post y, opcionalmente, un valor, este método se puede llamar varias veces para agregar múltiples parámetros. El uso de este método obligará a GrabzIt a realizar una publicación HTTP.
    • nombre: el nombre del parámetro HTTP Post
    • valor: el valor del parámetro HTTP Post
  • AddTemplateParameter ($ nombre, $ valor) - definir un plantilla personalizada parámetro y valor, este método se puede llamar varias veces para agregar múltiples parámetros.
    • nombre: el nombre del parámetro de plantilla
    • valor: el valor del parámetro de plantilla

URLToDOCX ($ url, $ opciones = nulo)

Especifica la URL que se debe convertir into DOCX.

parámetros

  • url: la URL a la que se debe convertir intoa DOCX
    • Requerido
  • opciones - una instancia de GrabzItDOCXOptions clase que define cualquier opción especial para usar al crear un DOCX.

Valor de retorno

vacío

HTMLToDOCX($ html, $ opciones = nulo)

Especifica el HTML que se debe convertir into DOCX.

parámetros

  • html - el HTML para convertir intoa DOCX
    • Requerido
  • opciones - una instancia de GrabzItDOCXOptions clase que define cualquier opción especial para usar al crear un DOCX.

Valor de retorno

vacío

FileToDOCX($ ruta, $ opciones = nulo)

Especifica un archivo HTML que debe convertirse into DOCX.

parámetros

  • ruta de acceso: la ruta del archivo HTML para convertir intoa DOCX
    • Requerido
  • opciones - una instancia de GrabzItDOCXOptions clase que define cualquier opción especial para usar al crear un DOCX.

Valor de retorno

vacío

GrabzItDOCXOptions

La clase representa todas las opciones disponibles al crear capturas DOCX.

Propiedades publicas

  • setCustomId($value) - un identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado.
    • Predeterminado: vacío
  • setIncludeBackground($value) - si es cierto, las imágenes de fondo de la página web deben incluirse en el DOCX
    • Predeterminado: verdadero
  • setPageSize($value) - el tamaño de página del DOCX
    • Valor predeterminado: "A4"
    • Opciones: "A3", "A4", "A5", "A6", "B3", "B4", "B5", "B6", "Legal", "Carta"
  • setOrientation($value) - la orientación del documento DOCX
    • Valor predeterminado: "Retrato"
    • Opciones: "Retrato", "Paisaje"
  • setIncludeLinks($value) - verdadero si los enlaces deben incluirse en el DOCX
    • Predeterminado: verdadero
  • setIncludeImages($value) - verdadero si las imágenes de la página web deben incluirse en el DOCX
    • Predeterminado: verdadero
  • setTitle($value) - proporcione un título para el documento DOCX
    • Predeterminado: vacío
  • setMarginTop($value) - el margen en milímetros que debería aparecer en la parte superior de la página del documento DOCX
    • Predeterminado: 10
  • setMarginLeft($value) - el margen en milímetros que debería aparecer a la izquierda de la página del documento DOCX
    • Predeterminado: 10
  • setMarginBottom($value) - el margen en milímetros que debería aparecer en la parte inferior de la página del documento DOCX
    • Predeterminado: 10
  • setMarginRight($value) - el margen en milímetros que debería aparecer a la derecha del documento DOCX
    • Predeterminado: 10
  • setBrowserWidth($value) - el ancho del navegador en píxeles
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Predeterminado: 1024
    • Máxima: 10000
    • Ancho automático: -1 (pasar -1 significa que el ancho del navegador coincide con el ancho del documento DOCX)
  • setPageWidth($value) - el ancho personalizado del DOCX resultante en mm
  • setPageHeight($value) - el altura personalizada del DOCX resultante en mm
  • setDelay($value) - el número de milisegundos a espera antes de tomar la captura de pantalla
    • Predeterminado: 0
    • Máxima: 30000
  • setRequestAs($value) - el tipo de agente de usuario que desea utilizar
    • Predeterminado: 0
    • Opciones:
      • 0 = indica que se debe usar el agente de usuario de un navegador estándar
      • 1 = indica que se debe usar el agente de usuario de un navegador móvil
      • 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
      • 3 = indica que se debe usar el agente de usuario de un navegador básico
  • setTemplateId($value) - Agrega un plantilla ID que especifica el encabezado y pie de página del documento DOCX
    • Predeterminado: vacío
  • setTargetElement($value) - la identificación o clase Selector de CSS del único elemento HTML en la página web de destino que se va a convertir into DOCX, todas las otras partes de la página web son ignoradas. Si hay varios elementos HTML coincidentes, se elige el primero.
    • Predeterminado: vacío
  • setHideElement($value) - la identificación o clase Selectores CSS de uno o más elementos HTML en la página web para ocultar, para especificar múltiples elementos HTML para ocultar, separe cada selector con una coma
    • Predeterminado: vacío
  • setWaitForElement($value) - la identificación o clase Selectores CSS del elemento HTML en la página web que debe ser visible antes de realizar la captura
    • Predeterminado: vacío
  • setQuality($value) - el calidad del DOCX devuelto. El valor predeterminado utiliza la calidad recomendada para un DOCX.
    • Reducir la calidad reducirá el tamaño del archivo y reducirá los tiempos de descarga.
    • Predeterminado: -1
    • Mínimo: -1
    • Máxima: 100
  • setCountry($value) - el país la captura de pantalla debe tomarse de.
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Valor predeterminado: la ubicación más rápida actual
    • Opciones: "SG", "Reino Unido", "EE. UU."
  • setExportURL($value) - el exportar URL que especifica dónde se debe exportar la captura también
    • Predeterminado: vacío
  • setEncryptionKey($value) - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
    • Predeterminado: vacío
  • setNoAds($value) - si es verdad los anuncios deben ocultarse automáticamente.
    • Predeterminado: falso
  • setNoCookieNotifications($value) - si es cierto, todos se encuentran comúnmente las notificaciones de cookies deben ocultarse automáticamente.
    • Predeterminado: falso
  • setAddress($value) - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
    • Predeterminado: vacío
  • setProxy($value) - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
    • Predeterminado: vacío
  • setMergeId($value) - la identificación de una captura que debería ser fusionado al comienzo del nuevo documento DOCX
    • Predeterminado: vacío
  • setPassword($value) - el contraseña para proteger el documento DOCX con
    • Predeterminado: vacío

Métodos públicos

  • AddPostParameter ($ nombre, $ valor) - define un parámetro HTTP Post y, opcionalmente, un valor, este método se puede llamar varias veces para agregar múltiples parámetros. El uso de este método obligará a GrabzIt a realizar una publicación HTTP.
    • nombre: el nombre del parámetro HTTP Post
    • valor: el valor del parámetro HTTP Post
  • AddTemplateParameter ($ nombre, $ valor) - definir un plantilla personalizada parámetro y valor, este método se puede llamar varias veces para agregar múltiples parámetros.
    • nombre: el nombre del parámetro de plantilla
    • valor: el valor del parámetro de plantilla

URLToTable($ url, $ opciones = nulo)

Especifica la URL de la que se deben extraer las tablas HTML.

parámetros

  • url: la URL para extraer tablas HTML de
    • Requerido
  • opciones - una instancia de GrabzItTableOptions clase que define cualquier opción especial para usar al convertir la tabla HTML.

Valor de retorno

vacío

HTMLToTable ($ html, $ opciones = nulo)

Especifica el HTML del que se deben extraer las tablas HTML.

parámetros

  • html: el HTML para extraer tablas HTML de.
    • Requerido
  • opciones - una instancia de GrabzItTableOptions clase que define cualquier opción especial para usar al convertir la tabla HTML.

Valor de retorno

vacío

FileToTable ($ ruta, $ opciones = nulo)

Especifica un archivo HTML del que se deben extraer las tablas HTML.

parámetros

  • ruta: la ruta del archivo HTML para extraer tablas HTML.
    • Requerido
  • opciones - una instancia de GrabzItTableOptions clase que define cualquier opción especial para usar al convertir la tabla HTML.

Valor de retorno

vacío

GrabzItTableOptions

La clase representa todas las opciones disponibles al convertir tablas HTML a CSV, XLSX o JSON.

Propiedades publicas

  • setCustomId($value) - un identificador personalizado que puede pasar al servicio web. Esto se devolverá con la URL de devolución de llamada que ha especificado
    • Predeterminado: vacío
  • setTableNumberToInclude($value) - el índice de la tabla que se convertirá, si todas las tablas de una página web se ordenan de arriba a abajo
    • Predeterminado: 1
  • setFormat($value) - el formato en que debe estar la tabla
    • Valor predeterminado: "csv"
    • Opciones: "csv", "json", "xlsx"
  • setIncludeHeaderNames($value) - si se incluirán nombres verdaderos de encabezado en la tabla
    • Predeterminado: verdadero
  • setIncludeAllTables($value) - si es verdadero, todas las tablas de la página web se extraerán y cada tabla aparecerá en una hoja de cálculo separada. Solo disponible con el formato XLSX
    • Predeterminado: falso
  • setTargetElement($value) - la identificación del único elemento HTML en la página web que debe usarse para extraer tablas de
    • Predeterminado: vacío
  • setRequestAs($value) - el tipo de agente de usuario que desea utilizar
    • Predeterminado: 0
    • Opciones:
      • 0 = indica que se debe usar el agente de usuario de un navegador estándar
      • 1 = indica que se debe usar el agente de usuario de un navegador móvil
      • 2 = indica que se debe usar el agente de usuario de un motor de búsqueda
      • 3 = indica que se debe usar el agente de usuario de un navegador básico
  • setCountry($value) - el país la captura de pantalla debe tomarse de.
    • Advertencia: esta característica está actualmente en versión beta y puede no proporcionar resultados consistentes.
    • Valor predeterminado: la ubicación más rápida actual
    • Opciones: "SG", "Reino Unido", "EE. UU."
  • setExportURL($value) - el exportar URL que especifica dónde se debe exportar la captura también
    • Predeterminado: vacío
  • setEncryptionKey($value) - si se especifica una clave de cifrado AES codificada con 64 base, su captura se cifra cuando se crea. Se recomienda usar el crear método de clave de cifrado para crear la clave y el descifrar métodos para descifrar la captura cifrada como se muestra en este ejemplo.
    • Predeterminado: vacío
  • setAddress($value) - la URL para ejecutar el código HTML. Puede ser útil si el HTML que se está convirtiendo usa URL relativas para recursos como CSS e imágenes.
    • Predeterminado: vacío
  • setProxy($value) - los detalles del proxy HTTP el software del navegador debe usar para crear esta captura
    • Predeterminado: vacío

Métodos públicos

  • AddPostParameter ($ nombre, $ valor) - define un parámetro HTTP Post y, opcionalmente, un valor, este método se puede llamar varias veces para agregar múltiples parámetros. El uso de este método obligará a GrabzIt a realizar una publicación HTTP.
    • nombre: el nombre del parámetro HTTP Post
    • valor: el valor del parámetro HTTP Post

Save($ callBackURL = nulo)

Save el resultado de forma asincrónica y devuelve un identificador único, que se puede utilizar para obtener la captura de pantalla con el GetResult método.

parámetros

  • callBackURL - el entrenador de animales el servicio GrabzIt debería llamar después de haber completado su trabajo

Valor de retorno

El identificador único de la captura de pantalla, de lo contrario, si se produce un error, se genera una excepción. Esto se puede usar para obtener la captura de pantalla con el GetResult Método


Advertencia: este método es sincrónico, por lo que hará que una aplicación se detenga mientras se procesa el resultado

SaveTo()

Save el resultado sincrónicamente a una variable que contiene los datos del byte de captura de pantalla.

Valor de retorno

devuelve los datos de bytes del archivo si tiene éxito; de lo contrario, arroja una excepción.


Advertencia: este método es sincrónico, por lo que hará que una aplicación se detenga mientras se procesa el resultado

SaveTo($saveArchivar)

Save el resultado sincrónicamente a un archivo.

parámetros

  • saveToFile: la ruta del archivo que capturará será saved una vez que se ha completado
    • Requerido

Valor de retorno

devuelve el verdadero si tiene éxito; de lo contrario, arroja una excepción.


GetStatus ($ id)

Obtenga el estado actual de una captura de pantalla de GrabzIt.

parámetros

  • id: el identificador único de la captura de pantalla
    • Requerido

Valor de retorno

GrabzItStatus objeto


GetCookies ($ dominio)

Obtenga todas las cookies que GrabzIt está utilizando para un dominio en particular. Esto también puede incluir cookies definidas por el usuario.

parámetros

  • dominio: el dominio para devolver cookies
    • Requerido

Valor de retorno

GrabzItCookie matriz


SetCookie ($ name, $ domain, $ value = "", $ path = "/", $ httponly = false, $ expires = "")

Establece una nueva cookie personalizada en GrabzIt, si la cookie personalizada tiene el mismo nombre y dominio que una cookie global, la cookie global se anula.

Esto puede ser útil si la funcionalidad de un sitio web está controlada por cookies.

parámetros

  • nombre: el nombre de la cookie para establecer
    • Requerido
  • dominio: el dominio del sitio web para configurar la cookie
    • Requerido
  • valor - el valor de la cookie
  • ruta: la ruta del sitio web con la que se relaciona la cookie
  • httponly: si es verdadero, la cookie solo se puede usar con el protocolo HTTP
  • caduca: define cuándo caduca la cookie. Pase un valor nulo si la cookie no caduca
    • Debe tener el formato aaaa-mm-dd hh: mm: ss

Valor de retorno

Verdadero si la cookie se ha configurado correctamente; de ​​lo contrario, falso


DeleteCookie ($ nombre, $ dominio)

Eliminar una cookie personalizada o bloquear el uso de una cookie global

parámetros

  • nombre: el nombre de la cookie a eliminar
    • Requerido
  • dominio: el dominio del sitio web para eliminar la cookie
    • Requerido

Valor de retorno

Verdadero si la cookie se elimina correctamente; de ​​lo contrario, falso


GetWaterMarks()

Obtenga sus marcas de agua personalizadas cargadas

Valor de retorno

GrabzItWaterMark matriz


GetWaterMark($ identificador)

Devuelva sus marcas de agua personalizadas que coincidan con el identificador especificado

parámetros

  • identificador: el identificador de una marca de agua personalizada particular que desea ver
    • Requerido

Valor de retorno

GrabzItWaterMark


AñadirWaterMark($ identificador, $ ruta, $ xpos, $ ypos)

Agregar una nueva marca de agua personalizada

parámetros

  • identificador: el identificador que desea dar a la marca de agua personalizada. Es importante que este identificador sea único.
    • Requerido
  • ruta: la ruta absoluta de la marca de agua en su servidor. Por ejemplo C: /watermark/1.png
    • Requerido
  • xpos: la posición horizontal en la que desea que aparezca la captura de pantalla
    • Requerido
    • Opciones:
      • Izquierda = 0
      • Centro = 1
      • Derecha = 2
  • ypos: posición vertical en la que desea que aparezca la captura de pantalla
    • Requerido
    • Opciones:
      • Arriba = 0
      • Medio = 1
      • Inferior = 2

Valor de retorno

devuelve verdadero si la marca de agua se estableció correctamente


DeleteWaterMark($ identificador)

Eliminar una marca de agua personalizada

parámetros

  • identificador: el identificador de la marca de agua personalizada que desea eliminar
    • Requerido

Valor de retorno

devuelve verdadero si la marca de agua se eliminó con éxito


SetLocalProxy ($ proxyUrl)

Este método permite un servidor proxy local para ser utilizado para todas las solicitudes.

parámetros

  • proxyUrl: la URL, que puede incluir un puerto si es necesario, del proxy. Proporcionar un valor nulo eliminará cualquier proxy establecido previamente
    • Requerido

UseSSL ($ valor)

Especifica si las solicitudes a GrabzIt's API debe usar SSL o no

parámetros

  • valor: si es verdadero, todas las solicitudes a la API de GrabzIt utilizarán SSL
    • Requerido

CreateEncryptionKey ()

Cree una clave de cifrado 64 base criptográficamente segura, con caracteres 44 largos.


Descifrar ($ datos, $ clave)

Descifre una captura cifrada utilizando la clave de cifrado proporcionada.

parámetros


DecryptFile ($ ruta, $ clave)

Descifre una captura cifrada utilizando la clave de cifrado proporcionada.

parámetros


Clases de resultados

GrabzItCookie

Propiedades publicas

  • Nombre
    • El nombre de la cookie.
  • Valor
    • El valor de la cookie.
  • Dominio
    • El dominio para el que está configurada la cookie.
  • Camino
    • La ruta en el dominio al que se aplica esta cookie.
  • HttpOnly
    • Si esta cookie solo es válida cuando el sitio web se visualiza con el protocolo HTTP.
  • Expira
    • La fecha de caducidad de esta cookie.
  • Tipo
    • El tipo de cookie es este, que puede ser uno de los siguientes:
      • Global: esta es una cookie global establecida por GrabzIt
      • Local: esta es una cookie local establecida por usted
      • Anulada: una cookie global que usted ha anulado

GrabzItStatus

La clase que representa el estado actual de la captura de pantalla.

Propiedades publicas

  • Processing
    • Si es cierto, la captura de pantalla aún se está procesando.
  • Cached
    • Si es verdadero, la captura de pantalla se ha procesado y actualmente está en caché.
  • Expired
    • Si es cierto, la captura de pantalla ya no está en el sistema GrabzIt.
  • Message
    • Un mensaje de error devuelto por el sistema.

GrabzItWaterMark

Esta clase representa las marcas de agua personalizadas almacenadas en GrabzIt

Propiedades publicas

  • Identificador
    • El identificador de la marca de agua.
  • XPosition
    • La posición horizontal de la marca de agua.
      • Izquierda = 0
      • Centro = 1
      • Derecha = 2
  • Posición
    • La posición vertical de la marca de agua.
      • Arriba = 0
      • Medio = 1
      • Inferior = 2
  • Formato
    • El formato de la marca de agua.