التعليمات الأساسية
تعليمات للاستخدام
1. ملفات ملفات JS
قدم ملف JS التالي على الصفحة التي تحتاج إلى استدعاء واجهة JS (دعم https): http://res.wx.qq.com/open/js/jweixin-1.0.0.js
ملاحظة: دعم التحميل باستخدام طريقة تحميل الوحدة النمطية القياسية AMD/CMD
2. حقن وتكوين واجهة التكوين
يجب على جميع الصفحات التي تحتاج إلى استخدام JSSDK أولاً حقن معلومات التكوين ، وإلا فلن يتم استدعاؤها (يجب استدعاء عنوان URL نفسه مرة واحدة فقط ، وتطبيق الويب الخاص بالمنتجع الصحي الذي يغير عنوان URL في كل مرة يتغير عنوان URL).
نسخة الكود كما يلي:
wx.config ({
Debug: True ، // قم بتشغيل وضع التصحيح ، سيتم تنبيه قيم الإرجاع لجميع واجهات برمجة التطبيقات التي تسمى على العميل. لعرض المعلمات التي تم تمريرها ، يمكنك فتحها على جانب الكمبيوتر. سيتم طباعة معلومات المعلمة من خلال السجل وسيتم طباعتها فقط على جانب الكمبيوتر.
appid: '' ، // مطلوب ، المعرف الفريد للحساب الرسمي
الطابع الزمني: ، // مطلوب لإنشاء طابع زمني توقيع
noncestr: '' ، // مطلوب لإنشاء سلسلة عشوائية من التوقيعات
التوقيع: '' ، // مطلوب ، توقيع ، انظر الملحق 1
jsapilist: [] // مطلوب ، يتم عرض قائمة واجهات JS التي يجب استخدامها ، ويتم عرض قائمة جميع واجهات JS في التذييل 2
}) ؛
3. تحقق من خلال الواجهة الجاهزة
نسخة الكود كما يلي:
wx.ready (function () {
// بعد التحقق من معلومات التكوين ، سيتم تنفيذ الطريقة الجاهزة. يجب الحصول على جميع مكالمات الواجهة بعد أن تحصل واجهة التكوين على النتيجة. التكوين هو عملية غير متزامنة للعميل. لذلك ، إذا كنت بحاجة إلى الاتصال بالواجهة ذات الصلة عند تحميل الصفحة ، فيجب وضع الواجهة ذات الصلة في الوظيفة الجاهزة لضمان التنفيذ الصحيح. بالنسبة للواجهات التي لا تسمى إلا عند تشغيل المستخدم ، يمكن استدعاؤها مباشرة دون وضعها في الوظيفة الجاهزة.
}) ؛
4. فشل التحقق من واجهة الخطأ
نسخة الكود كما يلي:
wx.error (وظيفة (الدقة) {
// في حالة فشل التحقق من معلومات التكوين ، سيتم تنفيذ وظيفة الخطأ. إذا انتهت صلاحية التوقيع ، فسوف يفشل التحقق. للحصول على رسائل خطأ محددة ، يمكنك فتح وضع التصحيح للتكوين لعرضه ، أو يمكنك عرضه في معلمة RES التي تم إرجاعها. بالنسبة للسبا ، يمكنك تحديث التوقيع هنا.
}) ؛
تعليمات استدعاء واجهة
يتم استدعاء جميع الواجهات من خلال كائنات WX (يمكن أيضًا استخدامها باستخدام كائنات Jweixin). المعلمات هي كائن. بالإضافة إلى المعلمات التي تحتاج كل واجهة بحد ذاتها إلى تمريرها ، هناك أيضًا المعلمات العامة التالية:
النجاح: تم تنفيذ وظيفة رد الاتصال عندما تسمى الواجهة بنجاح.
FAIL: تم تنفيذ وظيفة رد الاتصال عند تفشل مكالمات الواجهة.
أكمل: تم تنفيذ وظيفة رد الاتصال عند إكمال الواجهة ، وسيتم تنفيذها بغض النظر عن النجاح أو الفشل.
إلغاء: وظيفة رد الاتصال عندما ينقر المستخدم على الإلغاء ، فقط سيتم استخدام بعض واجهات برمجة التطبيقات التي تحتوي على عمليات إلغاء المستخدمين.
الزناد: طريقة تستمع للتشغيل عند النقر فوق زر في القائمة. هذه الطريقة تدعم الواجهات ذات الصلة فقط في القائمة.
تحتوي جميع الوظائف أعلاه على معلمة ، كائن الكتابة ، بالإضافة إلى البيانات التي يتم إرجاعها بواسطة كل واجهة بحد ذاتها ، هناك أيضًا خاصية شائعة ، تنسيق قيمته كما يلي:
عندما تكون المكالمة ناجحة: "XXX: OK" ، حيث XXX هو اسم واجهة المكالمة
عندما يلغي المستخدم: "xxx: cancel" ، حيث يكون xxx اسم الواجهة المسمى
عندما تفشل المكالمة: تكون قيمتها رسالة خطأ محددة
الواجهة الأساسية
تحديد ما إذا كان إصدار العميل الحالي يدعم واجهة JS المحددة
نسخة الكود كما يلي:
wx.checkjsapi ({
jsapilist: ['chickImage'] // قائمة واجهات JS التي يجب اكتشافها ، انظر الملحق 2 للحصول على قوائم واجهات JS.
النجاح: الوظيفة (الدقة) {
// إرجاع أزواج القيمة الرئيسية ، فإن قيمة API المتوفرة صحيحة ، وليس متاحة للكاذبة
// على سبيل المثال: {"checkResult": {"choiceImage": TRUE} ، "errmsg": "checkjsapi: ok"}
}) ؛
واجهة مشاركة
احصل على حالة النقر لزر "مشاركة لحظات" وتخصيص واجهة محتوى المشاركة
نسخة الكود كما يلي:
wx.onmenusharetimeline ({
العنوان: '' ، // مشاركة العنوان
الرابط: '' ، // رابط مشاركة
Imgurl: '' ، // icon icon
النجاح: وظيفة () {
// تنفيذ وظيفة رد الاتصال بعد أن يؤكد المستخدم المشاركة
} ،
إلغاء: function () {
// تنفيذ وظيفة رد الاتصال بعد أن يلغي المستخدم المشاركة
}
}) ؛
احصل على حالة النقر فوق الزر "مشاركة إلى الأصدقاء" وتخصيص واجهة محتوى المشاركة
نسخة الكود كما يلي:
wx.onmenushareAppMessage ({
العنوان: '' ، // مشاركة العنوان
DESC: '' ، // شارك الوصف
الرابط: '' ، // رابط مشاركة
Imgurl: '' ، // icon icon
اكتب: '' ، // مشاركة نوع أو موسيقى أو فيديو أو رابط ، إذا لم يتم ملؤه ، فإن الرابط الافتراضي هو الرابط
Dataurl: '' ، // إذا كان النوع هو الموسيقى أو الفيديو ، فسيتم توفير ارتباط البيانات ، والافتراضي فارغ
النجاح: وظيفة () {
// تنفيذ وظيفة رد الاتصال بعد أن يؤكد المستخدم المشاركة
} ،
إلغاء: function () {
// تنفيذ وظيفة رد الاتصال بعد أن يلغي المستخدم المشاركة
}
}) ؛
احصل على حالة النقر فوق الزر "مشاركة إلى QQ" وتخصيص واجهة محتوى المشاركة
نسخة الكود كما يلي:
wx.onmenushareqq ({
العنوان: '' ، // مشاركة العنوان
DESC: '' ، // شارك الوصف
الرابط: '' ، // رابط مشاركة
Imgurl: '' // icon icon
النجاح: وظيفة () {
// تنفيذ وظيفة رد الاتصال بعد أن يؤكد المستخدم المشاركة
} ،
إلغاء: function () {
// تنفيذ وظيفة رد الاتصال بعد أن يلغي المستخدم المشاركة
}
}) ؛
احصل على حالة النقر لزر "Share to Tencent Weibo" وتخصيص واجهة محتوى المشاركة
نسخة الكود كما يلي:
wx.onmenushareweibo ({
العنوان: '' ، // مشاركة العنوان
DESC: '' ، // شارك الوصف
الرابط: '' ، // رابط مشاركة
Imgurl: '' // icon icon
النجاح: وظيفة () {
// تنفيذ وظيفة رد الاتصال بعد أن يؤكد المستخدم المشاركة
} ،
إلغاء: function () {
// تنفيذ وظيفة رد الاتصال بعد أن يلغي المستخدم المشاركة
}
}) ؛
واجهة الصورة
التقط صورة أو حدد صورة من واجهة ألبوم الهاتف المحمول
نسخة الكود كما يلي:
wx.chooseimage ({
النجاح: الوظيفة (الدقة) {
var localids = res.localids ؛ // إرجاع قائمة الهوية المحلية للصورة المحددة. يمكن لـ LocalId عرض الصور كسممة SRC لعلامة IMG
}
}) ؛
معاينة واجهة الصورة
نسخة الكود كما يلي:
wx.previewimage ({
الحالي: '' ، // ارتباط بالصورة المعروضة حاليًا
عناوين URL: [] // قائمة روابط الصور التي يجب معاينتها
}) ؛
تحميل واجهة الصورة
نسخة الكود كما يلي:
wx.uploadimage ({
LocalId: '' ، // المعرف المحلي للصورة المراد تحميله ، يتم الحصول عليها بواسطة واجهة الاختيار
isShowProgressTips: 1 // الافتراضي هو 1 ، عرض مطالبات التقدم
النجاح: الوظيفة (الدقة) {
var serverid = res.serverid ؛ // إرجاع معرف جانب الخادم للصورة
}
}) ؛
ملاحظة: يمكنك تنزيل الصورة التي تم تحميلها بواسطة WeChat باستخدام واجهة ملف الوسائط المتعددة. ServerId الذي تم الحصول عليه هنا هو media_id. وثيقة مرجعية ../ 12/58BFCFABBD501C7CD77C19BD9CFA8354.HTML
تنزيل واجهة الصورة
نسخة الكود كما يلي:
WX.DownloadImage ({
serverid: '' ، // معرف جانب الخادم للصورة المراد تنزيله ، تم الحصول عليه من واجهة التحميل
isShowProgressTips: 1 // الافتراضي هو 1 ، عرض مطالبات التقدم
النجاح: الوظيفة (الدقة) {
var localid = res.localid ؛ // إرجاع المعرف المحلي بعد تنزيل الصورة
}
}) ؛
واجهة الصوت
ابدأ تسجيل واجهة
نسخة الكود كما يلي:
wx.startrecord () ؛
توقف عن التسجيل
نسخة الكود كما يلي:
wx.stoprecord ({
النجاح: الوظيفة (الدقة) {
var localid = res.localid ؛
}
}) ؛
واجهة التوقف التلقائية لرصد التسجيل
نسخة الكود كما يلي:
wx.onvoicerecordend ({
// سيتم تنفيذ رد الاتصال الكامل عندما يكون وقت التسجيل أكثر من دقيقة واحدة ولا يتوقف.
أكمل: الوظيفة (الدقة) {
var localid = res.localid ؛
}
}) ؛
لعب الواجهة الصوتية
نسخة الكود كما يلي:
wx.playvoice ({
LocalId: '' // المعرف المحلي للصوت المراد تشغيله ، تم الحصول عليه بواسطة واجهة StopRecord
}) ؛
وقفة واجهة التشغيل
نسخة الكود كما يلي:
wx.pausevoice ({
LocalId: '' // المعرف المحلي للصوت الذي يجب إيقافه مؤقتًا ، يتم الحصول عليه بواسطة واجهة StopRecord
}) ؛
توقف عن واجهة التشغيل
نسخة الكود كما يلي:
wx.stopvoice ({
LocalId: '' // المعرف المحلي للصوت الذي يجب إيقافه ، يتم الحصول عليه بواسطة واجهة StopRecord
}) ؛
مراقبة واجهة التشغيل الصوتي
نسخة الكود كما يلي:
wx.onvoiceplayend ({
ServerId: '' ، // معرف جانب الخادم للصوت الذي يجب تنزيله ، يتم الحصول عليه من واجهة التحميل
النجاح: الوظيفة (الدقة) {
var localid = res.localid ؛ // إرجاع الهوية المحلية للصوت
}
}) ؛
تحميل الواجهة الصوتية
نسخة الكود كما يلي:
wx.uploadvoice ({
localid: '' ، // المعرف المحلي للصوت الذي يجب تحميله ، يتم الحصول عليه بواسطة واجهة StopRecord
isShowProgressTips: 1 // الافتراضي هو 1 ، عرض مطالبات التقدم
النجاح: الوظيفة (الدقة) {
var serverid = res.serverid ؛ // إرجاع معرف من جانب الخادم للصوت
}
}) ؛
ملاحظة: يمكنك تنزيل الصوت الذي تم تحميله بواسطة واجهة ملفات الوسائط المتعددة في WeChat. ServerId الذي تم الحصول عليه هنا هو media_id. وثيقة مرجعية ../ 12/58BFCFABBD501C7CD77C19BD9CFA8354.HTML
تحميل الواجهة الصوتية
نسخة الكود كما يلي:
WX.DownloadVoice ({
ServerId: '' ، // معرف جانب الخادم للصوت الذي يجب تنزيله ، يتم الحصول عليه من واجهة التحميل
isShowProgressTips: 1 // الافتراضي هو 1 ، عرض مطالبات التقدم
النجاح: الوظيفة (الدقة) {
var localid = res.localid ؛ // إرجاع الهوية المحلية للصوت
}
}) ؛
واجهة ذكية
تحديد الصوت والعودة إلى واجهة نتيجة الاعتراف
نسخة الكود كما يلي:
wx.translatevoice ({
localid: '' ، // المعرف المحلي للصوت الذي يجب تحديده ، يتم الحصول عليه من الواجهة المتعلقة بالتسجيل
isShowProgressTips: 1 ، // الافتراضي هو 1 ، وعرض مطالبات التقدم
النجاح: الوظيفة (الدقة) {
تنبيه (res.translateresult) ؛ // نتيجة التعرف على الكلام
}
}) ؛
معلومات المعدات
الحصول على واجهة حالة الشبكة
نسخة الكود كما يلي:
wx.getNetworkType ({
النجاح: الوظيفة (الدقة) {
var networkType = res.networktype ؛ // Return Network Types 2G ، 3G ، 4G ، WiFi
}
}) ؛
الموقع الجغرافي
استخدم خريطة WeChat المدمجة لعرض واجهة الموقع
نسخة الكود كما يلي:
wx.openlocation ({
Latitude: 0 ، // Latitude ، رقم نقطة عائم ، المدى 90 ~ -90
خط الطول: 0 ، // خط الطول ، رقم النقطة العائمة ، يتراوح من 180 إلى -180.
الاسم: '' ، // اسم الموقع
العنوان: '' ، // تفاصيل العنوان
المقياس: 1 ، // مستوى تكبير الخريطة ، وقيمة التشكيل ، يتراوح من 1 إلى 28. الافتراضي هو الحد الأقصى
infourl: '' // يمكن النقر على الارتباط التشعبي المعروض في أسفل واجهة موقع المشاهدة للقفز
}) ؛
احصل على واجهة تحديد الموقع الجغرافي
نسخة الكود كما يلي:
wx.getLocation ({
الطابع الزمني: 0 ، // توقيع الموقع الزمني ، المقدم فقط قبل الإصدار 6.0.2 مطلوب
noncestr: '' ، // توقيع الموقع سلسلة عشوائية ، متوفرة فقط قبل الإصدار 6.0.2
addrsign: '' ، // توقيع الموقع ، المقدم فقط قبل الإصدار 6.0.2 ، انظر الملحق 4 للحصول على التفاصيل
النجاح: الوظيفة (الدقة) {
var londitude = res.longitude ؛ // Latitude ، رقم نقطة العائمة ، المدى 90 ~ -90
var latitude = res.latitude ؛ // خط الطول ، رقم نقطة العائمة ، يتراوح من 180 إلى -180.
var speed = res.peed ؛ // السرعة ، تقاس بأمتار في الثانية
VAR DACURACY = RES.Accuracy ؛ // دقة الموقف
}
}) ؛
تشغيل واجهة
نسخة الكود كما يلي:
إخفاء واجهة القائمة في الزاوية اليمنى العليا
wx.hideoptionmenu () ؛
عرض واجهة القائمة في الزاوية اليمنى العليا
wx.showoptionmenu () ؛
أغلق واجهة نافذة الويب الحالية
wx.closewindow () ؛
واجهة زر دافع إخفاء وظيفة
wx.hidemenuitems ({
Menulist: [] // لإخفاء عناصر القائمة ، انظر الملحق 3
}) ؛
واجهة زر عرض الدُفعات
wx.showmenuitems ({
Menulist: [] // يتم عرض جميع عناصر القائمة التي سيتم عرضها في الملحق 3
}) ؛
إخفاء جميع واجهات الأزرار غير الأساسية
wx.hideallnonbasemenuitem () ؛
إظهار جميع واجهات زر الوظيفة
wx.showallnonbasemenuitem () ؛
مسح WeChat
انقر على واجهة مسح WeChat
wx.scanqrcode ({
DESC: 'scanqrcode desc' ،
NeedResult: 0 ، // الافتراضي هو 0. تتم معالجة نتيجة المسح بواسطة WeChat. 1 سيعود مباشرة نتيجة المسح.
Scantype: ["qrcode" ، "barcode"] ، // يمكنك تحديد ما إذا كنت تريد مسح رمز QR أو رمز 1R ، كلاهما افتراضي
النجاح: وظيفة () {
var result = res.Resultstr ؛ // عندما تكون NeedResult 1 ، يتم إرجاع النتيجة عن طريق مسح الكود
}
}) ؛
عنوان الحصاد
تحرير واجهة عنوان التسليم
نسخة الكود كما يلي:
wx.editaddress (
الطابع الزمني: 0 ، // توقيع الموقع الزمني ، المقدم فقط قبل الإصدار 6.0.2 مطلوب
noncestr: '' ، // توقيع الموقع سلسلة عشوائية ، متوفرة فقط قبل الإصدار 6.0.2
addrsign: '' ، // توقيع الموقع ، المقدم فقط قبل الإصدار 6.0.2 ، انظر الملحق 4 للحصول على التفاصيل
النجاح: الوظيفة (الدقة) {
var username = res.Username ؛ // اسم المرسل
var telnumber = res.telnumber ؛ // رقم هاتف المرسل إليه
var postalcode = res.postalCode ؛ // رمز بريدي
var provincename = res.provincename ؛ // عنوان التسليم القياسي الوطني عنوان المستوى الأول
var cityName = res.CityName ؛ // عنوان التسليم القياسي الوطني عنوان المستوى الثاني
var countryName = res.CountryName ؛ // عنوان التسليم القياسي الوطني عنوان المستوى الثالث
var address = res.address ؛ // معلومات عنوان التسليم التفصيلية
var nationalCode = res.NationalCode ؛ // رمز بلد التسليم
}
}) ؛
احصل على أقرب واجهة عنوان التسليم
نسخة الكود كما يلي:
wx.getlatestaddress ({
الطابع الزمني: 0 ، // توقيع الموقع الزمني ، المقدم فقط قبل الإصدار 6.0.2 مطلوب
noncestr: '' ، // توقيع الموقع سلسلة عشوائية ، متوفرة فقط قبل الإصدار 6.0.2
addrsign: '' ، // توقيع الموقع ، المقدم فقط قبل الإصدار 6.0.2 ، انظر الملحق 4 للحصول على التفاصيل
النجاح: الوظيفة (الدقة) {
var username = res.Username ؛ // اسم المرسل
var telnumber = res.telnumber ؛ // رقم هاتف المرسل إليه
var postalcode = res.postalCode ؛ // رمز بريدي
var provincename = res.provincename ؛ // عنوان التسليم القياسي الوطني عنوان المستوى الأول
var cityName = res.CityName ؛ // عنوان التسليم القياسي الوطني عنوان المستوى الثاني
var countryName = res.CountryName ؛ // عنوان التسليم القياسي الوطني عنوان المستوى الثالث
var address = res.address ؛ // معلومات عنوان التسليم التفصيلية
var nationalCode = res.NationalCode ؛ // رمز بلد التسليم
}
}) ؛
متجر WeChat
القفز إلى واجهة صفحة منتج WeChat
نسخة الكود كما يلي:
wx.openProductSpecificView ({
ProductId: '' ، // ID PROTTER
ViewType: '' // 0. القيمة الافتراضية ، تفاصيل المنتج العادية الصفحة 1.
}) ؛
قسيمة بطاقة WeChat
حرر قائمة كوبونات البطاقات للمتاجر واحصل على قائمة اختيار المستخدم
نسخة الكود كما يلي:
Wx.Choosecard ({
Shopid: '' ، // id id
Cardtype: '' ، // نوع البطاقة
كارديد: '' ، // معرف البطاقة
الطابع الزمني: 0 ، // Card Coupon Signature Time Stamp
noncestr: '' ، // سلسلة عشوائية من توقيع قسيمة البطاقة
Cardsign: '' ، // for card coupon signature ، يرجى الرجوع إلى الملحق 6 للحصول على التفاصيل
النجاح: الوظيفة (الدقة) {
var cardlist = res.CardList ؛ // معلومات قائمة البطاقات المحددة للمستخدم
}
}) ؛
أضف واجهة كوبون البطاقة على دفعات
نسخة الكود كما يلي:
wx.addcard ({
قائمة البطاقات: [{
كارديد: '' ،
cardext: ''
}] ، // قائمة كوبونات البطاقات التي سيتم إضافتها
النجاح: الوظيفة (الدقة) {
var cardlist = res.CardList ؛ // إضافة معلومات قائمة قسيمة البطاقة
}
}) ؛
تحقق من واجهة كوبون البطاقة في حزمة بطاقة WeChat
نسخة الكود كما يلي:
wx.opencard ({
قائمة البطاقات: [{
كارديد: '' ،
شفرة: ''
}] // قائمة كوبونات البطاقات التي سيتم فتحها
}) ؛
دفع WeChat
بدء طلب دفع WeChat
نسخة الكود كما يلي:
wx.choosewxpay ({
الطابع الزمني: 0 ، // دفع توقيع الطابع الزمني
noncestr: '' ، // Signature Signature String
الحزمة: '' ، // للحصول على تفاصيل الطلب ، يرجى الرجوع إلى الملحق 5
Paysign: '' ، // توقيع الدفع ، انظر الملحق 5 للحصول على التفاصيل
}) ؛