आधे घंटे में iOS के लिए "रीडर" कैसे लिखें

तेजी से पढ़ने वाले क्वेशरीडर पर पोस्ट पढ़ने और तैयारी के बिना प्रति मिनट 500 शब्द पढ़ने के बाद, मैं इस विचार को अपने दम पर Apple स्मार्टफोन के लिए लागू करना चाहता था। ऐसा करने के लिए, मैंने एक एपीआई, स्रोत कोड विकसित किया, जो जीथब पर प्रकाशित हुआ।



एपीआई के कामकाज के सिद्धांत और इसके आधार पर स्पीड रीडिंग के लिए एक कार्यक्रम कैसे बनाया जाए, इसके बारे में मैं कट के तहत बताऊंगा

यह कैसे काम करता है?

स्प्रिट्ज़ के सिद्धांत और इसके रंग और स्थिति शब्दों के सिद्धांत द्वारा निर्मित एपीआई का आधार लिया गया था।
सबसे पहले, एपीआई एक दोहराए जाने वाले टाइमर को शुरू करता है जो प्रति सेकंड कई बार फायर करता है। टाइमर एक विधि कहता है जो अगले शब्द को अपने डेटा स्रोत से खींचने का अनुरोध करता है। वांछित शब्द प्राप्त करने के बाद, हमें पत्र की स्थिति का पता लगाना होगा, जिसे हम रंग देंगे। अनुभवजन्य अनुसंधान का उपयोग करना, यह स्थापित करना संभव था कि पत्र निम्नानुसार रंगीन हैं:

• शब्द की लंबाई 1. पत्र 1।
• शब्द की लंबाई 2-5 है। रंगीन अक्षर २।
• शब्द की लंबाई 6-9 है। रंगीन अक्षर 3।
• आदि

तदनुसार, वांछित पत्र की स्थिति सरलतम सूत्र द्वारा गणना की जाती है:

(([word length] + 6) / 4) - 1; 

स्थिति जानने के बाद, हम विभिन्न रंगों में अक्षरों को रंगने के लिए NSAttributedString का उपयोग करते हैं, मुख्य शब्द के लिए काला और उच्चारण अक्षर के लिए लाल।
अब आपको वांछित पत्र के केंद्र के निर्देशांक की गणना करने की आवश्यकता है। ऐसा करने के लिए, हम iOS के संस्करण के आधार पर sizeWithFont: या sizeWithAttributes: method का उपयोग करके वर्णों की चौड़ाई की गणना करते हैं।
छोटी चीजों के लिए, एक UILabel बनाएं, इसमें एक NSAttributedString डालें और समान तरीकों का उपयोग करके चयनित फ़ॉन्ट के लिए गणना की गई चौड़ाई के साथ फ्रेम सेट करें। परिणामी UILabel और उच्चारण पत्र के केंद्र की स्थिति RRTargetView वर्ग को पारित कर दी जाती है, जो लक्ष्य को प्रदान करने में लगी हुई है, जो वांछित पत्र पर ध्यान केंद्रित करने में मदद करती है, और इस लक्ष्य के भीतर UILabel की स्थिति निर्धारित करती है।

आपका पाठक लेखन

अब जीथब पर प्रकाशित एपीआई के बारे में थोड़ा और अधिक, जिसका उपयोग हम अपने कार्य को लागू करने के लिए करेंगे।
RRViewController क्लास तैयार की जाने वाली स्ट्रिंग बनाने के लिए जिम्मेदार है। कक्षा में निम्नलिखित सार्वजनिक गुण और विधियाँ हैं:

पढ़ना शुरू / रोकें।

 - (void)startReading; - (void)pauseReading; 

नकारात्मक या सकारात्मक मान प्रेषित करके पढ़ने की गति बदलें। गति को प्रति मिनट शब्दों में मापा जाता है।

 - (void)changeSpeed:(int)speedModification; 

वर्तमान आकार के सापेक्ष फ़ॉन्ट आकार बदलने को नकारात्मक या सकारात्मक मान भी दिया जाता है। थ्रेसहोल्ड 16 से 100 तक सेट किए गए हैं।

 - (void)changeFont:(int)fontModification; 

साथ ही दो गुण जो आरआरव्यूकंट्रोलर वर्ग के डेलिगेट और डेटा स्रोत प्रोटोकॉल को लागू करने वाली वस्तुओं के संदर्भ में संग्रहीत करते हैं।

 @property (nonatomic, weak) id <RRViewControllerDataSource> dataSource; @property (nonatomic, weak) id <RRViewControllerDelegate> delegate; 

टारगेट रेंडरिंग और टेक्स्ट पोजिशनिंग RIVTargetView वारिस द्वारा UIView क्लास को की जाती है। कक्षा में एक सार्वजनिक विधि और एक संपत्ति होती है।
0.0 से 1.0 तक की सीमा में एक बिंदु सेट करता है जिस पर लक्ष्य पर एक ऊर्ध्वाधर पायदान खींची जाती है, पाठ इस बिंदु के सापेक्ष स्थित है। डिफ़ॉल्ट मान 1/3 है।

 @property (nonatomic) CGFloat horizontalAccentPosition; 

विधि पाठ के साथ एक UILabel स्वीकार करती है। एक्सेंटेंट पॉइंट वह बिंदु है जिसे ऊर्ध्वाधर पायदान के साथ संरेखित किया जाएगा।

 - (void)positionLabel:(UILabel *)label withAccentPoint:(CGPoint)point; 

छवि उदाहरण


दो प्रोटोकॉल भी हैं।
RRViewControllerDelegate प्रोटोकॉल

दोनों विधियां वैकल्पिक हैं, फ़ॉन्ट आकार और पढ़ने की गति के बारे में एक अधिसूचना प्राप्त करने के लिए उनकी आवश्यकता होती है।

 - (void)reportFontSize:(CGFloat)size; - (void)reportReadingSpeed:(NSUInteger)speed; 

RRViewControllerDataSource प्रोटोकॉल
वैकल्पिक तरीके:

 - (NSString *)longestWordWithFont:(UIFont *)font; 

पाठ में सबसे लंबे शब्द RRViewController के लिए विधि वापस आती है, यह काम करने के लिए स्वचालित फ़ॉन्ट आकार चयन प्रणाली के लिए आवश्यक है। इसके अलावा, स्वचालित पाठ चयन प्रणाली के काम करने के लिए, आपको [NSUserDefaults standardUserDefaults] में auto_text_size कुंजी के लिए बूलियन मान YES सेट करने की आवश्यकता है।

 - (NSString *)previousWord; 

पिछले शब्द को प्राप्त करने के लिए एक विधि, यदि अपरिचित शब्द पाठ में पाया जाता है और आप मैन्युअल रूप से उस पर वापस लौटना चाहते हैं।

दो आवश्यक तरीके:

 - (NSString *)nextWord; 

RRViewController अगले शब्द को प्रदर्शित करने के लिए डेटा मॉडल पर सवाल उठाता है।

 - (NSString *)currentWord; 

वर्तमान शब्द का अनुरोध किया जाता है, उदाहरण के लिए, यदि पाठ को फिर से लिखने के लिए फ़ॉन्ट को बदल दिया जाता है।

---

अच्छा, अब अपना पाठक लिखो।
सबसे पहले, एक प्रोजेक्ट (सिंगल व्यू एप्लिकेशन) बनाएं, इसे एक सामंजस्यपूर्ण नाम दें, उदाहरण के लिए, सुपर फास्ट रीडर।



अब हम एपीआई को परियोजना में निर्यात करते हैं, जिसे हम जीथूब से डाउनलोड करते हैं, यह पाठ रेंडर करने में लगा रहेगा।

स्टोरीबोर्ड खोलें, जहां डिफ़ॉल्ट UIViewController मौजूद है। इसमें एक कंटेनर जोड़ें, कंटेनर में रखा नियंत्रक वर्ग के रूप में, RRViewController निर्दिष्ट करें। हमें पाठ को नियंत्रित और दर्ज करने के लिए तत्वों की भी आवश्यकता होगी। "प्रारंभ", "रोकें" बटन जोड़ें, एक टेक्स्ट इनपुट फ़ील्ड UITextView, UIView, जिसमें उन्हें समूहीकृत करने के लिए सभी नियंत्रणों को रखा जाएगा, साथ ही UIScrollView जिसमें हम कंटेनर और UIView को नियंत्रण के साथ रखेंगे। अब हम इन तत्वों को एप्लिकेशन कोड के साथ जोड़ते हैं। हम शुरू और ठहराव बटन के क्लिक को संभालने के लिए UItextView और UIScrollView के लिए एक IBOutlet और दो IBAction बनाते हैं।

 @property (weak, nonatomic) IBOutlet UITextView *textView; @property (weak, nonatomic) IBOutlet UIScrollView *scrollView; - (IBAction)startReading:(UIButton *)sender; - (IBAction)pauseReading:(UIButton *)sender; 

स्टोरीबोर्ड देखें


पदानुक्रम देखें


यह RRViewController के साथ काम करने का समय है।
पहली बात यह है कि इसके लिए एक लिंक प्राप्त करें। कंटेनर बनाते समय, एक "एंबेड सीग्यू" स्वचालित रूप से बनाया गया था, इसे एक नाम निर्दिष्ट करें InterfaceBuilder के माध्यम से, उदाहरण के लिए, RVCBecomesChild। कार्यक्रम के निष्पादन के समय, कंटेनर में RRViewController को जोड़ने के लिए तैयार होगाफॉरसेग: प्रेषक: विधि, जिसे हम उपयोग करेंगे।

सबसे पहले, एक संपत्ति बनाएं जिसमें ऑब्जेक्ट का संदर्भ संग्रहीत किया जाएगा:

 @property (weak, nonatomic) RRViewController *readingVC; 

अब हम इस विधि को लागू करते हैं:

 - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender { if ([segue.identifier isEqualToString:@"RVCBecomesChild"]) { self.readingVC = segue.destinationViewController; } } 

नियंत्रक का एक लिंक है। आगे क्या है?
और फिर आपको RRViewControllerDataSource प्रोटोकॉल की आवश्यक विधियों को RRViewController वर्ग के लिए लागू करने की आवश्यकता है:

 - (NSString *)nextWord; - (NSString *)currentWord; 

पहली चीज जो हमें करने की ज़रूरत है, वह है आरआरएवीकंट्रोलर को बताएं कि हम उसके डेटा स्रोत हैं।

 - (void)viewDidLoad { [super viewDidLoad]; self.readingVC.dataSource = self; } 

संकलक को यह बताना न भूलें कि हम प्रोटोकॉल का समर्थन करते हैं:

 @interface SFRViewController () <RRViewControllerDataSource> 

यह आवश्यक है ताकि कंपाइलर self.readingVC.dataSource = self को असाइन करते समय एक चेतावनी न दे, और यह भी कि हमें चेतावनी मिले यदि @required के रूप में चिह्नित सभी तरीके हमारे द्वारा लागू नहीं किए गए थे।

हम UITextView फ़ील्ड से पढ़ने के लिए पाठ लेंगे, इसके अलावा हमें एक चर की आवश्यकता होगी जो पाठ में वर्तमान स्थिति प्रदर्शित करेगा।

 @property (nonatomic) NSUInteger currentWord; - (NSString *)nextWord { self.textPosition++; NSArray *words = [self.textView.text componentsSeparatedByCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]]; if (self.textPosition >= [words count]) { self.textPosition = 0; } return [words objectAtIndex:self.textPosition]; } - (NSString *)currentWord { NSArray *words = [self.textView.text componentsSeparatedByCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]]; if (self.textPosition >= [words count]) { self.textPosition = 0; } return [words objectAtIndex:self.textPosition]; } 

सबसे उचित कार्यान्वयन नहीं, क्योंकि जब हम प्रत्येक शब्द को क्वेरी करते हैं, तो हम पूरे पाठ को पार्स करते हैं, पाठ को बदलते समय एक बार ऐसा करना बेहतर होता है, और परिणाम को एक चर में संग्रहीत करता है। इसे किस विधि से लागू किया जा सकता है, इसके बारे में मैं थोड़ी देर बाद लिखूंगा।
अब हम बटन के लिए क्रियाओं को कार्यान्वित करते हैं, इसके लिए यह RRViewController वर्ग के तरीकों को कॉल करेगा।

 - (IBAction)startReading:(UIButton *)sender { [self.readingVC startReading]; } - (IBAction)pauseReading:(UIButton *)sender { [self.readingVC pauseReading]; } 

हो गया। आप कार्यक्रम को चला सकते हैं और परिणाम का आनंद ले सकते हैं।

यह बग नहीं है, यह एक विशेषता है

आप तुरंत देख सकते हैं कि गति काफी धीमी है, और फ़ॉन्ट छोटा है। यह समस्या बहुत आसानी से हल हो जाती है। RRViewController तरीकों को कॉल करने वाले बटन बनाएँ। विधि के तर्क के रूप में, नकारात्मक या सकारात्मक पूर्णांक पारित किए जाते हैं जो इंगित करते हैं कि इन मापदंडों को कितना बदलना चाहिए।

 - (void)changeSpeed:(int)speedModification; - (void)changeFont:(int)fontModification; 

इन विधियों का कार्यान्वयन आपके विवेक पर छोड़ दिया जाएगा, और हम एक और समस्या का समाधान करेंगे।

हमारे कार्यक्रम में, जब आप पाठ जोड़ने की कोशिश करते हैं, तो कीबोर्ड इनपुट क्षेत्र को ओवरलैप करता है, और जब आप Enter दबाते हैं तो कीबोर्ड स्पष्ट नहीं होता है, (जो आम तौर पर सही होता है, क्योंकि UITextView का उपयोग बहु-पंक्ति पाठ में प्रवेश करने के लिए किया जाता है और Enter कुंजी को दबाने से पाठ में एक पंक्ति विराम वर्ण सम्मिलित होता है, लेकिन हम इस व्यवहार को बदल सकते हैं)।
इस समस्या को हल करने के लिए, हमें पाठ क्षेत्र से प्रतिक्रिया प्राप्त करने की आवश्यकता है। ऐसा करने के लिए, उसे बताएं कि हमारा ViewController वर्ग UITextView वर्ग का एक सौदा है और इसके प्रोटोकॉल को लागू करता है।

 @interface SFRViewController () <RRViewControllerDataSource, UITextViewDelegate> 

हमें कीबोर्ड से संदेश प्राप्त करने के लिए सदस्यता लेने की भी आवश्यकता है, साथ ही इसकी उपस्थिति के बारे में एक संदेश के साथ, हमें एक शब्दकोष मिलेगा जिसमें इसके वर्तमान आकार होंगे, जिसे हमें UIScrollView ऑफसेट की गणना करने की आवश्यकता होगी।

 - (void)viewDidLoad { [super viewDidLoad]; self.readingVC.dataSource = self; self.textView.delegate = self; [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(keyboardWasShown:) name:UIKeyboardWillShowNotification object:nil]; } 

अगला, हम उन दो विधियों को लागू करते हैं जिनकी हमें आवश्यकता है।
सबसे पहले, वह विधि जिसे कीबोर्ड दिखाई देने पर कहा जाएगा:

 - (void)keyboardWasShown:(NSNotification *)notification { CGSize keyboardSize = [[[notification userInfo] objectForKey:UIKeyboardFrameBeginUserInfoKey] CGRectValue].size; [self.scrollView setContentInset:UIEdgeInsetsMake(-keyboardSize.height, 0, 0, 0)]; } 

अब हम पाठ परिवर्तन को संसाधित कर रहे हैं। यदि लाइन ब्रेक वर्ण "\ n" डाला गया है, तो कीबोर्ड को हटा दें और UIScrollView के लिए लंबवत ऑफसेट को हटा दें। वैसे, एक ही विधि में, आप एक स्ट्रिंग के पार्सिंग को लागू कर सकते हैं ताकि पाठ बदलते समय इसे एक बार निष्पादित किया जाए।

 - (BOOL)textView:(UITextView *)textView shouldChangeTextInRange:(NSRange)range replacementText:(NSString *)text { if ([text isEqualToString:@"\n"]) { [textView resignFirstResponder]; } return YES; } 

हम फिर से शुरू करते हैं। यह काम करता है! आप परिणाम का आनंद ले सकते हैं और अपने स्वयं के विचारों के कार्यान्वयन में संलग्न हो सकते हैं।
स्वाभाविक रूप से, इस लेख ने डेटा प्राप्त करने का सबसे आसान तरीका दिखाया, एक अधिक सक्षम कार्यान्वयन के मामले में, यह एक अलग वर्ग बनाने के लायक है जो डेटा पार्स करने और प्रदान करने में लगे होंगे।

अंतभाषण

एपीआई विकास / परिशोधन चरण में है, इसलिए मुझे इसे बदलने के लिए किसी भी टिप्पणी और सुझाव को स्वीकार करने, या रिपॉजिटरी को फोर्क करने और अपने तरीके से परिवर्तन करने में खुशी होगी।

अच्छा पढ़ लो!