VTubeStudioBlendshapeUDPReceiverTest
1.0.0
يمكنك طلب تلقي بيانات التتبع من تطبيق VTube Studio iPhone. تتضمن هذه البيانات أشكال المزيج وتدوير الرأس وموضع الرأس والمزيد. يتم طلب البيانات وإرسالها عبر UDP.
تستخدم تطبيقات مثل VSeeFace وVBridger هذا.
أنت بحاجة إلى جهاز iPhone أو iPad يعمل بنظام VTube Studio. تأكد من تشغيل خيار "3rd Party PC Clients" . إنه في أسفل علامة تبويب الإعدادات الأولى. يؤدي هذا إلى بدء تشغيل مستمع UDP على iPhone ويكون التطبيق جاهزًا الآن لإرسال البيانات إليك عبر الشبكة المحلية عندما تطلبها.
يمكنك طلب الحصول على بيانات التتبع المرسلة لمدة تصل إلى 10 ثوانٍ. للقيام بذلك، أرسل حمولة السلسلة التالية إلى iPhone (المنفذ 21412 أو أي شيء يتم عرضه في تطبيق iOS) عبر UDP:
{
"messageType" : " iOSTrackingDataRequest " ,
"time" : 2.5 ,
"sentBy" : " MyApp " ,
"ports" : [ 11125 , 11126 ]
} يخبر حقل time تطبيق iOS بالمدة التي سيستغرقها إرسال البيانات. تتراوح القيم المسموح بها بين 0.5 and 10 ثوانٍ. تأكد من إرسال هذا الطلب بشكل متكرر كل بضع ثوانٍ لمواصلة تلقي البيانات. على سبيل المثال، يمكنك إرسال طلب واحد في الثانية مع ضبط time على 5 حتى تستمر بيانات التتبع في الوصول. عند الانتهاء، فقط توقف عن إرسال الطلب.
عندما يتلقى تطبيق iOS هذا الطلب، فإنه سيرسل حزم بيانات UDP إلى عنوان IP الذي أرسل الطلب.
سيتم إرسال البيانات إلى المنافذ التي أدرجتها في الطلب، لذا تأكد من أن لديك UDP server مفتوحًا على هذه المنافذ. يجب عليك إدراج منفذ واحد على الأقل ويمكنك إدراج ما يصل إلى 32 منفذًا. وهذا حتى تتمكن من تشغيل تطبيقات متعددة على جهاز كمبيوتر واحد وتتلقى جميعها البيانات على منافذ مختلفة.
يجب أن يحتوي الحقل sentBy على اسم التطبيق الخاص بك ويستخدم حاليًا للتسجيل فقط. يجب أن يتراوح طوله بين 1 و64 حرفًا.
ستتلقى البيانات التالية في كل إطار (عادة بمعدل 60 إطارًا في الثانية ما لم يكن هناك تأخير في تطبيق iPhone):
يمكن العثور على تفاصيل حول الحمولة الدقيقة هنا: Payload Definition
قد تتم إضافة بعض الحقول إلى هذه الحمولة في المستقبل، لذا تأكد من عدم فشل رمز إلغاء التسلسل الخاص بالحمولة النافعة عند مواجهة حقول غير معروفة.
يمكن العثور على شرح تفصيلي لجميع أشكال المزج هنا: Apple iOS Blendshape Info
يحتوي هذا المستودع على مثال لمشروع Unity يوضح كيفية طلب بيانات التتبع.
تأكد من استبدال <YOUR-IPHONE-IP-HERE> في مكون VTubeStudioReceiveDataExample بعنوان IP الخاص بجهاز iPhone/iPad الخاص بك. إذا لم يتمكن من الاتصال، فتحقق من إعدادات جدار الحماية/برنامج مكافحة الفيروسات لديك.
| ملف | وصف |
|---|---|
VTSARKitBlendshape.cs | التعداد مع جميع أشكال مزيج iOS البالغ عددها 52. |
VTubeStudioUDPDataRequest.cs | حمولة الطلب التي يتعين عليك إرسالها إلى تطبيق iOS. |
VTubeStudioRawTrackingData.cs | الحمولة التي ستتلقاها من تطبيق iOS تحتوي على بيانات التتبع والمزيد. قد تتم إضافة بعض الحقول إلى هذه الحمولة في المستقبل، لذا تأكد من عدم فشل رمز إلغاء التسلسل الخاص بالحمولة النافعة عند مواجهة حقول غير معروفة. |
VTubeStudioBlendshapeDataReceiver.cs | مكون يمكنك استخدامه في تطبيقك لطلب البيانات والحصول على إشعار عند وصول بيانات جديدة من تطبيق iOS أو عند الضغط على مفتاح التشغيل السريع الذي يظهر على الشاشة. |
Example/VTubeStudioReceiveDataExample.cs | مثال للمكون الذي يستخدم VTubeStudioBlendshapeDataReceiver لطلب البيانات ثم عرضها. |
