Commit 1e04a9f0 authored by suvamjain's avatar suvamjain Committed by Jeffrey Schiller

Updated Texting documents for Google Voice no receiving issue #1015 (#1648)

* Updated Texting documents for Google Voice no receiving issue
parent cfabf83e
...@@ -778,11 +778,11 @@ none ...@@ -778,11 +778,11 @@ none
<dd>Shares a message through any capable application installed on the phone by displaying a list of the available apps and allowing the user to choose one from the list. The selected app will open with the message inserted on it.</dd> <dd>Shares a message through any capable application installed on the phone by displaying a list of the available apps and allowing the user to choose one from the list. The selected app will open with the message inserted on it.</dd>
</dl> </dl>
<h2 id="Texting"> <h2 id="Texting">
Texting Texting
</h2> </h2>
<img alt="" src="images/texting.png" /> <img alt="" src="images/texting.png" />
<p> <p>
A component that will, when the A component that will, when the
<code>SendMessage</code> <code>SendMessage</code>
method is called, send the text message specified in the method is called, send the text message specified in the
...@@ -790,8 +790,8 @@ none ...@@ -790,8 +790,8 @@ none
property to the phone number specified in the property to the phone number specified in the
<code>PhoneNumber</code> <code>PhoneNumber</code>
property. property.
</p> </p>
<p> <p>
If the If the
<code>ReceivingEnabled</code> <code>ReceivingEnabled</code>
property is set to 1 messages will <b>not</b> be received. If property is set to 1 messages will <b>not</b> be received. If
...@@ -801,31 +801,35 @@ none ...@@ -801,31 +801,35 @@ none
is set to 3, messages will be received when the application is set to 3, messages will be received when the application
is running <b>and</b> when the application is not running is running <b>and</b> when the application is not running
they will be queued and a notification displayed to the user. they will be queued and a notification displayed to the user.
</p> </p>
<p> <p>
When a message arrives, the When a message arrives, the
<code>MessageReceived</code> <code>MessageReceived</code>
event is raised and provides the sending number and message. event is raised and provides the sending number and message.
</p> </p>
<p> <p>
An app that includes this component will receive messages even when it is in the background (i.e. when it's not visible on the screen) and, moreso, even if the app is not running, so long as it's installed on the phone. If the phone receives a text message when the app is not in the foreground, the phone will show a notification in the notification bar. Selecting the notification will bring up the app. As an app developer, you'll probably want to give your users the ability to control ReceivingEnabled so that they can make the phone ignore text messages. An app that includes this component will receive messages even when it is in the background (i.e. when it's not visible on the screen) and, moreso, even if the app is not running, so long as it's installed on the phone. If the phone receives a text message when the app is not in the foreground, the phone will show a notification in the notification bar. Selecting the notification will bring up the app. As an app developer, you'll probably want to give your users the ability to control ReceivingEnabled so that they can make the phone ignore text messages.
</p> </p>
<p> <!-- [suvam, 7-Mar-19] Updated Texting documentation regarding Google Voice -->
If the GoogleVoiceEnabled property is true, messages can be sent over Wifi using Google Voice. This option requires that the user have a Google Voice account and that the mobile Voice app is installed on the phone. The Google Voice option works only on phones that support Android 2.0 (Eclair) or higher. <strong>Using this block will add <a href="https://developer.android.com/guide/topics/permissions/overview#dangerous_permissions">dangerous permissions</a> that will require additional approval if your app is submitted to the Google Play Store.</strong> <p>
</p> If the GoogleVoiceEnabled property is true, messages can be sent over Wifi using Google Voice.
<p> This option requires that the user have a Google Voice account and that the mobile Voice app is installed on the phone.
The Google Voice option works only on phones that support Android 2.0 (Eclair) or higher.
<strong>Unfortunately, receiving no longer works in Google Voice due to changes introduced in Google Voice App.</strong>
</p>
<p>
To specify the phone number (e.g., 650-555-1212), set the To specify the phone number (e.g., 650-555-1212), set the
<code>PhoneNumber</code> <code>PhoneNumber</code>
property to a Text string with the specified digits (e.g., 6505551212). Dashes, dots, and parentheses may be included (e.g., (650)-555-1212) but will be ignored; spaces may not be included. property to a Text string with the specified digits (e.g., 6505551212). Dashes, dots, and parentheses may be included (e.g., (650)-555-1212) but will be ignored; spaces may not be included.
</p> </p>
<p> <p>
Another way for an app to specify a phone number would be to include a Another way for an app to specify a phone number would be to include a
<code>PhoneNumberPicker</code> <code>PhoneNumberPicker</code>
component, which lets the users select a phone numbers from the ones stored in the the phone's contacts. component, which lets the users select a phone numbers from the ones stored in the the phone's contacts.
</p> </p>
<h3>Properties</h3> <h3>Properties</h3>
<dl> <dl>
<dt><code>GoogleVoiceEnabled</code></dt> <dt><code>GoogleVoiceEnabled</code></dt>
<dd> <dd>
If true, then SendMessage will attempt to send messages If true, then SendMessage will attempt to send messages
...@@ -865,18 +869,18 @@ none ...@@ -865,18 +869,18 @@ none
make their phones ignore text messages when your app is make their phones ignore text messages when your app is
installed. installed.
</dd> </dd>
</dl> </dl>
<h3>Events</h3> <h3>Events</h3>
<dl> <dl>
<dt><code>MessageReceived(text number, text messageText)</code></dt> <dt><code>MessageReceived(text number, text messageText)</code></dt>
<dd>Event that's raised when a text message is received by <dd>Event that's raised when a text message is received by
the phone. <strong>Using this block will the phone. <strong>Using this block will
add <a href="https://developer.android.com/guide/topics/permissions/overview#dangerous_permissions">dangerous add <a href="https://developer.android.com/guide/topics/permissions/overview#dangerous_permissions">dangerous
permissions</a> that will require additional approval if your permissions</a> that will require additional approval if your
app is submitted to the Google Play Store.</strong></dd> app is submitted to the Google Play Store.</strong></dd>
</dl> </dl>
<h3>Methods</h3> <h3>Methods</h3>
<dl> <dl>
<dt><code>SendMessage()</code></dt> <dt><code>SendMessage()</code></dt>
<dd>Launch the phone's default text messaging app with the <dd>Launch the phone's default text messaging app with the
message and phone number prepopulated.</dd> message and phone number prepopulated.</dd>
...@@ -885,7 +889,7 @@ none ...@@ -885,7 +889,7 @@ none
add <a href="https://developer.android.com/guide/topics/permissions/overview#dangerous_permissions">dangerous add <a href="https://developer.android.com/guide/topics/permissions/overview#dangerous_permissions">dangerous
permissions</a> that will require additional approval if your permissions</a> that will require additional approval if your
app is submitted to the Google Play Store.</strong></dd> app is submitted to the Google Play Store.</strong></dd>
</dl> </dl>
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment