إينلينكيبواردبوتون هو فئة في مكتبة بيثون—برقية-بوت التي تستخدم لإنشاء أزرار التنسيب النحوية داخل مربع حوار المستخدم في برقية.
واحدة من ميزات إينلينيكيبواردبوتون هو إنشاء أزرار مع وصلات ورل التي يمكن للمستخدم متابعة مباشرة من الدردشة. ولكن في بعض الأحيان من الضروري تحديد أن المستخدم النقر على زر ورل لتنفيذ إجراء خاص. في هذه المقالة ، سوف ننظر في كيفية الكشف عن النقر على زر ورل باستخدام إينلينكيبواردبوتون.
أولا ، تحتاج إلى إنشاء مثيل من فئة إينلينكيبواردبوتون عن طريق تحديد النص ومعلمات ورل. سيتم عرض قيمة النص على الزر ، وقيمة ورل هي الرابط الذي سينقر عليه المستخدم. ثم يتم إنشاء مثيل من فئة إينلينكيبواردماركوب. تتم إضافة الزر الذي تم إنشاؤه إليه باستخدام طريقة الإضافة داخل قائمة الأزرار. وأخيرا ، يتم تعيين كائن إينلينيكيبواردماركوب التي تم إنشاؤها إلى المعلمة ريبليماركوب داخل وظيفة إرسال الرسالة مع بوت.طريقة إرسال الرسالة.
- الكشف عن النقر على زر ورل
- كيف يعمل زر لوحة المفاتيح الداخلية
- إينلينيكيبواردماركوب في برقية بوت أبي
- وضع عنوان ورل ل إنلينكيبواردبوتون
- مثال على استخدام إنلينكيبواردبوتون لعنوان ورل
- الحصول على رابط زر النقر
- مزايا استخدام إينلينكيبواردبوتون لعناوين المواقع
- سؤال وجواب
- كيف يمكنني الكشف عن النقر على زر رابط?
- كيف يمكنني إنشاء معالج إينلينيكيريهاندلر?
- كيف يمكنني إنشاء زر ورل باستخدام إينلينكيبواردبوتون?
- هل من الممكن استخدام إينلينكيبواردبوتون لإنشاء زر مع النص?
- ما هي بيانات الاتصال?
- كيف يمكنني ربط معالج إلى بوت?
الكشف عن النقر على زر ورل
زر ورل هو زر مع وصلة التي تسمح للمستخدم للذهاب إلى العنوان المحدد. النقر على هذا الزر يأخذك إلى عنوان ورل المحدد في متصفح خارجي.
لتحديد النقر على زر ورل في بوت برقية ، يمكننا استخدام مكتبة بيتيليغرامبوتابي. باستخدام هذه المكتبة ، يمكنك إنشاء إينلينكيبواردبوتون مع عنوان ورل المحدد وعملية النقر على هذا الزر.
هنا هو رمز سبيل المثال لإنشاء رابط زر:
من برقية استيراد إينلينيكيبوارد بوتون ، إينلينيكيبوارد ماركوب
زر = إينلينكيبواردبوتون ("انقر لي" ، ورل= " http://example.com ")
الترميز = إينلينيكيبواردماركوب ([زر])
في هذا المثال ، أنشأنا إينلينكيبواردبوتون مع النص "انقر لي" ورابط "http://example .كوم". ثم أنشأنا كائن إينلينكيبواردماركوب مع هذا الزر واستخدامه لإنشاء رسالة.
للكشف عن النقر على زر ورل ، نقوم بمعالجة التحديثات في طريقة كولباك كيريهاندلر. هنا مثال على التعليمات البرمجية:
من برقية.تحويلة استيراد الكالباكيريهاندلر
زر مواطن_انقر (تحديث ، سياق):
الاستعلام = تحديث.استدعاء _ استعلام
إذا الاستعلام.البيانات == "http://example.com ":
# الإجراءات عند النقر على
زر رابط المرسل.إضافة _مقبض (مكالمة_مقبض (زر_انقر))
في هذا المثال ، نتحقق من قيمة الاستعلام.بيانات للامتثال للرابط الذي يرتبط به رابط الزر. إذا تطابقت القيمة ، يمكننا تنفيذ الإجراءات اللازمة.
وهكذا ، يمكننا الكشف عن النقر على عنوان ورل من الزر وتنفيذ الإجراءات اللازمة عند النقر عليه في بوت برقية باستخدام مكتبة بيتيليغرامبوتابي.
كيف يعمل زر لوحة المفاتيح الداخلية
إينلينكيبواردبوتون هي واحدة من فئات مكتبة بيثون—برقية-بوت ، الذي يوفر القدرة على إنشاء أزرار داخل الرسائل النصية في برقية. يسمح لك بإرسال رسائل بأزرار ، عند النقر عليها ، يتم إجراء معين أو يتم إرسال طلب معين.
ويستند إينلينيكيبواردبوتون على زر من برقية.إينلينكيبواردبوتون فئة من مكتبة بيثون-برقية-بوت. وهو جزء من لوحة المفاتيح إينلينكيبواردماركوب ، والتي يمكن تركيبها على رسالة. لوحة المفاتيح عبارة عن شبكة تتكون من أزرار ، يمكن أن يحتوي كل منها على نص فريد وبيانات رد الاتصال. زر استدعاء البيانات هي معلومات خاصة يتم إرسالها إلى الروبوت عند الضغط على الزر. يسمح هذا للبوت بتحديد الزر الذي تم الضغط عليه وتنفيذ الإجراء المناسب.
يجب أن يحتوي كل كائن زر لوحة المفاتيح المضمنة على نص الزر وبيانات رد الاتصال. عندما ينقر المستخدم على الزر ، يرسل عميل تيليجرام طلبا إلى الروبوت يحتوي على بيانات رد الاتصال لهذا الزر. يمكن للبوت استخدام هذه المعلومات لتحديد المزيد من الإجراءات.
مثال على استخدام إنلينكيبواردبوتون:
عند إكمال هذه الخطوات ، سيتم عرض الزر في الرسالة ، وعند النقر فوقه ، سيتم إرسال طلب مع "بيانات الاتصال". يمكن للبوت مراقبة هذا الطلب وتنفيذ الإجراءات المناسبة بناء على بيانات رد الاتصال.
إينلينيكيبواردبوارتون يسمح لك بإنشاء رسائل تفاعلية في برقية ، مما يسمح للمستخدم بالتفاعل مع بوت باستخدام الأزرار. هذه طريقة رائعة لتحسين تجربة المستخدم وتوفير تنقل أسهل.
إينلينيكيبواردماركوب في برقية بوت أبي
إينلينكيبواردماركوب في برقية بوت أبي هو كائن يسمح للمطورين لإنشاء أزرار تفاعلية لمستخدمي بوت. يتم استخدامه جنبا إلى جنب مع الكائنات إينلينكيبواردبوتون لإنشاء أزرار جزءا لا يتجزأ من التي يمكن عرضها في الرسائل أو استجابات الاستعلام.
إينلينيكيبواردماركوب لديه الهيكل التالي:
| InlineKeyboardMarkup |
|
InlineKeyboardMarkup содержит одно поле inline_keyboard, которое представляет собой массив строк кнопок (InlineKeyboardButton[]). Каждая строка кнопок состоит из одной или нескольких кнопок. Каждая кнопка представляет собой объект InlineKeyboardButton.
Пример использования InlineKeyboardMarkup:
reply_markup = InlineKeyboardMarkup(inline_keyboard=[
[
InlineKeyboardButton(
النص='زر 1',
بيانات الاتصال = 'زر1'
),
إينلينيكيبواردبوتون(
النص='زر 2',
بيانات الاتصال = 'زر2'
)
],
[
إينلينيكيبواردبوتون(
نص = 'زر 3',
رد الاتصال_البيانات= 'زر3'
)
]
])
في هذا المثال ، يتم إنشاء إينلينكيبواردماركوب مع ثلاثة صفوف من الأزرار. يوجد زران في الصف الأول ، زر واحد في الصف الثاني وزر واحد في الصف الثالث. يحتوي كل زر على نص وقيمة سلسلة بيانات رد الاتصال التي سيتم إرسالها عند النقر فوق الزر. يمكن استخدام قيمة بيانات رد الاتصال لتحديد الزر الذي تم الضغط عليه في المعالج.
إينلينيكيبواردماركوب يسمح لك بإنشاء أزرار مع إجراءات مختلفة ، مثل إرسال الرسائل ، وفتح الروابط ، أو استدعاء أساليب بوت أخرى. ويوفر فرصا واسعة لتطوير التفاعلات التفاعلية مع المستخدمين في برقية.
وضع عنوان ورل ل إنلينكيبواردبوتون
إينلينيكيبواردبوتون فئة المقدمة من مكتبة بيثون-برقية-بوت لإنشاء أزرار داخل رسائل برقية. واحدة من ميزات إينلينيكيبواردبوتون هو تعيين عنوان ورل التي سيتم فتحها عند النقر على زر.
لتعيين عنوان ورل ل إينلينيكيبواردبوتون ، يجب استخدام المعلمة ورل عند إنشاء الزر. Пример создания кнопки с url:
from telegram import InlineKeyboardButton, InlineKeyboardMarkup
button = InlineKeyboardButton("Название кнопки", url="https://www.example.com")
inline_keyboard = InlineKeyboardMarkup([button])
# Отправка сообщения с кнопкой
update.message.reply_text("Текст сообщения", reply_markup=inline_keyboard)
В данном примере создается кнопка с названием «Название кнопки» и установленным url «https://www.example.com». عند النقر فوق الزر ، سيتم إعادة توجيه المستخدم إلى عنوان ورل المحدد.
من المهم ملاحظة أن عنوان ورل يجب أن يكون صالحا تماما ويبدأ بالبروتوكول (على سبيل المثال ، "هتبس://").
بالإضافة إلى تعيين عنوان ورل ، يمكنك استخدام معلمات إنلينكيبواردبوتون الأخرى لتخصيص مظهر الزر ، مثل كالباك_داتا ، سويتش_ين_كويست ، الخ.
مثال على استخدام إينلينكيبواردبوتون لعنوان ورل
يوفر أبي برقية القدرة على إنشاء أزرار مضمنة باستخدام إنلينكيبواردماركوب و إنلينكيبواردبوتون. زر لوحة المفاتيح المضمنة هو كائن يحتوي على نص الزر وبيانات رد الاتصال (بيانات رد الاتصال) التي سيتم تمريرها إلى المعالج إذا تم الضغط على الزر.
واحدة من الطرق لاستخدام إينلينكيبواردبوتون هو إنشاء أزرار الارتباط للتنقل من خلال ورل. للقيام بذلك ، استخدم معلمة ورل في منشئ إينلينكيبواردبوتون.
وفيما يلي مثال على إنشاء زر مع عنوان ورل:
inline_keyboard.add(url_button)
Используем созданную InlineKeyboardMarkup в качестве параметра reply_markup при отправке сообщения:
chat_id = 'xxxxxxxxx' # Идентификатор чата
'مثال على استخدام إينلينكيبواردبوتون لعنوان ورل'
بوت.إرسال رسالة (معرف الدردشة=معرف الدردشة ، النص=نص الرسالة ، الرد على العلامة=لوحة المفاتيح المضمنة)
بعد تنفيذ هذا الرمز ، رسالة مع زر" اسم الزر " سيتم عرضها في برقية. النقر على زر سوف يأخذك إلى عنوان ورل المحدد — https://example.com
الحصول على رابط زر النقر
في برقية بوت أبي ، فمن الممكن لخلق أزرار مع وصلات ورل بحيث يمكن للمستخدم النقر على ذلك وفتح صفحة ويب معينة. للقيام بذلك ، يتم استخدام فئة إنلينكيبواردبوتون ، والذي يسمح لك لإنشاء أزرار تفاعلية في رسائل بوت.
من أجل معالجة النقر على زر ورل ، الخطوات التالية مطلوبة:
إضافة زر مع رابط ورل إلى الرسالة المقابلة.
- تسجيل معالج للنقر على زر ورل في رمز بوت.
- ديف مقبض زر (بوت ، تحديث):
- رابط = الاستعلام.البيانات
- # اعتراض النقر على رابط
مثال على الكود:
الاستعلام = تحديث.استدعاء _ استعلام
الدردشة = الاستعلام.رسالة.الدردشة
من إذا رابط.يبدأ مع ('هتب') زر:
# إرسال رسالة مع الافتتاح
من بوت.إرسال رابط الرسالة(معرف الدردشة=معرف الدردشة ، النص= ' نقرت على الرابط: {}'.شكل (رابط))
آخر:
# إرسال رسالة خطأ
بوت.إرسال رسالة (معرف الدردشة=معرف الدردشة ، النص= 'رابط غير صالح')
# إنشاء مثيل من فئة إينلينكيبواردبوتون مع رابط ورل
زر = إينلينكيبواردبوتون (النص = 'الذهاب إلى الموقع' ، ورل='http://example.com ')
# إنشاء إينلينيكيبواردماركوب وإضافة زر لدينا إلى قائمة الأزرار
لوحة المفاتيح = إينلينيكيبواردماركوب ([زر])
# إرسال رسالة مع أزرار
إلى بوت.إرسال رسالة (معرف الدردشة=معرف الدردشة ، النص= 'انقر فوق الزر للانتقال إلى الموقع' ، الرد على علامة=لوحة المفاتيح)
في المثال أعلاه ، عند النقر فوق عنوان ورل للزر ، سيتم إرسال رسالة مع النص" قمت بالنقر فوق الارتباط: [ورل] " ، حيث [ورل] هو رابط ورل المرسلة في الزر. إذا لم يبدأ الرابط مع " هتب "، سيتم إرسال رسالة مع النص" رابط غير صالح".
وهكذا ، يمكنك بسهولة التعامل مع النقر على رابط الزر في بوت برقية وتنفيذ إجراءات مختلفة اعتمادا على محتوى الرابط.
مزايا استخدام إينلينكيبواردبوتون لعناوين المواقع