آموزش کار با چک کننده ی املا Spelling Checker در اندروید

برای استفاده از این چک کننده ی املا لازم است تا اینترفیس SpellCheckerSessionListener را اجرا کنید و متد های آن را به کار ببرید؛
سینتکس  آن را می توانید در زیر ببینید :

public class HelloSpellCheckerActivity extends Activity implements SpellCheckerSessionListener {
   @Override
   public void onGetSuggestions(final SuggestionsInfo[] arg0) {
      // TODO Auto-generated method stub
   }
   
   @Override
   public void onGetSentenceSuggestions(SentenceSuggestionsInfo[] arg0) {
      // TODO Auto-generated method stub
   }
}

پس از آن لازم است یک آبجکت از کلاس SpellCheckerSession ایجاد کنید.
با فراخوانی متد newSpellCheckerSession از کلاس TextServicesManager ، آبجکت ایجاد شده می تواند به عنوان نمونه قرار بگیرد.
این کلاس به متد بین اپلیکیشن و سرویس های متن (text service) رسیدگی می کند. همچنین نیاز است که سرویس سیستم را برای نمونه گذاری آن درخواست کنید.
سینتکس آن در زیر ارائه شده است  :

private SpellCheckerSession mScs;
final TextServicesManager tsm = (TextServicesManager) getSystemService(
Context.TEXT_SERVICES_MANAGER_SERVICE);
mScs = tsm.newSpellCheckerSession(null, null, this, true);   

آخرین کاری که باید انجام دهید، فراخوانی متد getSuggestions می باشد تا برای هر متن مورد نظرتان پیشنهاد (suggestion) داشته باشید. پیشنهاد ها به متد onGetSuggestions منتقل خواهند شد، جایی که شما هر کاری که می خواهید می توانید انجام دهید.

mScs.getSuggestions(new TextInfo(editText1.getText().toString()), 3);

این متد دو پارامتر را به عنوان ورودی  می گیرد.
اولین پارامتر، رشته ای به شکل آبجکت TextInfo می باشد و دومین پارامتر شماره ی cookie می باشد که برای مشخص کردن پیشنهاد ها استفاده می شود.
علاوه برا این متد ها ، متد های دیگری توسط کلاس SpellCheckerSession و برای پیشنهاد های بهتر ارائه می شوند. لیست این متد ها را در جدول زیر مشاهده می کنید :

1. ()cancel : حالت پندینگ (pending) را کنسل کرده و فعالیت چک کردن املا را اجرا می کند.

2. ()close : این متد session  را به پایان رسانده و به TextServicesManagerService اجازه می دهد تا از چک کننده املا جدا شود.

3. (getSentenceSuggestions(TextInfo[] textInfos, int suggestionsLimit : پیشنهاداتی از جملات مشخص شده می گیرد.

4. ()getSpellChecker : اطلاعات  spell checker service را که مربوط به این session از چک کننده باشد، می گیرد.

5. ()isSessionDisconnected : این متد True را بر می گرداند اگر اتصال به سرویس متن در این بخش قطع شده باشد.

مثال :

در اینجا مثالی ارائه می شود که استفاده از Spell Checker را توضیح می دهد. این مثال اپلیکیشن  پایه ای ایجاد می کند که به شما اجازه می دهد از چک کننده املا استفاده کرده و suggestion هایی دریافت کنید .

برای انجام این مثال می توانید آن را روی یک دستگاه حقیقی یا یک امولاتور هجرا کنید.

1. برای ایجاد یک برنامه ی اندروید از اندروید استودیو تحت پکیج  com.example.hellospellchecker استفاده کنید .
2. فایل src/MainActivity.java را برای افزودنکد های مورد نیاز  تغییر دهید.
3. res/layout/main را برای افزودن کامپوننت های XML مربوطه تغییر دهید.
4. اپلیکیشن را اجرا کرده و یک دستگاه اجرایی اندروید انتخاب کنید، اپلیکیشن را روی آن نصب کرده و نتایج را بررسی کنید.

محتوای تغییر یافته ی فایل src/MainActivity.java :

package com.example.sairamkrishna.myapplication;

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
import android.view.View;
import android.view.textservice.TextInfo;
import android.view.textservice.TextServicesManager;

import android.widget.Button;
import android.widget.EditText;

import android.view.textservice.SentenceSuggestionsInfo;
import android.view.textservice.SpellCheckerSession;
import android.view.textservice.SpellCheckerSession.SpellCheckerSessionListener;
import android.view.textservice.SuggestionsInfo;

import android.widget.TextView;
import android.widget.Toast;

public class MainActivity extends Activity implements SpellCheckerSessionListener  {
   Button b1;
   TextView tv1;
   EditText ed1;
   private SpellCheckerSession mScs;

   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      b1=(Button)findViewById(R.id.button);
      tv1=(TextView)findViewById(R.id.textView3);

      ed1=(EditText)findViewById(R.id.editText);
      b1.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            Toast.makeText(getApplicationContext(),
               ed1.getText().toString(),Toast.LENGTH_SHORT).show();
            mScs.getSuggestions(new TextInfo(ed1.getText().toString()), 3);
         }
      });
   }

   public void onResume() {
      super.onResume();
      final TextServicesManager tsm = (TextServicesManager)
         getSystemService(Context.TEXT_SERVICES_MANAGER_SERVICE);
      mScs = tsm.newSpellCheckerSession(null, null, this, true);
   }

   public void onPause() {
      super.onPause();
      if (mScs != null) {
         mScs.close();
      }
   }

   public void onGetSuggestions(final SuggestionsInfo[] arg0) {
      final StringBuilder sb = new StringBuilder();

      for (int i = 0; i < arg0.length; ++i) {
         // Returned suggestions are contained in SuggestionsInfo
         final int len = arg0[i].getSuggestionsCount();
         sb.append('\n');

         for (int j = 0; j < len; ++j) {
            sb.append("," + arg0[i].getSuggestionAt(j));
         }

         sb.append(" (" + len + ")");
      }
		
      runOnUiThread(new Runnable() {
         public void run() {
            tv1.append(sb.toString());
         }
      });
   }

   @Override
   public void onGetSentenceSuggestions(SentenceSuggestionsInfo[] arg0) {
      // TODO Auto-generated method stub
   }
}

محتوای تغییر یافته ی  res/layout/main.xml :

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
   xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent"
   android:layout_height="match_parent" android:paddingLeft="@dimen/activity_horizontal_margin"
   android:paddingRight="@dimen/activity_horizontal_margin"
   android:paddingTop="@dimen/activity_vertical_margin"
   android:paddingBottom="@dimen/activity_vertical_margin" tools:context=".MainActivity">
   
   <TextView android:text="Spell checker " android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textview"
      android:textSize="35dp"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Tutorials point"
      android:id="@+id/textView"
      android:layout_below="@+id/textview"
      android:layout_centerHorizontal="true"
      android:textColor="#ff7aff24"
      android:textSize="35dp" />
      
   <Button
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Suggestions"
      android:id="@+id/button"
      android:layout_alignParentBottom="true"
      android:layout_centerHorizontal="true" />
      
   <EditText
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/editText"
      android:hint="Enter Text"
      android:layout_above="@+id/button"
      android:layout_marginBottom="56dp"
      android:focusable="true"
      android:textColorHighlight="#ff7eff15"
      android:textColorHint="#ffff25e6"
      android:layout_alignRight="@+id/textview"
      android:layout_alignEnd="@+id/textview"
      android:layout_alignLeft="@+id/textview"
      android:layout_alignStart="@+id/textview" />
      
   <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:src="@drawable/abc"
      android:layout_below="@+id/textView"
      android:layout_centerHorizontal="true" />
      
   <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Suggestions"
      android:id="@+id/textView3"
      android:textSize="25sp"
      android:layout_below="@+id/imageView" />

</RelativeLayout>

محتوای res/values/string.xml:

<resources>
   <string name="app_name">My Application</string>
</resources>

محتوای فایل AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="com.example.sairamkrishna.myapplication" >
   
   <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      
      <activity
         android:name=".MainActivity"
         android:label="@string/app_name" >
         
         <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
         
      </activity>
      
   </application>
</manifest>

حال می خواهیم اپلیکیشن مورد نظر را اجرا کنیم .

فرض می کنیم که در هنگام انجام تنظیمات محیط ، AVD خود را ایجاد کرده اید. برای اجرای اپلیکیشن از اندروید استودیو ، یکی از فایل های اکتیویتی اپلیکیشن را باز کرده و روی آیکون Run در نوار ابزار  کلیک کنید. اندروید استدیو اپلیکیشن  را روی AVD نصب کرده و آن را اجرا می کند. اگر همه چیز در مورد برنامه و تنظیمات آن درست باشد، پنجره ی امولاتور زیر نمایش داده خواهد شد :

اکنون باید در فیلد ، هر متنی که می خواهید وارد کنید، من متنی وارد کردم و سپس دکمه ی suggestions را فشار دهید.  به همراه پیشنهاد ها، در AVD شما پیام زیر ظاهر خواهد شد :