JoyPro2 Discord GitHub
Έργο

Από το JoyPro 1 στο JoyPro 2

Εμφάνιση:

Το JoyPro 1 (2021 έως 2023) ήταν ένα εργαλείο για το DCS: δημιουργούσε σχέσεις ανάμεσα στις εισόδους διαφορετικών αεροσκαφών και τις αντιστοίχιζε στην ίδια θέση στο stick. Το JoyPro 2 κρατά ακριβώς αυτή την ιδέα και το ίδιο μοντέλο σχέσης / αντιστοίχισης / τροποποιητή (ένα προφίλ του JoyPro 1 ανοίγει στο JoyPro 2) και ξαναχτίζει τα πάντα γύρω της: ένα νέο περιβάλλον, μια μηχανή που λειτουργεί και αυτόνομα, δεκάδες παιχνίδια, ελέγχους για κάθε λειτουργία και πολλή ασφάλεια.

#Οι αριθμοί

Όλοι οι αριθμοί μετρήθηκαν στον πηγαίο κώδικα και των δύο έργων (αρχεία που παρακολουθούνται στο git· γραμμές κώδικα = μη κενές γραμμές C# που δεν είναι σχόλια). Οι αριθμοί του JoyPro 2 προέρχονται από το build αυτού του ιστότοπου.

JoyPro 1 JoyPro 2
Ανάπτυξη 2021-02-11 έως 2023-11-15 από 2026-09-30
Commits 336 1,406
Γραμμές κώδικα C# 25,502 354,663 (13.9 x)
Αρχεία C# 77 954
Τύποι (κλάσεις, records, enums ...) 106 3,059 (29 x)
Μέθοδοι 450 16,702 (37 x)
Αυτοματοποιημένα τεστ (μονάδας, view model, απόδοσης εικόνας) 0 1,537 σε 198 αρχεία τεστ
Μέρη του smoke test της μηχανής (πραγματική μηχανή σε φακέλους δοκιμής) 0 87
Projects στο solution 2 12
Γραμμές σήμανσης διεπαφής 973 (WPF XAML) 17,250 (Avalonia AXAML)
Γραμμές τεκμηρίωσης (Markdown) 109 25,636
Παιχνίδια 1 (DCS), αργότερα IL-2 36 υποστηρίζονται από το JoyPro, 57 τίτλοι ερευνήθηκαν
Γλώσσες διεπαφής 1 39
Εντολές μηχανής (γραμμή εντολών) καμία (μόνο γραφικό περιβάλλον) 451 σε 60 περιοχές, 19 γενικές επιλογές
Στοιχεία ελέγχου του γραφικού περιβάλλοντος που τεκμηριώνονται σε αυτόν τον ιστότοπο 1097

Πού βρίσκεται ο κώδικας στο JoyPro 2 (γραμμές κώδικα C#): μηχανή 187,202, γραφικό περιβάλλον 80,286, τεστ γραφικού περιβάλλοντος 56,600, ανάδραση δύναμης 14,394.

flowchart LR
  W["Ένα παράθυρο<br/>(οθόνη και λογική<br/>μαζί)"] --> D1["Αρχεία DCS"]
JoyPro 1: ένα παράθυρο που έκανε τα πάντα, για το DCS.
flowchart TB
  G["Το παράθυρο"] --> E["Η μηχανή<br/>(εκτελεί κάθε ενέργεια)"]
  G --> F["Βοηθός<br/>ανάδρασης δύναμης"]
  G --> V["Βοηθός<br/>εικονικού joystick"]
  T["Παρακολούθηση<br/>στην περιοχή ειδοποιήσεων"] --> E
  E --> D2["36 παιχνίδια"]
  F ~~~ V
JoyPro 2: ένα παράθυρο που αναθέτει κάθε ενέργεια στη μηχανή, με βοηθούς για την ανάδραση δύναμης, το εικονικό joystick και την παρακολούθηση.
Για αρχάριους

#Τι είναι καλύτερο για εσάς

  • Πολλά παιχνίδια, ένα προφίλ. Το JoyPro 1 ήταν για το DCS. Το JoyPro 2 κάνει εισαγωγή και εξαγωγή για 36 τίτλους παιχνιδιών: DCS, IL-2 (Great Battles, Korea, 1946, Cliffs of Dover), Star Citizen, MSFS 2020 και 2024, X-Plane 11 και 12, Falcon BMS, War Thunder, Elite Dangerous, X4, Arma και άλλα. Μία σχέση κρατά την ίδια λειτουργία σε όλα αυτά.
  • Ξεκινήστε από ό,τι έχετε. Η εισαγωγή διαβάζει τις υπάρχουσες αντιστοιχίσεις σας από κάθε παιχνίδι· η ρύθμιση της πρώτης εκκίνησης βρίσκει μόνη της τα παιχνίδια σας.
  • Τίποτα δεν χαλάει οριστικά. Κάθε εξαγωγή κρατά πρώτα αντίγραφο ασφαλείας των αρχείων του παιχνιδιού και η Αναίρεση τελευταίας εξαγωγής τα επαναφέρει byte προς byte. Κάθε αλλαγή στο JoyPro αποθηκεύεται αυτόματα και μπορεί να αναιρεθεί, ακόμη και μετά από επανεκκίνηση (ιστορικό προφίλ).
  • Σας λέει τι θα πήγαινε στραβά. Ο Έλεγχος εξηγεί τα προβλήματα με λέξεις του παιχνιδιού και τα διορθώνει με ένα κλικ.
  • Ρυθμίζεται μόνο του. Το Ρύθμισέ τα όλα για μένα βάζει τις σημαντικές λειτουργίες στο stick, τη μανέτα και τα πετάλια σας. Κοιτάτε τη λίστα και πατάτε Χρήση αυτών των κουμπιών και Εγγραφή στο παιχνίδι μου.
  • Λιγότερα κλικ. Οι προτάσεις, η Αυτόματη ομαδοποίηση, η Αυτόματη ανάθεση, ο οδηγός ρύθμισης και ένας βοηθός JoyPro φτιάχνουν σχέσεις και αντιστοιχίσεις για εσάς· ένα «δικό σας στυλ» που μαθαίνει ακολουθεί τον τρόπο που το κάνατε πριν.
  • Προσέχει τις αλλαγές. Όταν αλλάζετε μια αντιστοίχιση μέσα σε ένα παιχνίδι, το JoyPro ρωτά μόλις κλείσει το παιχνίδι αν θα την πάρει στο προφίλ σας.
  • Η γλώσσα σας. Η διεπαφή μιλά 39 γλώσσες.
  • Περισσότερα από αντιστοιχίσεις. Εικόνες συσκευών και φύλλα αναφοράς, HUD και επικάλυψη για streaming, ανάδραση δύναμης από telemetry, ένα εικονικό joystick για παιχνίδια που διαβάζουν μόνο μία συσκευή, ένα ψεύτικο χειριστήριο (εικονικό Xbox pad) για παιχνίδια που γνωρίζουν μόνο χειριστήριο Xbox, μια βάση δεδομένων πιλοτηρίων, στατιστικά για το τι πετάτε.
  • Βοήθεια σε κάθε κουμπί. Το F1 εξηγεί οποιοδήποτε κουμπί, οι περιηγήσεις δείχνουν τα πραγματικά κουμπιά και οι Απλές λέξεις τα κρατούν σύντομα.
  • Χωρίς επιπλέον runtimes για ψάξιμο. Η έκδοση είναι ένα zip με όλα μέσα· χωρίς SlimDX, χωρίς C++ runtimes.
Για προχωρημένους

#Λειτουργία προς λειτουργία

Τομέας JoyPro 1 JoyPro 2
Σχέσεις με το χέρι, ids του DCS με το χέρι με αναζήτηση σε κάθε παιχνίδι, συνώνυμα, τον κατάλογο λειτουργιών, προτάσεις με αιτιολογία, Αυτόματη ομαδοποίηση, ομαδοποίηση κατά περιγραφή, βοηθό· «ίδιο id, διαφορετική σημασία» ανά αεροσκάφος του DCS
Αντιστοιχίσεις καταγραφή κουμπιού ή άξονα καταγραφή, παρακολούθηση εισόδου, αντιστοίχιση πάνω στην εικόνα της συσκευής, Αυτόματη ανάθεση για κάθε συνδυασμό συσκευών, οδηγός ρύθμισης, Διάταξη με AI
Ρύθμιση αξόνων καμπυλότητα DCS, νεκρή ζώνη, κορεσμός ανά παιχνίδι στο δικό του μοντέλο απόκρισης, εύρη ανά αεροσκάφος, βαθμονόμηση, λειτουργία εγκοπής (detent)
Τροποποιητές ναι ναι, με σελίδα τροποποιητών, συνδυασμούς, μετάφραση ανά παιχνίδι (BMS shift, ...)
Εξαγωγή DCS (clean, nuke) κάθε παιχνίδι· τέσσερις λειτουργίες συν «επίσης καθαρισμός», ανά αεροσκάφος, ελάχιστη διαφορά από τις προεπιλογές του DCS, σημάδια για αντιστοιχίσεις που δεν γράφτηκαν, αντίγραφα ασφαλείας και αναίρεση
Εισαγωγή DCS κάθε παιχνίδι, με προεπιλογές, πληκτρολόγιο, συγχώνευση συσκευών, επανεισαγωγή ονομάτων/ομάδων/τροποποιητών
Ασφάλεια «φτιάξτε μόνοι σας αντίγραφο ασφαλείας» αυτόματα αντίγραφα ασφαλείας με εκδόσεις, άρνηση εγγραφής όσο τρέχει ένα παιχνίδι, ιστορικό προφίλ με αναίρεση από συνεδρία σε συνεδρία, sandbox εγγραφής στις δοκιμές
Έλεγχοι επικύρωση ο Έλεγχος: κάρτες με τις λέξεις του παιχνιδιού, διορθώσεις με ένα κλικ, αιτία από το ιστορικό
Διατάξεις εξαγωγή εικόνων διάταξης εικόνες αναφοράς συσκευών (ακριβές μοντέλο μέσω VID:PID και ονόματος HID), φύλλα αναφοράς, τρισδιάστατες προβολές συσκευών
Επικάλυψη επικάλυψη μέσα στο παιχνίδι σχεδιαστής HUD, επικάλυψη, σελίδα stream για το OBS, ζωντανές είσοδοι
Λίστα παιχνιδιών βάση δεδομένων που συνοδεύει το πρόγραμμα (html) δημιουργείται στον υπολογιστή σας από τη δική σας εγκατάσταση, ανανεώνεται μετά από ενημερώσεις παιχνιδιών
Παρακολούθηση κανένας παρακολούθηση ρυθμίσεων παιχνιδιών με εφαρμογή στην περιοχή ειδοποιήσεων, ρωτά αφού κλείσει το παιχνίδι
Ανάδραση δύναμης κανένας ανάδραση δύναμης από τηλεμετρία για DCS, IL-2, War Thunder και άλλα (JoyPro.Ffb)
Εικονικές συσκευές κανένας vJoy / λειτουργία χειριστηρίου Xbox με HidHide, εικονικές λειτουργίες, εισαγωγή από Joystick Gremlin
Γλώσσες Αγγλικά 39
Ενημερώσεις λήψη με το χέρι έλεγχος ενημερώσεων με σημειώσεις έκδοσης, εγκατάσταση με επαλήθευση checksum
Αναφορές προβλημάτων ρωτήστε στο Discord ένα αρχείο υποστήριξης με αρχεία καταγραφής, ρυθμίσεις και (κατόπιν αιτήματος) το προφίλ· ο φάκελος χρήστη αντικαθίσταται· τίποτα δεν ανεβαίνει
Τεχνικές λεπτομέρειες

#Αρχιτεκτονική και ποιότητα

  • Χωρισμός σε μηχανή και GUI. Το JoyPro 1 ήταν μία εφαρμογή WPF με τη λογική μέσα στον κώδικα του παραθύρου. Το JoyPro 2 έχει μια μηχανή (engine.exe, .NET Framework 4.8, απλή C#) που περιέχει όλη τη λογική προφίλ, εισαγωγής/εξαγωγής και βάσης δεδομένων ως 451 εντολές, και ένα GUI Avalonia (.NET 9) που εκτελεί τη μηχανή για κάθε ενέργεια. Οι γρήγορες διαδραστικές εντολές πηγαίνουν σε ένα engine serve που τρέχει συνεχώς, ώστε το GUI να μένει γρήγορο χωρίς να χάνεται ο διαχωρισμός. Ό,τι κάνει το GUI μπορεί να γίνει και με script (δείτε τη γραμμή εντολών της μηχανής).
  • Ξεχωριστές διεργασίες για μόνιμες εργασίες: JoyPro.Ffb.exe (ανάδραση δύναμης από τηλεμετρία), JoyPro.VJoy.exe (η προώθηση στο εικονικό joystick), JoyPro.Tray.exe (η παρακολούθηση όσο το GUI είναι κλειστό), η καθεμία με όρια πόρων και δοκιμές αντοχής, ώστε να μη γίνονται αντιληπτές στο παρασκήνιο.
  • Δοκιμές: 1,537 αυτοματοποιημένες δοκιμές (xUnit: λογική μηχανής, view models, αποδόσεις σελίδων εκτός οθόνης σε φωτεινό και σκούρο θέμα), 87 μέρη smoke test της μηχανής που εκτελούν την πραγματική μηχανή σε φακέλους δοκιμής, μια προαιρετική πύλη ποιότητας με ελέγχους αναλλοίωτων σε πραγματικά δεδομένα, και δοκιμές από άκρη σε άκρη μέσα στο παιχνίδι για τα παιχνίδια που τις υποστηρίζουν. Οι δοκιμές τρέχουν σε sandbox εγγραφής με έλεγχο αποτυπώματος των πραγματικών φακέλων, ώστε καμία δοκιμή να μην μπορεί να αγγίξει πραγματικούς φακέλους παιχνιδιών.
  • Δεδομένα: οι λίστες εντολών των παιχνιδιών δημιουργούνται στον υπολογιστή του χρήστη από το εγκατεστημένο παιχνίδι στο %LOCALAPPDATA%\JoyPro2\GameData· το JoyPro συνοδεύεται μόνο από τα δικά του δεδομένα (κατάλογος λειτουργιών, κατάλογος συσκευών, πίνακες μετατροπής, βάση δεδομένων πιλοτηρίων).
  • Τεκμηρίωση από τον πηγαίο κώδικα: ο πίνακας υποστήριξης παιχνιδιών προέρχεται από τον κώδικα (engine games support), η αναφορά CLI από το engine --help, και αυτός ο ιστότοπος από τα AXAML, τα view models και την τεκμηρίωση.