الصفحة الرئيسية>المتعلقة بالبرمجة>كود الذكاء الاصطناعي
تنزيل

بوابة Wechat

مكتبة تطوير منصة WeChat العامة

الواجهات المدعومة:

  • Access_token (المستخدم بواسطة واجهة برمجة تطبيقات الواجهة الخلفية)
  • الحصول على معلومات ترخيص المستخدم (OAuth2)
  • شبيبة-SDK
  • تغليف رسالة الرد
  • واجهة القائمة
  • واجهة مادية

سمات:

  • إدارة تحديث التذاكر وانتهاء صلاحية Access_token وJS-SDK تلقائيًا
  • دعم حسابات WeChat العامة المتعددة
  • دعم متعدد البيئات (التطوير والإنتاج) لتسهيل الاختبار المحلي
  • أساليب التحكم والمساعد (إدارة جلسة WeChat، وما إلى ذلك)
  • واجهة بسيطة وتخصيص سهل

فيديو تعليمي للاستخدام: تطوير حساب WeChat العام

تثبيت

أضف هذا السطر إلى ملف Gemfile الخاص بالتطبيق الخاص بك: 

 gem 'wechat-gate'

ومن ثم تنفيذ: 

 $ bundle

أو قم بتثبيته بنفسك على النحو التالي: 

 $ gem install wechat-gate

الحساب الرسمي

قبل بدء العمل، تحتاج إلى إجراء التكوينات التالية على منصة الحساب العام WeChat:

  1. افتح حسابك الرسمي (حساب الخدمة) وقم بتنشيط مصادقة WeChat (رسوم خدمة المصادقة 300 يوان)
  2. قم بتعيين اسم مجال الأمان لواجهة JS الخاصة بك في "إعدادات الحساب الرسمي" - "إعدادات الوظائف" في خلفية الحساب الرسمي، وهو اسم المجال الخاص بموقع الويب الذي يطلق عليه حسابك الرسمي
  3. قم بتعيين اسم مجال صفحة رد الاتصال الخاصة بك في "أذونات الواجهة" - "تفويض صفحة الويب للحصول على معلومات المستخدم الأساسية". يُستخدم هذا لمصادقة اسم مجال رد الاتصال لـ OAuth2.
  4. عرض وتكوين معرف التطبيق وAppSecret في "التكوين الأساسي"

إعدادات

قم بإنشاء الملف wechat.yml في دليل تكوين مشروع Rails وقم بتكوين معلومات حسابك الرسمي. 

 # 区分不同的环境
eggman:
  development:
    host: http://wechat-test1.eggman.tv

    wechat_id: xxxxxxxxxx
    app_id: xxxxxxxxxx
    app_secret: xxxxxxxxxx

    oauth2_redirect_uri: "http://wechat-test1.eggman.tv/wechat/users/callback"

    push_url: "http://wechat-test1.eggman.tv/wechat/push"
    push_token: xxxxxxxxxxxxxxxxxxxx
  production:
    host: https://eggman.tv

    wechat_id: xxxxxxxxxx
    app_id: xxxxxxxxxxxxxxxxxxxx
    app_secret: xxxxxxxxxxxxxxxxxxxxxxxxxx

# 如果不需要多环境支持，也可以这样
app_name:
  app_id: <%= ENV['WECHAT_APP_NAME_APP_ID'] %>
  app_secret: <%= ENV['WECHAT_APP_NAME_APP_SECRET'] %>
  oauth2_redirect_uri: <%= ENV['WECHAT_APP_NAME_OAUTH2_REDIRECT_URI'] %>

ثم حدد اسم الحساب الرسمي المراد قراءته في ApplicationController: 

 self.wechat_gate_app_name = 'eggman'

مكالمة الخلفية

عمليات واجهة برمجة التطبيقات في الخلفية (مثل الحصول على معلومات مستخدم WeChat، وما إلى ذلك).

بشكل افتراضي، تتم تهيئة التكوين في وحدة التحكم، والطريقة هي wechat_gate_config ، فقط استخدمها مباشرة. 

 wechat_gate_config . users # 获取用户列表
wechat_gate_config . user ( 'ONE_OPEN_ID' ) # 获取一个用户的详细信息
wechat_gate_config . access_token # 获取当前access_token

# OAuth 2
wechat_gate_config . oauth2_entrance_url ( scope : "snsapi_userinfo" , state : "CURENT_STATE" ) # 获取当前OAuth2授权入口URL
wechat_gate_config . oauth2_access_token ( "TOKEN" ) # 根据OAuth2返回的TOKEN获取access_token
wechat_gate_config . oauth2_user ( "ACCESS_TOKEN" , "ONE_OPEN_ID" ) # 获取一个用户的信息

wechat_gate_config . medias # 获取素材列表, 参数type: image | video | voice | news (图文)

wechat_gate_config . menu_get # 获取菜单
wechat_gate_config . menu_create ( MENU_HASH ) # 创建菜单

wechat_gate_config . generate_js_request_params ( REFERER_URL ) # 返回JS-SDK的验证参数，供前端JS-SDK使用

بالطبع، يمكنك أيضًا تهيئة التكوين يدويًا، أو حتى تحديد المسار إلى ملف التكوين: 

 config = WechatGate::Config.new('eggman', '/path/to/what/ever/you/want.yml')

يتمتع كل من Access_token والتذاكر في JS_SDK بوقت انتهاء الصلاحية وحد زمني للتحديث، وهو ما تم أخذه في الاعتبار هنا، ولا داعي للقلق بشأن ذلك إذا كنت تريد التحديث يدويًا، فيمكنك القيام بذلك: 

 config.refresh_access_token
config.refresh_jsapi_ticket

ملف التكوين يدعم erb

لمزيد من الواجهات والوثائق، يرجى إلقاء نظرة مباشرة على الكود المصدري، المكتوب بتفصيل كبير.

شبيبة-SDK 

  def ticket
    url = CGI . unescape ( params [ :url ] ) # 微信中用户访问的页面
    @data = wechat_gate_config . generate_js_request_params ( url ) # 生成微信JS-SDK所需的jsapi_ticket，signature等等参数供前段js使用
    render content_type : "application/javascript"
  end

Ticket.js.erb: 

 var wxServerConfig = <%= @data.to_json.html_safe %>;
<%= params[:callback] %>();

ثم أدخل الكود التالي في صفحة WeChat: 

 ( function ( ) {
  var ticket = document . createElement ( "script" ) ;
  ticket . src = "http://localhost/api/wechat_ticket/ticket.js?url=" + encodeURIComponent ( window . location . href . split ( '#' ) [ 0 ] ) + "&callback=wxCallback" ;
  var s = document . getElementsByTagName ( "script" ) [ 0 ] ;
  s . parentNode . insertBefore ( ticket , s ) ;
} ) ( ) ;

وظائف أخرى

قائمة مخصصة

قم أولاً بتعيين ملف تكوين القائمة، config/wechat_menu.yml، الذي يدعم erb. للحصول على التنسيق، يرجى الرجوع إلى مستند قائمة WeChat المخصصة: 

 button:
  - type: view
    name: 我的2
    url: <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'profile') %>
  - type: view
    name: 课程
    sub_button:
      - type: view
        name: 免费课程
        url:  <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'free') %>
      - type: view
        name: 付费课程
        url:  <%= @config.oauth2_entrance_url(scope: 'snsapi_userinfo', state: 'paid') %>

المتغير **@config** هو المثيل الحالي لحساب WeChat العام، يرجى عدم تعديله واستخدامه مباشرة.

ثم قم بتنفيذ مهمة أشعل النار: 

 $rails wechat_gate:create_menu APP_NAME=eggman CONFIG=/path/to/wechat.yml MENU=/path/to/wechat_menu.yml

من بينها، الإعدادات الافتراضية لـ CONFIG هي config/wechat.yml، والإعدادات الافتراضية MENU هي config/wechat_menu.yml، ويجب تحديد APP_NAME.

المهام

إضافة اختبار

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل