وصف المنتج
يعالج هذا الفصل كل الاتصالات مع خدمات الويب GrabzIt screenshot.
الطرق العامة
- GetResult($id)
- URLToAnimation($url, $options = null)
- URLToImage($url, $options = null)
- HTMLToImage($html, $options = null)
- FileToImage($path, $options = null)
- URLToPDF($url, $options = null)
- HTMLToPDF($html, $options = null)
- FileToPDF($path, $options = null)
- URLToDOCX($url, $options = null)
- HTMLToDOCX($html, $options = null)
- FileToDOCX($path, $options = null)
- URLToTable($url, $options = null)
- HTMLToTable($html, $options = null)
- FileToTable($path, $options = null)
- URLToRenderedHTML($url, $options = null)
- HTMLToRenderedHTML($html, $options = null)
- FileToRenderedHTML($path, $options = null)
- Save($callBackURL = null)
- SaveTo()
- SaveTo($saveToFile)
- GetStatus($id)
- GetCookies($domain)
- SetCookie($name, $domain, $value = "", $path = "/", $httponly = false, $expires = "")
- DeleteCookie($name, $domain)
- GetWaterMarks()
- GetWaterMark($identifier)
- AddWaterMark($identifier, $path, $xpos, $ypos)
- DeleteWaterMark($identifier)
- SetLocalProxy($proxyUrl)
- UseSSL($value)
- CreateEncryptionKey()
- Decrypt($path, $key)
- DecryptFile($path, $key)
GetResult($ معرف)
هذه الطريقة تقوم بإرجاع لقطة الشاشة نفسها. إذا لم يتم إرجاع أي شيء ، فقد حدث خطأ ما أو أن لقطة الشاشة ليست جاهزة بعد.
المعلمات
-
معرف - المعرف الفريد للشاشة
قيمة الإرجاع
القبض
URLToAnimation($ رابط، خيارات $ = فارغة)
حدد عنوان URL للفيديو عبر الإنترنت الذي يجب تحويله intيا المتحركة GIF.
المعلمات
-
عنوان url - عنوان URL لتحويل الفيديو عبر الإنترنت intس المتحركة GIF.
- مطلوب:
-
يقبل عنوان URL لفيديو Vimeo و YouTube
- يعتمد تحذير تنشيط مقاطع فيديو Vimeo و YouTube على جهة خارجية وبالتالي قد لا يوفر نتائج متسقة.
- الخيارات - مثيل ل GrabzItAnimationOptions فئة تحدد أي خيارات خاصة لاستخدامها عند إنشاء صورة GIF متحركة.
قيمة الإرجاع
باطل
GrabzItAnimationOptions
يمثل الفصل جميع الخيارات المتاحة عند إنشاء صورة GIF متحركة.
ممتلكات عامة
-
setCustomId($value) - معرف مخصص يمكنك تمريره إلى خدمة الويب GIF المتحركة. سيتم إرجاع ذلك بعنوان URL الخاص بالرد الذي حددته.
-
setWidth($value) - عرض GIF المتحركة الناتجة بالبكسل.
- الافتراضي: 180px
- الحد الأقصى: أقصى عرض للحزمة
- الحجم التلقائي: -1 (تمرير -1 يعني أن عرض يتم تحجيم GIF المتحركة فيما يتعلق بارتفاعه ، إذا كان حجم العرض تلقائيًا ، فلن يتمكن الارتفاع من ذلك)
-
setHeight($value) - ارتفاع GIF المتحركة الناتجة بالبكسل.
- الافتراضي: 120px
- الحد الأقصى: أقصى ارتفاع للحزمة
- الحجم التلقائي: -1 (تمرير -1 يعني أن ارتفاع يتم تحجيم GIF المتحركة فيما يتعلق بعرضه ، إذا كان الارتفاع يتم تلقائيًا ، فلا يمكن للعرض)
-
setStart($value) - موضع بدء الفيديو الذي يجب تحويله intيا المتحركة GIF.
-
setDuration($value) - طول ثواني الفيديو التي يجب تحويلها intيا المتحركة GIF.
- الافتراضي: الحد الأقصى لطول الحزمة
-
setSpeed($value) - سرعة GIF المتحركة.
- الافتراضي: 1
- الحد الأدنى: 0.2
- الحد الأقصى: 10
-
setFramesPerSecond($value) - عدد الإطارات في الثانية التي يجب التقاطها من الفيديو.
- الافتراضي: 10
- الحد الأدنى: 0.2
- الحد الأقصى: 60
-
setRepeat($value) - عدد مرات تكرار حلقة GIF المتحركة.
- الافتراضي: 0
- حلقة مستمرة: 0
- أبدا التكرار: -1
-
setReverse($value) - إذا كان هذا صحيحًا ، يتم عكس إطارات GIF المتحركة
-
setCustomWaterMarkId($value) - اضافة العرف watermark إلى GIF المتحركة
-
setQuality($value) - ال جودة الصورة التي تم إرجاعهاالذي يحتوي على ضغط افتراضي قدره 85٪.
- إن تقليل الجودة سيقلل حجم الملف ويقلل أوقات التنزيل.
- الافتراضي: -1
- الحد الأدنى: -1
- الحد الأقصى: 100
-
setCountry($value) - البلد GIF المتحركة يجب أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
-
setExportURL($value) - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا
-
setEncryptionKey($value) - إذا تم تحديد مفتاح التشفير AES المشفر 64 الأساسي ، يتم تشفير الالتقاط عند إنشائه. فمن المستحسن استخدام إنشاء طريقة مفتاح التشفير لإنشاء المفتاح و فك تشفير الطرق لفك تشفير الالتقاط المشفر كما هو موضح في هذا المثال.
-
setProxy($value) - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
URLToImage($ رابط، خيارات $ = فارغة)
يحدد عنوان URL الذي يجب تحويله intيا صورة لقطة للشاشة.
المعلمات
-
عنوان url - عنوان URL الذي يجب أن تكون لقطة الشاشة منه
- الخيارات - مثيل ل GrabzItImageOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء لقطة الشاشة.
قيمة الإرجاع
باطل
HTMLToImage($ أتش تي أم أل، خيارات $ = فارغة)
يحدد HTML الذي يجب تحويله intيا صورة.
المعلمات
-
أتش تي أم أل - HTML لتحويل intيا صورة
- الخيارات - مثيل ل GrabzItImageOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء صورة.
قيمة الإرجاع
باطل
FileToImage($ المسار، خيارات $ = فارغة)
يحدد ملف HTML الذي يجب تحويله intيا صورة.
المعلمات
-
المسار - مسار ملف ملف HTML لتحويله intيا صورة
- الخيارات - مثيل ل GrabzItImageOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء صورة.
قيمة الإرجاع
باطل
GrabzItImageOptions
يمثل الفصل جميع الخيارات المتاحة عند إنشاء التقاطات للصورة.
ممتلكات عامة
-
setCustomId($value) - معرف مخصص يمكنك نقله إلى لقطة شاشة webservice. سيتم إرجاع ذلك بعنوان URL الخاص بالرد الذي حددته.
-
setBrowserWidth($value) - عرض المتصفح بالبكسل
- الافتراضي: 1366
- الحد الأقصى: 10000
-
setBrowserHeight($value) - ارتفاع المتصفح بالبكسل
- الافتراضي: 1170
- الحد الأقصى: 10000
- الطول الكامل: -1 (تمرير -1 يعني أنه تم التقاط صورة نصية لصفحة الويب بالكامل)
-
setWidth($value) - عرض الصورة المصغرة الناتجة بالبكسل
- الافتراضي: إذا لم يتم تحديد كل من عرض الإخراج وارتفاع الإخراج أو 0 ، فسيتم مطابقة عرض وارتفاع الإخراج مع عرض الصورة النهائية وارتفاعها ، إذا تم تحديد ارتفاع الإخراج ، فسيكون عرض الإخراج متناسبًا مع ارتفاع الإخراج
- الحد الأقصى: أقصى عرض للحزمة
- العرض الكامل: -1 (تمرير -1 يعني أنه لا يتم تقليل عرض الصورة المصغرة)
-
setHeight($value) - ارتفاع الصورة المصغرة الناتجة بالبكسل
- الافتراضي: إذا لم يتم تحديد كل من عرض الإخراج وارتفاع الإخراج أو 0 ، فسيتم مطابقة عرض وارتفاع الإخراج مع عرض الصورة النهائية وارتفاعها ، إذا تم تحديد عرض الإخراج ، فسيكون ارتفاع الإخراج متناسبًا مع عرض الإخراج
- الحد الأقصى: أقصى ارتفاع للحزمة
- الطول الكامل: -1 (تمرير -1 يعني أنه لا يتم تقليل ارتفاع الصورة المصغرة)
-
setFormat($value) - الشكل الذي يجب أن تكون عليه لقطة الشاشة.
- الافتراضي: "jpg"
- الخيارات: "bmp8" ، "bmp16" ، "bmp24" ، "bmp" ، "tiff" ، "webp" ، "jpg" ، "png"
-
setDelay($value) - عدد المللي ثانية إلى انتظر قبل التقاط لقطة الشاشة
- الافتراضي: 0
- الحد الأقصى: 30000
-
setClickElement($value) - هذا يحدد عنصر HTML ، باستخدام ملف محدد CSS للنقر. تذكر أن التأخير قد يكون مطلوبًا أيضًا لعرض تأثيرات النقرة
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
-
setTargetElement($value) - ال محدد CSS من عنصر HTML الوحيد على صفحة الويب المستهدفة المراد تشغيلها intoa لقطة شاشة ، يتم تجاهل جميع الأجزاء الأخرى من صفحة الويب. إذا كان هناك عناصر HTML مطابقة متعددة يتم اختيار أول عنصر
-
setHideElement($value) - ال محددات CSS واحد أو أكثر من عناصر HTML في صفحة الويب المراد إخفاؤها ، لتحديد عناصر HTML متعددة لإخفاء فصل كل محدد بفاصلة
-
setWaitForElement($value) - ال محددات CSS من عنصر HTML في صفحة الويب التي يجب أن تكون مرئية قبل تنفيذ الالتقاط
-
setRequestAs($value) - نوع وكيل المستخدم الذي ترغب في استخدامه
- الافتراضي: 0
-
خيارات:
- 0 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح قياسي
- 1 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح الجوال
- 2 = يشير إلى أنه يجب استخدام وكيل المستخدم لمحرك البحث
-
setCustomWaterMarkId($value) - إضافة العرف watermark على الصورة
-
setQuality($value) - ال جودة الصورة التي تم إرجاعها. لا يؤثر هذا حاليًا إلا على صور JPG و WEBP ، والتي لها ضغط افتراضي بنسبة 90٪.
- إن تقليل الجودة سيقلل حجم الملف ويقلل أوقات التنزيل.
- الافتراضي: -1
- الحد الأدنى: -1
- الحد الأقصى: 100
-
setTransparent($value) - إذا كان صحيحا يجب أن يكون التقاط الصور شفافًا. هذا متوافق فقط مع صور بابوا نيو غينيا وتيف.
-
setHD($value) - إذا كانت الصورة حقيقية سوف يكون التقاط في عالية الوضوح هذا يضاعف حجم أبعاد الصورة.
-
setCountry($value) - البلد لقطة ينبغي أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
-
setExportURL($value) - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا
-
setEncryptionKey($value) - إذا تم تحديد مفتاح التشفير AES المشفر 64 الأساسي ، يتم تشفير الالتقاط عند إنشائه. فمن المستحسن استخدام إنشاء طريقة مفتاح التشفير لإنشاء المفتاح و فك تشفير الطرق لفك تشفير الالتقاط المشفر كما هو موضح في هذا المثال.
-
setNoAds($value) - إذا كان هذا صحيحا يجب أن تكون الإعلانات مخفية تلقائيًا.
-
setNoCookieNotifications($value) - إذا كان هذا صحيحا كل شيء شائع يجب أن تكون إعلامات ملفات تعريف الارتباط مخفية تلقائيًا.
-
setAddress($value) - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا في حالة استخدام HTML الجاري تحويله عناوين URL النسبية لموارد مثل CSS والصور.
-
setProxy($value) - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
الطرق العامة
-
AddPostParameter ($ name ، $ value) - يحدد معلمة HTTP Post والقيمة الاختيارية ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة. باستخدام هذه الطريقة سوف يجبر GrabzIt ل أداء وظيفة HTTP.
- الاسم - اسم المعلمة HTTP Post
- القيمة - قيمة المعلمة HTTP Post
URLToRenderedHTML($ رابط، خيارات $ = فارغة)
يحدد عنوان URL الذي يجب تحويله intس المقدمة HTML.
المعلمات
-
عنوان url - عنوان URL الذي يجب أن يتكون منه HTML
- الخيارات - مثيل ل GrabzItHTMLOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء HTML المقدم.
قيمة الإرجاع
باطل
HTMLToRenderedHTML($ أتش تي أم أل، خيارات $ = فارغة)
يحدد HTML الذي يجب تحويله intس المقدمة HTML.
المعلمات
-
أتش تي أم أل - HTML لتحويل intس المقدمة HTML
- الخيارات - مثيل ل GrabzItHTMLOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء HTML المقدمة.
قيمة الإرجاع
باطل
FileToRenderedHTML($ المسار، خيارات $ = فارغة)
يحدد ملف HTML الذي يجب تحويله intس المقدمة HTML.
المعلمات
-
المسار - مسار ملف ملف HTML لتحويله intس المقدمة HTML
- الخيارات - مثيل ل GrabzItHTMLOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء HTML المقدمة.
قيمة الإرجاع
باطل
GrabzItHTMLOptions
يمثل الفصل جميع الخيارات المتاحة عند خلق يلتقط HTML المقدمة.
ممتلكات عامة
-
setCustomId($value) - معرف مخصص يمكنك تمريره إلى خدمة الويب. سيتم إرجاع ذلك بعنوان URL الخاص بالرد الذي حددته.
-
setBrowserWidth($value) - عرض المتصفح بالبكسل
- الافتراضي: 1366
- الحد الأقصى: 10000
-
setBrowserHeight($value) - ارتفاع المتصفح بالبكسل
- الافتراضي: 1170
- الحد الأقصى: 10000
-
setDelay($value) - عدد المللي ثانية إلى انتظر قبل التقاط الصورة
- الافتراضي: 0
- الحد الأقصى: 30000
-
setWaitForElement($value) - ال محددات CSS من عنصر HTML في صفحة الويب التي يجب أن تكون مرئية قبل تنفيذ الالتقاط
-
setRequestAs($value) - نوع وكيل المستخدم الذي ترغب في استخدامه
- الافتراضي: 0
-
خيارات:
- 0 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح قياسي
- 1 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح الجوال
- 2 = يشير إلى أنه يجب استخدام وكيل المستخدم لمحرك البحث
-
setCountry($value) - البلد لقطة ينبغي أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
-
setExportURL($value) - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا
-
setEncryptionKey($value) - إذا تم تحديد مفتاح التشفير AES المشفر 64 الأساسي ، يتم تشفير الالتقاط عند إنشائه. فمن المستحسن استخدام إنشاء طريقة مفتاح التشفير لإنشاء المفتاح و فك تشفير الطرق لفك تشفير الالتقاط المشفر كما هو موضح في هذا المثال.
-
setNoAds($value) - إذا كان هذا صحيحا يجب أن تكون الإعلانات مخفية تلقائيًا.
-
setNoCookieNotifications($value) - إذا كان هذا صحيحا كل شيء شائع يجب أن تكون إعلامات ملفات تعريف الارتباط مخفية تلقائيًا.
-
setAddress($value) - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا في حالة استخدام HTML الجاري تحويله عناوين URL النسبية لموارد مثل CSS والصور.
-
setProxy($value) - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
الطرق العامة
-
AddPostParameter ($ name ، $ value) - يحدد معلمة HTTP Post والقيمة الاختيارية ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة. باستخدام هذه الطريقة سوف يجبر GrabzIt ل أداء وظيفة HTTP.
- الاسم - اسم المعلمة HTTP Post
- القيمة - قيمة المعلمة HTTP Post
URLToPDF($ رابط، خيارات $ = فارغة)
يحدد عنوان URL الذي يجب تحويله intيا قوات الدفاع الشعبي.
المعلمات
-
عنوان url - عنوان URL الذي يجب تحويله intيا قوات الدفاع الشعبي
- الخيارات - مثيل لفئة GrabzItPDFOptions التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء PDF.
قيمة الإرجاع
باطل
HTMLToPDF($ أتش تي أم أل، خيارات $ = فارغة)
يحدد HTML الذي يجب تحويله intيا قوات الدفاع الشعبي.
المعلمات
-
أتش تي أم أل - HTML لتحويل intيا قوات الدفاع الشعبي
- الخيارات - مثيل لفئة GrabzItPDFOptions التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء PDF.
قيمة الإرجاع
باطل
FileToPDF($ المسار، خيارات $ = فارغة)
يحدد ملف HTML الذي يجب تحويله intيا قوات الدفاع الشعبي.
المعلمات
-
المسار - مسار ملف ملف HTML لتحويله intيا قوات الدفاع الشعبي
- الخيارات - مثيل لفئة GrabzItPDFOptions التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء PDF.
قيمة الإرجاع
باطل
GrabzItPDFOptions
يمثل الفصل جميع الخيارات المتاحة عند إنشاء ملفات PDF.
ممتلكات عامة
-
setCustomId($value) - معرف مخصص يمكنك نقله إلى خدمة الويب. سيتم إرجاع ذلك بعنوان URL الخاص بالرد الذي حددته.
-
setIncludeBackground($value) - إذا كان هذا صحيحًا ، يجب تضمين خلفية صفحة الويب في لقطة الشاشة
-
setPageSize($value) - حجم صفحة PDF
- الافتراضي: "A4"
- الخيارات: "A3" ، "A4" ، "A5" ، "A6" ، "B3" ، "B4" ، "B5" ، "B6" ، "قانوني" ، "خطاب"
-
setOrientation($value) - اتجاه وثيقة PDF
- الافتراضي: "عمودي"
- خيارات: "بورتريه" ، "أفقي"
-
setCSSMediaType($value) - ال CSS Media نوع مستند PDF
- الشاشة الافتراضية"
- خيارات: "الشاشة" ، "العلاقات العامةint"
-
setIncludeLinks($value) - صحيح إذا كانت الروابط يجب أن تدرج في PDF
-
setIncludeOutline($value) - صحيح إذا قوات الدفاع الشعبي الإشارات المرجعية ينبغي أن تدرج
-
setTitle($value) - تقديم عنوان لمستند PDF
-
setCoverURL($value) - عنوان URL لصفحة الويب التي يجب استخدامها كصفحة غلاف لملف PDF
-
setMarginTop($value) - الهامش بالمليمترات التي يجب أن تظهر في الجزء العلوي من صفحة وثيقة PDF
-
setMarginLeft($value) - الهامش بالمليمترات التي يجب أن تظهر على يسار صفحة مستند PDF
-
setMarginBottom($value) - الهامش بالمليمترات التي يجب أن تظهر في أسفل صفحة وثيقة PDF
-
setMarginRight($value) - الهامش بالمليمترات التي يجب أن تظهر على يمين مستند PDF
-
setBrowserWidth($value) - ال عرض المتصفح بالبكسل
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
- الافتراضي: 1366
- الحد الأقصى: 10000
- العرض التلقائي: -1 (تمرير -1 يعني أن عرض المستعرض يطابق عرض مستند PDF)
-
setPageWidth($value) - ال عرض مخصص لملف PDF الناتج في ملم
-
setPageHeight($value) - ال ارتفاع مخصص لقوات الدفاع الشعبي الناتجة في ملم
-
setDelay($value) - عدد المللي ثانية إلى انتظر قبل التقاط لقطة الشاشة
- الافتراضي: 0
- الحد الأقصى: 30000
-
setRequestAs($value) - نوع وكيل المستخدم الذي ترغب في استخدامه
- الافتراضي: 0
-
خيارات:
- 0 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح قياسي
- 1 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح الجوال
- 2 = يشير إلى أنه يجب استخدام وكيل المستخدم لمحرك البحث
-
setTemplateId($value) - أضف قالب المعرف الذي يحدد رأس وتذييل مستند PDF
-
setClickElement($value) - هذا يحدد عنصر HTML ، باستخدام ملف محدد CSS للنقر. تذكر أن التأخير قد يكون مطلوبًا أيضًا لعرض تأثيرات النقرة
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
-
setTargetElement($value) - ال محدد CSS من فقط عنصر HTML في صفحة الويب الهدف التي سيتم تشغيلها intيا قوات الدفاع الشعبي، يتم تجاهل جميع الأجزاء الأخرى من صفحة الويب. إذا كان هناك عناصر HTML مطابقة متعددة يتم اختيار أول عنصر
-
setHideElement($value) - ال محددات CSS واحد أو أكثر من عناصر HTML في صفحة الويب المراد إخفاؤها ، لتحديد عناصر HTML متعددة لإخفاء فصل كل محدد بفاصلة
-
setWaitForElement($value) - ال محددات CSS من عنصر HTML في صفحة الويب التي يجب أن تكون مرئية قبل تنفيذ الالتقاط
-
setCustomWaterMarkId($value) - إضافة العرف watermark لكل صفحة من صفحات وثيقة PDF
-
setQuality($value) - ال جودة PDF عاد. يستخدم الإعداد الافتراضي الجودة الموصى بها لملف PDF.
- إن تقليل الجودة سيقلل حجم الملف ويقلل أوقات التنزيل.
- الافتراضي: -1
- الحد الأدنى: -1
- الحد الأقصى: 100
-
setCountry($value) - البلد لقطة ينبغي أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
-
setExportURL($value) - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا
-
setEncryptionKey($value) - إذا تم تحديد مفتاح التشفير AES المشفر 64 الأساسي ، يتم تشفير الالتقاط عند إنشائه. فمن المستحسن استخدام إنشاء طريقة مفتاح التشفير لإنشاء المفتاح و فك تشفير الطرق لفك تشفير الالتقاط المشفر كما هو موضح في هذا المثال.
-
setNoAds($value) - إذا كان هذا صحيحا يجب أن تكون الإعلانات مخفية تلقائيًا.
-
setNoCookieNotifications($value) - إذا كان هذا صحيحا كل شيء شائع يجب أن تكون إعلامات ملفات تعريف الارتباط مخفية تلقائيًا.
-
setAddress($value) - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا في حالة استخدام HTML الجاري تحويله عناوين URL النسبية لموارد مثل CSS والصور.
-
setProxy($value) - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
-
setMergeId($value) - معرف الالتقاط الذي يجب أن يكون دمجها في بداية وثيقة PDF الجديدة
-
setPassword($value) - ال كلمة مرور لحماية وثيقة PDF دوامة
الطرق العامة
-
AddPostParameter ($ name ، $ value) - يحدد معلمة HTTP Post والقيمة الاختيارية ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة. باستخدام هذه الطريقة سوف يجبر GrabzIt ل أداء وظيفة HTTP.
- الاسم - اسم المعلمة HTTP Post
- القيمة - قيمة المعلمة HTTP Post
-
AddTemplateParameter ($ name ، $ value) - تحديد قالب مخصص المعلمة والقيمة ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة.
- اسم - اسم المعلمة قالب
- القيمة - قيمة المعلمة القالب
URLToDOCX ($ رابط، خيارات $ = فارغة)
يحدد عنوان URL الذي يجب تحويله intيا DOCX.
المعلمات
-
عنوان url - عنوان URL الذي يجب تحويله intيا DOCX
- الخيارات - مثيل ل GrabzItDOCXOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء DOCX.
قيمة الإرجاع
باطل
HTMLToDOCX($ أتش تي أم أل، خيارات $ = فارغة)
يحدد HTML الذي يجب تحويله intيا DOCX.
المعلمات
-
أتش تي أم أل - HTML لتحويل intيا DOCX
- الخيارات - مثيل ل GrabzItDOCXOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء DOCX.
قيمة الإرجاع
باطل
FileToDOCX($ المسار، خيارات $ = فارغة)
يحدد ملف HTML الذي يجب تحويله intيا DOCX.
المعلمات
-
المسار - مسار ملف ملف HTML لتحويله intيا DOCX
- الخيارات - مثيل ل GrabzItDOCXOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند إنشاء DOCX.
قيمة الإرجاع
باطل
GrabzItDOCXOptions
يمثل الفصل جميع الخيارات المتاحة عند إنشاء التقاط DOCX.
ممتلكات عامة
-
setCustomId($value) - معرف مخصص يمكنك نقله إلى خدمة الويب. سيتم إرجاع ذلك بعنوان URL الخاص بالرد الذي حددته.
-
setIncludeBackground($value) - إذا كان هذا صحيحًا ، يجب تضمين الصور الخلفية لصفحة الويب في DOCX
-
setPageSize($value) - حجم صفحة DOCX
- الافتراضي: "A4"
- الخيارات: "A3" ، "A4" ، "A5" ، "A6" ، "B3" ، "B4" ، "B5" ، "B6" ، "قانوني" ، "خطاب"
-
setOrientation($value) - اتجاه وثيقة DOCX
- الافتراضي: "عمودي"
- خيارات: "بورتريه" ، "أفقي"
-
setIncludeLinks($value) - صحيح إذا كانت الروابط يجب أن تدرج في DOCX
-
setIncludeImages($value) - صحيح إذا كانت صور صفحة الويب يجب أن تدرج في DOCX
-
setTitle($value) - تقديم عنوان لوثيقة DOCX
-
setMarginTop($value) - الهامش بالمليمترات التي يجب أن تظهر في أعلى صفحة مستند DOCX
-
setMarginLeft($value) - الهامش بالمليمترات التي يجب أن تظهر على يسار صفحة مستند DOCX
-
setMarginBottom($value) - الهامش بالمليمترات التي يجب أن تظهر في أسفل صفحة مستند DOCX
-
setMarginRight($value) - الهامش بالمليمترات التي يجب أن تظهر على يمين مستند DOCX
-
setBrowserWidth($value) - ال عرض المتصفح بالبكسل
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
- الافتراضي: 1366
- الحد الأقصى: 10000
- العرض التلقائي: -1 (تمرير -1 يعني أن عرض المستعرض يطابق عرض مستند DOCX)
-
setPageWidth($value) - ال عرض مخصص لل DOCX الناتجة في ملم
-
setPageHeight($value) - ال ارتفاع مخصص لل DOCX الناتجة في ملم
-
setDelay($value) - عدد المللي ثانية إلى انتظر قبل التقاط لقطة الشاشة
- الافتراضي: 0
- الحد الأقصى: 30000
-
setRequestAs($value) - نوع وكيل المستخدم الذي ترغب في استخدامه
- الافتراضي: 0
-
خيارات:
- 0 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح قياسي
- 1 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح الجوال
- 2 = يشير إلى أنه يجب استخدام وكيل المستخدم لمحرك البحث
-
setTemplateId($value) - أضف قالب المعرف الذي يحدد رأس وتذييل مستند DOCX
-
setClickElement($value) - هذا يحدد عنصر HTML ، باستخدام ملف محدد CSS للنقر. تذكر أن التأخير قد يكون مطلوبًا أيضًا لعرض تأثيرات النقرة
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
-
setTargetElement($value) - ال محدد CSS من عنصر HTML الوحيد على صفحة الويب المستهدفة المراد تشغيلها intيا DOCX ، يتم تجاهل جميع الأجزاء الأخرى من صفحة الويب. إذا كان هناك عناصر HTML مطابقة متعددة يتم اختيار أول عنصر
-
setHideElement($value) - ال محددات CSS واحد أو أكثر من عناصر HTML في صفحة الويب المراد إخفاؤها ، لتحديد عناصر HTML متعددة لإخفاء فصل كل محدد بفاصلة
-
setWaitForElement($value) - ال محددات CSS من عنصر HTML في صفحة الويب التي يجب أن تكون مرئية قبل تنفيذ الالتقاط
-
setQuality($value) - ال جودة DOCX عاد. الافتراضي يستخدم الجودة الموصى بها ل DOCX.
- إن تقليل الجودة سيقلل حجم الملف ويقلل أوقات التنزيل.
- الافتراضي: -1
- الحد الأدنى: -1
- الحد الأقصى: 100
-
setCountry($value) - البلد لقطة ينبغي أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
-
setExportURL($value) - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا
-
setEncryptionKey($value) - إذا تم تحديد مفتاح التشفير AES المشفر 64 الأساسي ، يتم تشفير الالتقاط عند إنشائه. فمن المستحسن استخدام إنشاء طريقة مفتاح التشفير لإنشاء المفتاح و فك تشفير الطرق لفك تشفير الالتقاط المشفر كما هو موضح في هذا المثال.
-
setNoAds($value) - إذا كان هذا صحيحا يجب أن تكون الإعلانات مخفية تلقائيًا.
-
setNoCookieNotifications($value) - إذا كان هذا صحيحا كل شيء شائع يجب أن تكون إعلامات ملفات تعريف الارتباط مخفية تلقائيًا.
-
setAddress($value) - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا في حالة استخدام HTML الجاري تحويله عناوين URL النسبية لموارد مثل CSS والصور.
-
setProxy($value) - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
-
setMergeId($value) - معرف الالتقاط الذي يجب أن يكون دمجها في بداية وثيقة DOCX الجديدة
-
setPassword($value) - ال كلمة المرور لحماية وثيقة DOCX دوامة
الطرق العامة
-
AddPostParameter ($ name ، $ value) - يحدد معلمة HTTP Post والقيمة الاختيارية ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة. باستخدام هذه الطريقة سوف يجبر GrabzIt ل أداء وظيفة HTTP.
- الاسم - اسم المعلمة HTTP Post
- القيمة - قيمة المعلمة HTTP Post
-
AddTemplateParameter ($ name ، $ value) - تحديد قالب مخصص المعلمة والقيمة ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة.
- اسم - اسم المعلمة قالب
- القيمة - قيمة المعلمة القالب
URLToTable($ رابط، خيارات $ = فارغة)
يحدد عنوان URL الذي يجب استخراج جداول HTML منه.
المعلمات
-
عنوان url - عنوان URL لاستخراج جداول HTML من
- الخيارات - مثيل ل GrabzItTableOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند تحويل جدول HTML.
قيمة الإرجاع
باطل
HTMLToTable ($ أتش تي أم أل، خيارات $ = فارغة)
يحدد HTML الذي يجب استخراج جداول HTML منه.
المعلمات
-
أتش تي أم أل - HTML لاستخراج جداول HTML من.
- الخيارات - مثيل ل GrabzItTableOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند تحويل جدول HTML.
قيمة الإرجاع
باطل
FileToTable ($ المسار، خيارات $ = فارغة)
يحدد ملف HTML الذي يجب استخراج جداول HTML منه.
المعلمات
-
المسار - مسار ملف ملف HTML لاستخراج جداول HTML من.
- الخيارات - مثيل ل GrabzItTableOptions الفئة التي تحدد أي خيارات خاصة لاستخدامها عند تحويل جدول HTML.
قيمة الإرجاع
باطل
GrabzItTableOptions
يمثل الفصل جميع الخيارات المتاحة عند تحويل جداول HTML إلى CSV أو XLSX أو JSON.
ممتلكات عامة
-
setCustomId($value) - معرف مخصص يمكنك نقله إلى خدمة الويب. سيتم إرجاع ذلك بعنوان URL الخاص بالرد الذي حددته
-
setTableNumberToInclude($value) - فهرس الجدول المطلوب تحويله ، إذا كانت جميع الجداول في صفحة الويب مرتبة من أعلى صفحة الويب إلى أسفل
-
setFormat($value) - يجب أن يكون الجدول في
- الافتراضي: "CSV"
- خيارات: "CSV" ، "json" ، "xlsx"
-
setIncludeHeaderNames($value) - إذا تم إدراج أسماء الرؤوس الحقيقية في الجدول
-
setIncludeAllTables($value) - إذا كان هذا صحيحًا ، فسيتم استخراج كل جدول في صفحة الويب مع ظهور كل جدول في ورقة بيانات منفصلة. متوفر فقط بتنسيق XLSX
-
setClickElement($value) - هذا يحدد عنصر HTML ، باستخدام ملف محدد CSS للنقر. تذكر أن التأخير قد يكون مطلوبًا أيضًا لعرض تأثيرات النقرة
- تحذير هذه الميزة حاليًا في مرحلة تجريبية وقد لا توفر نتائج متسقة.
-
setTargetElement($value) - معرف عنصر HTML الوحيد في صفحة الويب التي يجب استخدامها لاستخراج الجداول من
-
setRequestAs($value) - نوع وكيل المستخدم الذي ترغب في استخدامه
- الافتراضي: 0
-
خيارات:
- 0 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح قياسي
- 1 = يشير إلى أنه يجب استخدام وكيل المستخدم لمتصفح الجوال
- 2 = يشير إلى أنه يجب استخدام وكيل المستخدم لمحرك البحث
-
setCountry($value) - البلد لقطة ينبغي أن تؤخذ من.
- الافتراضي: الموقع الحالي الأسرع
- الخيارات: "SG" ، "UK" ، "US"
-
setExportURL($value) - ال عنوان URL للتصدير الذي يحدد حيث يجب أن يتم تصدير الالتقاط أيضا
-
setEncryptionKey($value) - إذا تم تحديد مفتاح التشفير AES المشفر 64 الأساسي ، يتم تشفير الالتقاط عند إنشائه. فمن المستحسن استخدام إنشاء طريقة مفتاح التشفير لإنشاء المفتاح و فك تشفير الطرق لفك تشفير الالتقاط المشفر كما هو موضح في هذا المثال.
-
setAddress($value) - عنوان URL لتنفيذ تعليمات HTML البرمجية فيه. يمكن أن يكون مفيدًا في حالة استخدام HTML الجاري تحويله عناوين URL النسبية لموارد مثل CSS والصور.
-
setProxy($value) - تفاصيل وكيل HTTP يجب أن يستخدم برنامج المتصفح لاستخدام هذا الالتقاط
الطرق العامة
-
AddPostParameter ($ name ، $ value) - يحدد معلمة HTTP Post والقيمة الاختيارية ، يمكن استدعاء هذه الطريقة عدة مرات لإضافة معلمات متعددة. باستخدام هذه الطريقة سوف يجبر GrabzIt ل أداء وظيفة HTTP.
- الاسم - اسم المعلمة HTTP Post
- القيمة - قيمة المعلمة HTTP Post
Save($ callBackURL = فارغ)
Save النتيجة بشكل غير متزامن وإرجاع معرف فريد ، والتي يمكن استخدامها للحصول على لقطة مع GetResult الأسلوب.
المعلمات
-
callBackURL - معالج يجب على خدمة GrabzIt الاتصال بعد اكتمال عملها
قيمة الإرجاع
يتم طرح المعرف الفريد للشاشة وإلا إذا حدث خطأ. ويمكن استخدام هذا للحصول على لقطة مع GetResult طريقة
تحذير هذه الطريقة متزامنة ، وبالتالي ستتسبب في توقف التطبيق أثناء معالجة النتيجة
SaveTo()
Save النتيجة بشكل متزامن لمتغير يحتوي على بيانات بايت الشاشة.
قيمة الإرجاع
إرجاع بيانات البايت للملف في حالة نجاحه ، وإلا فإنه يلقي استثناء.
تحذير هذه الطريقة متزامنة ، وبالتالي ستتسبب في توقف التطبيق أثناء معالجة النتيجة
SaveTo($saveToملف)
Save النتيجة بشكل متزامن إلى ملف.
المعلمات
-
saveToملف - مسار الملف الذي سيتم التقاطه saveد إلى بمجرد الانتهاء منه
قيمة الإرجاع
تقوم بإرجاع القيمة الحقيقية إذا كانت ناجحة وإلا فإنها ستلقي استثناءً.
GetStatus ($ معرف)
الحصول على الوضع الحالي للشاشة GrabzIt.
المعلمات
-
معرف - المعرف الفريد للشاشة
قيمة الإرجاع
GrabzItStatus موضوع
GetCookies (المجال $)
احصل على جميع ملفات تعريف الارتباط التي يستخدمها GrabzIt لمجال معين. قد يشمل ذلك ملفات تعريف الارتباط المعرفة من قبل المستخدم.
المعلمات
-
المجال - المجال لإرجاع ملفات تعريف الارتباط لـ
قيمة الإرجاع
GrabzItCookie مجموعة
SetCookie ($ name ، $ domain ، $ value = "" ، $ path = "/" ، $ httponly = false ، $ تنتهي الصلاحية = "")
يعين ملف تعريف ارتباط مخصص جديد على GrabzIt ، إذا كان ملف تعريف الارتباط المخصص يحمل نفس الاسم والمجال مثل ملف تعريف الارتباط العام ، يتم تجاوز ملف تعريف الارتباط العام.
قد يكون ذلك مفيدًا إذا كانت ملفات مواقع الويب تتحكم فيها ملفات تعريف الارتباط.
المعلمات
-
اسم - اسم ملف تعريف الارتباط لتعيين
-
المجال - مجال موقع الويب لتعيين ملف تعريف الارتباط لـ
- القيمة - قيمة ملف تعريف الارتباط
- المسار - مسار موقع الويب الذي يرتبط به ملف تعريف الارتباط
- httponly - إذا كان هذا صحيحًا ، فيمكن استخدام ملف تعريف الارتباط فقط مع بروتوكول HTTP
-
تنتهي صلاحيته - يحدد وقت انتهاء صلاحية ملف تعريف الارتباط. تمرير قيمة فارغة إذا كان ملف تعريف الارتباط يجب أن لا تنتهي
- يجب أن تكون بالتنسيق yyyy-mm-dd hh: mm: ss
قيمة الإرجاع
صحيح إذا تم تعيين ملف تعريف الارتباط بنجاح ، وإلا خطأ
DeleteCookie ($ name ، $ domain)
حذف ملف تعريف ارتباط مخصص أو حظر ملف تعريف ارتباط عمومي من الاستخدام
المعلمات
-
اسم - اسم ملف تعريف الارتباط المراد حذفه
-
المجال - مجال موقع الويب لحذف ملف تعريف الارتباط لـ
قيمة الإرجاع
صحيح إذا تم حذف ملف تعريف الارتباط بنجاح ، وإلا كان خطأ
تواصلWaterMarks()
احصل على مخصصك الذي تم تحميله watermarks
قيمة الإرجاع
GrabzItWaterMark مجموعة
تواصلWaterMark($ معرف)
عودة العرف الخاص بك watermarks الذي يطابق المعرف المحدد
المعلمات
-
المعرف - معرف مخصص معين watermark تريد المشاهدة
قيمة الإرجاع
GrabzItWaterMark
أضفWaterMark(معرف $ ، مسار $ ، $ xpos ، $ ypos)
إضافة العرف الجديد watermark
المعلمات
-
المعرف - المعرف الذي تريد منحه المخصص watermark. من المهم أن يكون هذا المعرف فريدًا.
-
المسار - المسار المطلق لملف watermark على الخادم الخاص بك. على سبيل المثال C: /watermark/1.png
-
xpos - الموضع الأفقي الذي تريد أن تظهر فيه لقطة الشاشة
- مطلوب:
-
خيارات:
- اليسار = 0
- مركز = 1
- اليمين = 2
-
ypos - الموضع الرأسي الذي تريد أن تظهر فيه لقطة الشاشة
- مطلوب:
-
خيارات:
- أعلى = 0
- الأوسط = 1
- أسفل = 2
قيمة الإرجاع
يعود صحيحًا إذا كان watermark تم تعيينه بنجاح
DeleteWaterMark($ معرف)
حذف مخصص watermark
المعلمات
-
المعرّف - معرّف العرف watermark تريد حذفه
قيمة الإرجاع
يعود صحيحًا إذا كان watermark تم حذفه بنجاح
SetLocalProxy ($ proxyUrl)
هذه الطريقة تمكن الخادم الوكيل المحلي ليتم استخدامها لجميع الطلبات.
المعلمات
-
proxyUrl - عنوان URL ، الذي يمكن أن يتضمن منفذًا إذا لزم الأمر ، من الوكيل. سيؤدي توفير قيمة خالية إلى إزالة أي وكيل تم تعيينه مسبقًا
UseSSL ($ قيمة)
يحدد ما إذا كانت طلبات GrabzIt يجب أن تستخدم API SSL ام لا
المعلمات
-
قيمة - إذا كان هذا صحيحًا ، فستستخدم جميع الطلبات إلى واجهة برمجة تطبيقات GrabzIt SSL
CreateEncryptionKey ()
قم بإنشاء مفتاح تشفير 64 أساسي آمن مشفر بطول أحرف 44.
فك تشفير (بيانات $ ، مفتاح $)
فك تشفير التقاط مشفر باستخدام مفتاح التشفير المقدم.
المعلمات
DecryptFile (مسار $ ، مفتاح $)
فك تشفير التقاط مشفر باستخدام مفتاح التشفير المقدم.
المعلمات
نتيجة الطبقات
GrabzItCookie
ممتلكات عامة
-
الاسم
-
القيم
-
نطاق
- المجال الذي تم تعيين ملف تعريف الارتباط عليه.
-
مسار
- المسار على المجال الذي ينطبق عليه ملف تعريف الارتباط هذا.
-
HttpOnly
- إذا كان ملف تعريف الارتباط هذا صالحًا فقط عند عرض موقع الويب باستخدام بروتوكول HTTP.
-
تنتهي
- تاريخ انتهاء صلاحية ملف تعريف الارتباط هذا
-
النوع
-
نوع ملف تعريف الارتباط هذا ، والذي يمكن أن يكون أحد الإجراءات التالية:
- عالمي - هذا ملف تعريف ارتباط عالمي من إعداد GrabzIt
- محلي - هذا ملف تعريف ارتباط محلي تم تعيينه بواسطتك
- تجاوز - ملف تعريف ارتباط عمومي تم تجاوزه بواسطتك
GrabzItStatus
الطبقة التي تمثل الوضع الحالي للشاشة.
ممتلكات عامة
-
Processing
- إذا كان هذا صحيحًا ، فلا تزال لقطة الشاشة قيد المعالجة.
-
Cached
- إذا كان صحيحًا ، فقد تمت معالجة لقطة الشاشة ويتم تخزينها مؤقتًا في الوقت الحالي.
-
Expired
- إذا كان هذا صحيحًا ، فلم تعد لقطة الشاشة موجودة على نظام GrabzIt.
-
Message
- رسالة خطأ تم إرجاعها بواسطة النظام.
GrabzItWaterMark
هذه الفئة تمثل العادة watermarks مخزنة في GrabzIt
ممتلكات عامة
-
تحديد
-
XPosition
-
الوضع الأفقي لـ watermark
- اليسار = 0
- مركز = 1
- اليمين = 2
-
YPosition
-
الوضع الرأسي لل watermark
- أعلى = 0
- الأوسط = 1
- أسفل = 2
-
شكل