Initial commit

README.md

@@ -0,0 +1,11 @@
+### Tuts+ Tutorial: Use Text-to-Speech on Android to Read Out Incoming Messages
+
+#### Instructor: Hathibelagal Ashraff
+
+Apps with interfaces that make use of voice have a unique appeal. They tend to make their users feel that they are using something futuristic. Since its early days, Android has had very robust text-to-speech (TTS) functionality. This year, Google has added a lot of high-quality voices to its TTS engine and that's all the more reason for developers to use it in their apps.
+
+In this tutorial, you'll learn how to create a simple app—with a minimalist user interface—that can receive text messages and read them to the user.
+
+Source files for the Tuts+ Tutorial: [Use Text-to-Speech on Android to Read Out Incoming Messages](http://code.tutsplus.com/tutorials/how-to-read-incoming-messages-on-android--cms-22524)
+
+**Read this tutorial on [Tuts+](https://code.tutsplus.com)**

SMSReader/.classpath

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="src" path="src"/>
+	<classpathentry kind="src" path="gen"/>
+	<classpathentry kind="con" path="com.android.ide.eclipse.adt.ANDROID_FRAMEWORK"/>
+	<classpathentry exported="true" kind="con" path="com.android.ide.eclipse.adt.LIBRARIES"/>
+	<classpathentry exported="true" kind="con" path="com.android.ide.eclipse.adt.DEPENDENCIES"/>
+	<classpathentry kind="output" path="bin/classes"/>
+</classpath>

SMSReader/.project

@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>SMSReader</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.ResourceManagerBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.PreCompilerBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>com.android.ide.eclipse.adt.ApkBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>com.android.ide.eclipse.adt.AndroidNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+</projectDescription>

SMSReader/AndroidManifest.xml

@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.hathy.smsreader"
+    android:versionCode="1"
+    android:versionName="1.0" >
+
+    <uses-sdk
+        android:minSdkVersion="8"
+        android:targetSdkVersion="19" />
+
+    <uses-permission android:name="android.permission.READ_SMS"/>
+    <uses-permission android:name="android.permission.RECEIVE_SMS"/>
+    <uses-permission android:name="android.permission.READ_CONTACTS"/>
+
+    <application
+        android:allowBackup="true"
+        android:icon="@drawable/ic_launcher"
+        android:label="@string/app_name">
+        <activity
+            android:name="com.hathy.smsreader.MainActivity"
+            android:label="@string/app_name"
+            android:screenOrientation="portrait"
+            >
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>        
+    </application>
+
+</manifest>

SMSReader/gen/com/hathy/smsreader/BuildConfig.java

@@ -0,0 +1,6 @@
+/** Automatically generated file. DO NOT MODIFY */
+package com.hathy.smsreader;
+
+public final class BuildConfig {
+    public final static boolean DEBUG = true;
+}

SMSReader/proguard-project.txt

@@ -0,0 +1,20 @@
+# To enable ProGuard in your project, edit project.properties
+# to define the proguard.config property as described in that file.
+#
+# Add project specific ProGuard rules here.
+# By default, the flags in this file are appended to flags specified
+# in ${sdk.dir}/tools/proguard/proguard-android.txt
+# You can edit the include path and order by changing the ProGuard
+# include property in project.properties.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# Add any project specific keep options here:
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}

SMSReader/project.properties

@@ -0,0 +1,15 @@
+# This file is automatically generated by Android Tools.
+# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
+#
+# This file must be checked in Version Control Systems.
+#
+# To customize properties used by the Ant build system edit
+# "ant.properties", and override values to adapt the script to your
+# project structure.
+#
+# To enable ProGuard to shrink and obfuscate your code, uncomment this (available properties: sdk.dir, user.home):
+#proguard.config=${sdk.dir}/tools/proguard/proguard-android.txt:proguard-project.txt
+
+# Project target.
+target=android-19
+android.library.reference.1=../appcompat_v7_4

SMSReader/res/layout/activity_main.xml

@@ -0,0 +1,42 @@
+<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"
+    tools:context="${packageName}.${activityClass}"
+    android:background="#99CC00"
+    >
+
+    <TextView
+        android:id="@+id/sms_sender"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_alignParentTop="true"
+        android:layout_centerHorizontal="true"
+        android:layout_marginTop="20dp"
+        android:text="@string/sms_label"
+        android:textColor="#ffffff"
+        android:textAppearance="?android:attr/textAppearanceSmall" />
+
+    <TextView
+        android:id="@+id/sms_text"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_below="@+id/sms_sender"
+        android:layout_centerHorizontal="true"
+        android:layout_marginTop="10dp"
+        android:text="@string/none"
+        android:textAppearance="?android:attr/textAppearanceLarge" 
+        android:textColor="#ffffff"
+        />
+
+    <ToggleButton
+        android:id="@+id/speechToggle"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_centerHorizontal="true"
+        android:layout_centerVertical="true"
+        android:textOff="@string/speech_toggle_on"
+        android:textOn="@string/speech_toggle_off"                 
+        />
+
+</RelativeLayout>

SMSReader/res/values-v11/styles.xml

@@ -0,0 +1,11 @@
+<resources>
+
+    <!--
+        Base application theme for API 11+. This theme completely replaces
+        AppBaseTheme from res/values/styles.xml on API 11+ devices.
+    -->
+    <style name="AppBaseTheme" parent="Theme.AppCompat.Light">
+        <!-- API 11 theme customizations can go here. -->
+    </style>
+
+</resources>

SMSReader/res/values-v14/styles.xml

@@ -0,0 +1,12 @@
+<resources>
+
+    <!--
+        Base application theme for API 14+. This theme completely replaces
+        AppBaseTheme from BOTH res/values/styles.xml and
+        res/values-v11/styles.xml on API 14+ devices.
+    -->
+    <style name="AppBaseTheme" parent="Theme.AppCompat.Light.DarkActionBar">
+        <!-- API 14 theme customizations can go here. -->
+    </style>
+
+</resources>

SMSReader/res/values/strings.xml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+
+    <string name="app_name">SMSReader</string>
+    <string name="sms_label">Latest SMS</string>
+    <string name="none">None</string>
+	<string name="speech_toggle_on">START SPEAKING</string>
+	<string name="speech_toggle_off">STOP SPEAKING</string>
+
+	<string name="start_speaking">Okay! I will read your messages out loud for you now.</string>
+	<string name="stop_speaking">Okay! I will stay silent now.</string>
+</resources>

SMSReader/res/values/styles.xml

@@ -0,0 +1,9 @@
+<resources>
+
+    <style name="AppBaseTheme" parent="Theme.AppCompat.Light">
+    </style>
+
+    <style name="AppTheme" parent="AppBaseTheme">        
+    </style>
+
+</resources>

SMSReader/src/com/hathy/smsreader/MainActivity.java

@@ -0,0 +1,132 @@
+package com.hathy.smsreader;
+
+import android.app.Activity;
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.database.Cursor;
+import android.net.Uri;
+import android.os.Bundle;
+import android.provider.ContactsContract;
+import android.provider.ContactsContract.PhoneLookup;
+import android.speech.tts.TextToSpeech;
+import android.telephony.SmsMessage;
+import android.widget.CompoundButton;
+import android.widget.CompoundButton.OnCheckedChangeListener;
+import android.widget.TextView;
+import android.widget.ToggleButton;
+
+public class MainActivity extends Activity {	
+
+	private final int CHECK_CODE = 0x1; 
+	private final int LONG_DURATION = 5000;
+	private final int SHORT_DURATION = 1200;
+
+	private Speaker speaker;	
+
+	private ToggleButton toggle;
+	private OnCheckedChangeListener toggleListener;
+
+	private TextView smsText;
+	private TextView smsSender;
+
+	private BroadcastReceiver smsReceiver;
+
+	@Override
+	protected void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		setContentView(R.layout.activity_main);			
+
+		toggle = (ToggleButton)findViewById(R.id.speechToggle);	
+		smsText = (TextView)findViewById(R.id.sms_text);
+		smsSender = (TextView)findViewById(R.id.sms_sender);
+
+		toggleListener = new OnCheckedChangeListener() {			
+			@Override
+			public void onCheckedChanged(CompoundButton view, boolean isChecked) {
+				if(isChecked){
+					speaker.allow(true);
+					speaker.speak(getString(R.string.start_speaking));
+				}else{
+					speaker.speak(getString(R.string.stop_speaking));
+					speaker.allow(false);					
+				}
+			}
+		};		
+		toggle.setOnCheckedChangeListener(toggleListener);
+
+		checkTTS();
+		initializeSMSReceiver();
+		registerSMSReceiver();
+	}	
+
+	private void checkTTS(){
+		Intent check = new Intent();
+		check.setAction(TextToSpeech.Engine.ACTION_CHECK_TTS_DATA);
+		startActivityForResult(check, CHECK_CODE);
+	}
+
+	@Override
+	protected void onActivityResult(int requestCode, int resultCode, Intent data) {
+		if(requestCode == CHECK_CODE){
+			if(resultCode == TextToSpeech.Engine.CHECK_VOICE_DATA_PASS){
+				speaker = new Speaker(this);
+			}else {
+	            Intent install = new Intent();
+	            install.setAction(TextToSpeech.Engine.ACTION_INSTALL_TTS_DATA);
+	            startActivity(install);
+	        }
+		}
+	}
+
+	private void initializeSMSReceiver(){
+		smsReceiver = new BroadcastReceiver(){
+			@Override
+			public void onReceive(Context context, Intent intent) {
+
+				Bundle bundle = intent.getExtras();
+				if(bundle!=null){
+					Object[] pdus = (Object[])bundle.get("pdus");
+					for(int i=0;i<pdus.length;i++){
+						byte[] pdu = (byte[])pdus[i];
+						SmsMessage message = SmsMessage.createFromPdu(pdu);
+						String text = message.getDisplayMessageBody();
+						String sender = getContactName(message.getOriginatingAddress());
+						speaker.pause(LONG_DURATION);
+						speaker.speak("You have a new message from" + sender + "!");
+						speaker.pause(SHORT_DURATION);
+						speaker.speak(text);
+						smsSender.setText("Message from " + sender);
+						smsText.setText(text);
+					}
+				}
+
+			}			
+		};		
+	}
+
+	private void registerSMSReceiver() {	
+		IntentFilter intentFilter = new IntentFilter("android.provider.Telephony.SMS_RECEIVED");
+		registerReceiver(smsReceiver, intentFilter);
+	}
+
+	private String getContactName(String phone){
+		Uri uri = Uri.withAppendedPath(PhoneLookup.CONTENT_FILTER_URI, Uri.encode(phone));
+		String projection[] = new String[]{ContactsContract.Data.DISPLAY_NAME};
+		Cursor cursor = getContentResolver().query(uri, projection, null, null, null);				
+		if(cursor.moveToFirst()){
+			return cursor.getString(0);
+		}else {
+			return "unknown number";
+		}
+	}
+
+	@Override
+	protected void onDestroy() {	
+		super.onDestroy();
+		unregisterReceiver(smsReceiver);
+		speaker.destroy();
+	}
+
+}