Welcome to the support page for the Hanzi Matching App! This app is designed to help you learn Chinese characters from the 暨南中文 books 1-9 (lessons 1-12 each) through interactive study and game modes. If you have any issues or questions, this page provides guidance. If you need further assistance, feel free to contact us at jasmine_zeng@yahoo.com.
Study Mode: Review individual characters with their Hanzi, Pinyin, and English meaning. Ideal for memorization.
Game Mode: Play matching games to test your knowledge of Pinyin or meanings, with scoring and time-based bonuses.
The app uses data from lessons 1-12 across books 1-9 of 暨南中文. No internet is required once installed.
iOS 16.6 or later.
Compatible with iPhone and iPad.
Open the app and select the book volume (1-9).
Choose between "Study Mode" or "Game Mode".
For Study Mode:
Select a course (1-12) corresponding to the lesson in the chosen book.
The app will load and shuffle all words from that lesson.
For Game Mode:
Choose "Pinyin Matching" or "Meaning Matching".
Select the number of pairs (20, 30, or 50).
Choose courses finished (0-12) to include words up to that lesson in the current book, prioritizing the latest lesson, with previous books as fallback.
Tap "Start" to begin.
Cards display the Hanzi (large font), Pinyin, and Meaning in dark purple text.
Swipe left or right to navigate through the shuffled cards.
No scoring or timers—just review at your own pace.
If a lesson has fewer words than expected, that's based on the textbook content.
Left side: Hanzi cards.
Right side: Shuffled Pinyin or Meanings (depending on your choice).
Select one from left and one from right to match.
Correct match: +1 point, cards removed, new pair added if available.
Wrong match: -1 point.
Deselect by tapping the same card again.
Track pairs left in the header.
Game ends when all pairs are matched.
Final score includes matching points plus/minus time adjustment (faster = bonus, slower = penalty). Fireworks for new high scores!
High scores are saved locally.
Ensure your device is updated to the latest iOS version.
Restart the app or device.
Check for app updates in the App Store.
If JSON files (lesson data) are missing, reinstall the app.
Verify the selected book and course have data (books 1-9, lessons 1-12).
For Game Mode with courses=0, it uses previous books' combined data.
If error messages appear (e.g., "Failed to load JSON"), contact support with the exact message.
Matches: +1 for correct, -1 for incorrect.
Time adjustment: Based on 5 seconds per pair baseline. Bonus for faster, penalty for slower.
High score updates only if new score is higher.
Background or colors not displaying correctly: The app enforces light mode; check device settings if issues persist.
Fireworks not showing on new high score: Ensure animations are enabled in iOS settings.
No, the app uses predefined data from 暨南中文 books 1-9. Custom content is not supported.
No, this is a single-player offline app.
High scores are saved locally using UserDefaults. No personal data is collected.
Go to device Settings > [App Name] > Reset High Score (if available), or uninstall/reinstall the app.
For bugs, suggestions, or other support:
Email: jasmine_zeng@yahoo.com
Include your device model, iOS version, and a description of the issue.
Thank you for using Hanzi Matching App! Happy learning!