استخدام x-callback-url مع الاختصارات على iPhone أو iPad
يدعم تطبيق الاختصارات x-callback-url، والذي يسمح لتطبيق الاتصال باستلام رد (رد اتصال) عند اكتمال تفاعل معين. يمكنك تشغيل الاختصارات من x-callback-url باستخدام المعاملات ذاتها الموضحة في تشغيل اختصار باستخدام نظام رابط على iPhone أو iPad. على سبيل المثال:
shortcuts://x-callback-url/run-shortcut?name=حساب%20البقشيش&input=text&text=24.99&x-success=...&x-cancel=...
وفقًا لمعيار x-callback-url، يمكن توفير المعاملات الإضافية التالية:
x-success (اختياري): رابط يفتح عندما ينجح التفاعل—على سبيل المثال، بعد استيراد الاختصار أو الانتهاء من تشغيله. عند تشغيل الاختصار، يتم إلحاق معامل اسمه
resultبرابط يحتوي على الإخراج النصي للاختصار.x-cancel (اختياري): رابط يفتح عندما يتم إلغاء التفاعل بواسطة المستخدم.
x-error (اختياري): رابط يفتح عندما يفشل التفاعل بسبب حدوث خطأ. يتم إلحاق معامل اسمه
errorMessageبرابط يحتوي على وصف للخطأ.
من خلال معامل x-success، يمكنك توفير رابط يفتح بعد الانتهاء من تشغيل الاختصار بنجاح. ويمكن استخدام هذا إلى جانب قائمة اختيار متعددة الخطوات للمهام، حيث يتم فتح x-callback-url لتشغيل الاختصار والرجوع إلى القائمة والمتابعة إلى المهمة التالية عبر رابط.
ومن خلال معامل x-cancel، يمكنك توفير رابط للطوارئ يفتح في حالة توقف الاختصار قبل الانتهاء من تشغيله. وبما أن الاختصار لم يكتمل، فلن يتوفر إخراج من الاختصار.
ومن خلال معامل x-error، يمكنك توفير رابط للطوارئ يفتح إذا واجه الاختصار خطأ ما أثناء تشغيله وفشل الانتهاء من تشغيله. في هذه الحالة، يمكنك إطلاق رابط مختلف لمعالجة المشكلة.