تنزيل wechat4u - تنزيل كود مصدر wechat4u

wechat4u

كود الذكاء الاصطناعي

v0.6.6

تنزيل

wechat4u.js

الإعلان عن wechat4u v0.7.14

سمات

تصدير واستيراد البيانات اللازمة للحفاظ على bot.botData لتسجيل الدخول إلى WeChat (#160)
تعديل ملاحظات جهة الاتصال bot.updateRemarkName(UserName, RemarkName) (#121)
تعديل اسم المجموعة bot.updateChatRoomName(ChatRoomUserName, NewName) (#168)
إعادة توجيه الرسالة bot.forwardMsg(msg, toUserName)
إبطال الرسالة bot.revocMsg(MsgID, toUserName)

التغييرات

تم إصلاح مشكلة فشل تحميل الملفات الكبيرة
يدعم بروتوكول uos ويمكن استخدامه بواسطة جميع WeChat، يرجى استخدام مصادقة WeChat بالاسم الحقيقي أولاً.
فئة من الأساليب التي ترسل رسائل تقوم بإرجاع بيانات الاستجابة الكاملة عند النجاح
لم تعد بيانات base64 الخاصة بالصورة الرمزية للمستخدم مخزنة في كائن bot.user.
قم بإزالة دليل المثال
تم إصلاح مشكلة عدم إمكانية تعداد بعض البيانات في جهة الاتصال والرسالة
قم بتمرير كائن الخطأ الكامل إلى رمز المستوى الأعلى ووضع وصف الخطأ الصيني الأصلي في err.tips
تضيف طريقة bot.getContact(Seq) معلمة Seq لدعم الاكتساب المتزايد لجهات الاتصال الكاملة.

التثبيت والاستخدام

 npm install --save wechat4u@latest

 const Wechat = require ( 'wechat4u' )
let bot = new Wechat ( )
bot . start ( )
// 或使用核心API
// const WechatCore = require('wechat4u/lib/core')

اختبار التنمية

git clone https://github.com/nodeWechat/wechat4u.git
cd wechat4u
npm install
npm run core // 命令行模式
npm run compile // babel编译

أمثلة الاستخدام

node run-core.js

راجع رمز المنطق، فهو موجز وكامل، تأكد من قراءته

إنشاء مثيل لفئة Wechat

 let bot = new Wechat ( [ botData ] )

إذا تم تمرير botData ، فسيتم استخدام معلومات الروبوت هذه لإعادة تشغيل المزامنة السابقة.

خصائص المثيل

جميع الخصائص للقراءة فقط

bot.botData

المعلومات الأساسية القابلة للتصدير للمثيل يمكنك ملء هذه المعلومات وإعادة مزامنتها عند إنشاء روبوت جديد في المرة القادمة.

bot.PROP

المعلومات الضرورية للبقاء مسجل الدخول

bot.CONF

معلومات التكوين، بما في ذلك عنوان الخادم الحالي ومسار واجهة برمجة التطبيقات وبعض الثوابت

يحتاج البرنامج إلى استخدام الثوابت في CONF لتحديد نوع الرسالة الجديدة للحالة الحالية.

 bot . state == bot . CONF . STATE . init // 初始化状态
bot . state == bot . CONF . STATE . uuid // 已获取 UUID
bot . state == bot . CONF . STATE . login // 已登录
bot . state == bot . CONF . STATE . logout // 已退出登录
msg . MsgType == bot . CONF . MSGTYPE_TEXT // 文本消息
msg . MsgType == bot . CONF . MSGTYPE_IMAGE // 图片消息
msg . MsgType == bot . CONF . MSGTYPE_VOICE // 语音消息
msg . MsgType == bot . CONF . MSGTYPE_EMOTICON // 自定义表情消息
msg . MsgType == bot . CONF . MSGTYPE_MICROVIDEO // 小视频消息
msg . MsgType == bot . CONF . MSGTYPE_VIDEO // 视频消息

bot.state

الوضع الحالي

bot.user

معلومات المستخدم التي تم تسجيل دخولها حاليًا

bot.contacts

جميع جهات الاتصال، بما في ذلك جهات اتصال دفتر العناوين ومجموعات جهات الاتصال الحديثة والحسابات العامة

المفتاح هو اسم مستخدم جهة الاتصال. اسم المستخدم هو UUID لكل جهة اتصال أثناء تسجيل الدخول هذا، ولكنه سيتغير في المرة التالية التي تقوم فيها بتسجيل الدخول.

القيمة هي كائن Contact لمعرفة طرق السمات المحددة، راجع src/interface/contact.js

رسالة

جميع الرسائل المستلمة بعد تسجيل الدخول

msg هو كائن Message . للتعرف على طرق السمات المحددة، راجع src/interface/message.js

مثيل API

بوت.ستارت()

قم بتشغيل مثيل، وقم بتسجيل الدخول والبقاء متزامنًا

بعد استدعاء هذا الأسلوب، قم بمعالجة الرسالة من خلال الاستماع إلى الحدث

إعادة تشغيل الروبوت ()

استخدم المعلومات الضرورية التي حصل عليها المثيل لتسجيل الدخول مرة أخرى والمزامنة

بوت.توقف()

أوقف المثيل وقم بتسجيل الخروج

بعد استدعاء هذه الطريقة، قم بتسجيل الخروج من خلال الاستماع إلى حدث logout

bot.setPollingMessageGetter(getter)

تخصيص محتوى رسالة نبضات القلب

تقوم وظيفة getter بإرجاع محتوى رسالة نبضات القلب

يجب أن يكون typeof(getter()) "string"

 bot . setRollingMessageGetter ( function ( ) {
  //
  return ( new Date ( ) ) . toJSON ( ) ;
} ) ;

bot.setPollingIntervalGetter(getter)

الفاصل الزمني المخصص لنبضات القلب

تقوم الدالة getter بإرجاع الفاصل الزمني لنبضات القلب بالمللي ثانية

يجب أن يكون typeof(getter()) "number"

 bot . setRollingIntervalGetter ( function ( ) {
  return 2 * 60 * 1000 ;
} ) ;

bot.setPollingTargetGetter(getter)

المستخدم المستهدف لنبضات القلب مخصص

تقوم الدالة getter بإرجاع UserName للمستخدم المستهدف (على شكل @xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx )

يجب أن يكون typeof(getter()) "string"

ملاحظة: إذا كنت تريد استخدام bot.user.UserName ، فستحتاج إلى تحديد المستخدم المستهدف بعد حدث login

 bot . setRollingmeGetter ( function ( ) {
  return bot . user . UserName ;
} ) ;

جميع الطرق التالية ترجع Promise

bot.sendText(msgString, toUserName)

إرسال رسائل نصية، والتي يمكن أن تتضمن رموز تعبيرية (؟) ورموز QQ التعبيرية ([ابتسامة سيئة])

bot.uploadMedia(Buffer | Stream | ملف، اسم الملف، toUserName)

تحميل ملفات الوسائط

يعود

 {
  name : name ,
  size : size ,
  ext : ext ,
  mediatype : mediatype ,
  mediaId : mediaId
}

bot.sendPic(mediaId, toUserName)

إرسال الصور، mediaId هو mediaId الذي يتم إرجاعه بواسطة uploadMedia

 bot . uploadMedia ( fs . createReadStream ( 'test.png' ) )
  . then ( res => {
    return bot . sendPic ( res . mediaId , ToUserName )
  } )
  . catch ( err => {
    console . log ( err )
  } )

bot.sendEmoticon(md5 | mediaId, toUserName)

أرسل رمزًا تعبيريًا، ولكنه يكون MD5 للرمز التعبيري أو معرف الوسائط الذي يتم إرجاعه بواسطة uploadMedia.

يمكن حساب MD5 للرمز التعبيري بنفسك ولكن قد لا يكون موجودًا في خادم WeChat. ويمكن أيضًا الحصول عليه من رسالة الرمز التعبيري التي يتم إرجاعها بواسطة WeChat.

bot.sendVideo(mediaId، toUserName)

أرسل فيديو

bot.sendDoc(mediaId, name, size, ext, toUserName)

أرسل الملفات على شكل بطاقات تطبيق، ويمكنك إرسال الأصوات من خلال واجهة برمجة التطبيقات هذه

bot.sendMsg(msg, toUserName)

يعد تغليف الطريقة المذكورة أعلاه لإرسال الرسائل طريقة عامة لإرسال الرسائل.

عندما تكون msg عبارة عن سلسلة، قم بإرسال رسالة نصية

عندما تكون msg {file:xxx,filename:'xxx.ext'} ، أرسل ملف الوسائط المقابل

عندما تكون msg {emoticonMd5:xxx} ، قم بإرسال رمز تعبيري

 bot . sendMsg ( {
    file : request ( 'https://raw.githubusercontent.com/nodeWechat/wechat4u/master/bot-qrcode.jpg' ) ,
    filename : 'bot-qrcode.jpg'
  } , ToUserName )
  . catch ( err => {
    console . log ( err )
  } )

bot.forwardMsg(msg, toUserName)

إعادة توجيه الرسالة، msg كائن msg الذي تم تمريره بواسطة حدث message

bot.revocMsg(MsgID, toUserName)

سحب الرسالة

MsgID هو المعرف الذي يمثل الرسالة التي تم إرجاعها بعد إرسال الرسالة.

 bot . sendMsg ( '测试撤回' , toUserName )
  . then ( res => {
    return bot . revokeMsg ( res . MsgID , toUserName )
  } )
  . catch ( err => {
    console . log ( err )
  } )

bot.getContact(Seq)

الحصول على جهات الاتصال من دفتر العناوين

Seq هو التسلسل الذي تم إرجاعه بعد آخر مكالمة إلى bot.getContact، ولا يلزم تمريره في المكالمة الأولى.

bot.batchGetContact(جهات الاتصال)

الحصول على بيانات الاتصال المحددة على دفعات

مجموعة contacts ، مع تحديد البيانات التي سيتم الحصول عليها

عندما تكون contacts هي [{UserName: xxx}] ، يمكن الحصول على معلومات جهة الاتصال أو المجموعة المحددة

عندما تكون contacts [{UserName: xxx, EncryChatRoomId: xxx}] ، يمكن الحصول على معلومات مفصلة عن الأعضاء في المجموعة المحددة، ويمكن الحصول على EncryChatRoomId من معلومات المجموعة

bot.getHeadImg(HeadImgUrl)

الحصول على الصورة الرمزية لجهة الاتصال

 bot . getHeadImg ( bot . contacts [ UserName ] . HeadImgUrl ) . then ( res => {
  fs . writeFileSync ( ` ${ UserName } .jpg` , res . data )
} ) . catch ( err => {
  console . log ( err )
} )

bot.getMsgImg(MsgId)

احصل على صورة أو رمز تعبيري

 bot . getMsgImg ( msg . MsgId ) . then ( res => {
  fs . writeFileSync ( ` ${ msg . MsgId } .jpg` , res . data )
} ) . catch ( err => {
  console . log ( err )
} )

bot.getVoice(MsgId)

احصل على صوت

bot.getVideo(MsgId)

احصل على مقاطع فيديو أو مقاطع فيديو قصيرة

bot.getDoc(اسم المستخدم، معرف الوسائط، اسم الملف)

الحصول على الملف عندما يكون MsgType للرسالة هو 49 و AppMsgType هو 6، فهو ملف.

bot.addFriend(اسم المستخدم، المحتوى)

أضف أصدقاء

يمكن عمومًا الحصول على UserName من معلومات المجموعة

معلومات التحقق من Content

bot.verifyUser(اسم المستخدم، التذكرة)

إضافة طلب عبر صديق

bot.createChatroom(الموضوع، قائمة الأعضاء)

إنشاء مجموعة

اسم الدردشة الجماعية Topic

مصفوفة MemberList ، اسم المستخدم لشخصين على الأقل غيرك، التنسيق هو [ {"UserName":@250d8d156ad9f8b068c2e3df3464ecf2"}, {"UserName":":@42d725733741de6ac53cbe3738d8dd2e"} ]

bot.updateChatroom(ChatRoomUserName، MemberList، متعة)

تحديث أعضاء المجموعة

ChatRoomUserName اسم مستخدم المجموعة الذي يبدأ بـ "@@"

مجموعة MemberList ، اتصل بـ UserNa

fun اختيارية "addmember"، "delmember"، "invitemember"

bot.updateChatRoomName(ChatRoomUserName, NewName)

تحديث اسم المجموعة

ChatRoomUserName اسم مستخدم المجموعة الذي يبدأ بـ "@@"

سلسلة NewName ، اسم المجموعة الجديد

bot.opLog(اسم المستخدم، OP)

قم بتثبيت جهة اتصال أو إلغاء تثبيتها في الأعلى. يمكنك الحصول على مجموعة ChatRoomOwner عن طريق إلغاء تثبيت المجموعة مباشرة.

OP == 0 إلغاء التثبيت

OP == 1 مثبت

bot.updateRemarkName(اسم المستخدم، RemarkName)

قم بتعيين ملاحظات أو تسميات جهة الاتصال

حدث المثال

uuid

بعد الحصول على uuid، يمكنك إنشاء رمز QR أو الحصول على رمز QR من خادم WeChat.

 bot . on ( 'uuid' , uuid => {
  qrcode . generate ( 'https://login.weixin.qq.com/l/' + uuid , {
    small : true
  } )
  console . log ( '二维码链接：' , 'https://login.weixin.qq.com/qrcode/' + uuid )
} )

الصورة الرمزية للمستخدم

بعد المسح باستخدام هاتفك المحمول، يمكنك الحصول على عنوان URL للبيانات الخاص بالصورة الرمزية للمستخدم الذي قام بتسجيل الدخول.

تسجيل الخروج

تم تسجيل الخروج بنجاح

تم تحديث جهات الاتصال

تحديث الاتصال، يمكنك الحصول على قائمة جهات الاتصال المحدثة

رسالة

بالنسبة لجميع الرسائل التي يتم الحصول عليها من خلال المزامنة، يتم تحديد نوع الرسالة بواسطة msg.MsgType

 bot . on ( 'message' , msg => {
  switch ( msg . MsgType ) {
    case bot . CONF . MSGTYPE_STATUSNOTIFY :
      break
    case bot . CONF . MSGTYPE_TEXT :
      break
    case bot . CONF . MSGTYPE_RECALLED :
      break
  }
} )

خطأ

كائن جهة الاتصال وكائن الرسالة

ترث كل جهة اتصال من الواجهة/جهة الاتصال وتوسع السمات التالية بالإضافة إلى ملف json الأصلي:

 contact . AvatarUrl // 处理过的头像地址
contact . isSelf    // 是否是登录用户本人

contact . getDisplayName ( )
contact . canSearch ( keyword )

بالإضافة إلى ذلك، يوفر wechat4u جهة الاتصال كواجهة مشتركة لجهات الاتصال الموجودة على المثيل، مما يؤدي إلى توسيع الخصائص التالية:

 wechat . Contact . isRoomContact ( )
wechat . Contact . isSpContact ( )
wechat . Contact . isPublicContact ( )

wechat . Contact . getUserByUserName ( )
wechat . Contact . getSearchUser ( keyword )

يرث كل كائن msg من الواجهة/الرسالة ويمتلك السمات التالية بالإضافة إلى ملف json الأصلي:

 message . isSendBySelf // 是否是本人发送

message . isSendBy ( contact )
message . getPeerUserName ( ) // 获取所属对话的联系人 UserName
message . getDisplayTime ( ) // 获取形如 12:00 的时间戳信息