Update browseable samples for lmp-docs

Synced to commit df5e5013422b81b4fd05c0ac9fd964b13624847a. Includes
new samples for Android Auto.

Change-Id: I3fec46e2a6b3f196682a92f1afd91eb682dc2dc1
This commit is contained in:
Trevor Johns
2014-11-12 11:39:30 -08:00
parent fcd28181a1
commit 527a4f30a6
684 changed files with 10100 additions and 10207 deletions

View File

@@ -0,0 +1,126 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.concurrent.ThreadLocalRandom;
/**
* A simple class that denotes unread conversations and messages. In a real world application,
* this would be replaced by a content provider that actually gets the unread messages to be
* shown to the user.
*/
public class Conversations {
/**
* Set of strings used as messages by the sample.
*/
private static final String[] MESSAGES = new String[]{
"Are you at home?",
"Can you give me a call?",
"Hey yt?",
"Don't forget to get some milk on your way back home",
"Is that project done?",
"Did you finish the Messaging app yet?"
};
/**
* Senders of the said messages.
*/
private static final String[] PARTICIPANTS = new String[]{
"John Rambo",
"Han Solo",
"Rocky Balboa",
"Lara Croft"
};
static class Conversation {
private final int conversationId;
private final String participantName;
/**
* A given conversation can have a single or multiple messages.
* Note that the messages are sorted from *newest* to *oldest*
*/
private final List<String> messages;
private final long timestamp;
public Conversation(int conversationId, String participantName,
List<String> messages) {
this.conversationId = conversationId;
this.participantName = participantName;
this.messages = messages == null ? Collections.<String>emptyList() : messages;
this.timestamp = System.currentTimeMillis();
}
public int getConversationId() {
return conversationId;
}
public String getParticipantName() {
return participantName;
}
public List<String> getMessages() {
return messages;
}
public long getTimestamp() {
return timestamp;
}
public String toString() {
return "[Conversation: conversationId=" + conversationId +
", participantName=" + participantName +
", messages=" + messages +
", timestamp=" + timestamp + "]";
}
}
private Conversations() {
}
public static Conversation[] getUnreadConversations(int howManyConversations,
int messagesPerConversation) {
Conversation[] conversations = new Conversation[howManyConversations];
for (int i = 0; i < howManyConversations; i++) {
conversations[i] = new Conversation(
ThreadLocalRandom.current().nextInt(),
name(), makeMessages(messagesPerConversation));
}
return conversations;
}
private static List<String> makeMessages(int messagesPerConversation) {
int maxLen = MESSAGES.length;
List<String> messages = new ArrayList<>(messagesPerConversation);
for (int i = 0; i < messagesPerConversation; i++) {
messages.add(MESSAGES[ThreadLocalRandom.current().nextInt(0, maxLen)]);
}
return messages;
}
private static String name() {
return PARTICIPANTS[ThreadLocalRandom.current().nextInt(0, PARTICIPANTS.length)];
}
}

View File

@@ -0,0 +1,34 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import android.app.Activity;
import android.os.Bundle;
public class MainActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
if (savedInstanceState == null) {
getFragmentManager().beginTransaction()
.add(R.id.container, new MessagingFragment())
.commit();
}
}
}

View File

@@ -0,0 +1,57 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import android.content.Context;
import android.content.SharedPreferences;
import java.text.SimpleDateFormat;
import java.util.Date;
/**
* A simple logger that uses shared preferences to log messages, their reads
* and replies. Don't use this in a real world application. This logger is only
* used for displaying the messages in the text view.
*/
public class MessageLogger {
private static final String PREF_MESSAGE = "MESSAGE_LOGGER";
private static final SimpleDateFormat DATE_FORMAT = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
public static final String LOG_KEY = "message_data";
public static final String LINE_BREAKS = "\n\n";
public static void logMessage(Context context, String message) {
SharedPreferences prefs = getPrefs(context);
message = DATE_FORMAT.format(new Date(System.currentTimeMillis())) + ": " + message;
prefs.edit()
.putString(LOG_KEY, prefs.getString(LOG_KEY, "") + LINE_BREAKS + message)
.apply();
}
public static SharedPreferences getPrefs(Context context) {
return context.getSharedPreferences(PREF_MESSAGE, Context.MODE_PRIVATE);
}
public static String getAllMessages(Context context) {
return getPrefs(context).getString(LOG_KEY, "");
}
public static void clear(Context context) {
getPrefs(context).edit().remove(LOG_KEY).apply();
}
}

View File

@@ -0,0 +1,42 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import android.app.NotificationManager;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.support.v4.app.NotificationManagerCompat;
import android.util.Log;
public class MessageReadReceiver extends BroadcastReceiver {
private static final String TAG = MessageReadReceiver.class.getSimpleName();
private static final String CONVERSATION_ID = "conversation_id";
@Override
public void onReceive(Context context, Intent intent) {
Log.d(TAG, "onReceive");
int conversationId = intent.getIntExtra(CONVERSATION_ID, -1);
if (conversationId != -1) {
Log.d(TAG, "Conversation " + conversationId + " was read");
MessageLogger.logMessage(context, "Conversation " + conversationId + " was read.");
NotificationManagerCompat notificationManager = NotificationManagerCompat.from(context);
notificationManager.cancel(conversationId);
}
}
}

View File

@@ -0,0 +1,58 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.support.v4.app.RemoteInput;
import android.util.Log;
/**
* A receiver that gets called when a reply is sent to a given conversationId
*/
public class MessageReplyReceiver extends BroadcastReceiver {
private static final String TAG = MessageReplyReceiver.class.getSimpleName();
@Override
public void onReceive(Context context, Intent intent) {
if (MessagingService.REPLY_ACTION.equals(intent.getAction())) {
int conversationId = intent.getIntExtra(MessagingService.CONVERSATION_ID, -1);
CharSequence reply = getMessageText(intent);
if (conversationId != -1) {
Log.d(TAG, "Got reply (" + reply + ") for ConversationId " + conversationId);
MessageLogger.logMessage(context, "ConversationId: " + conversationId +
" received a reply: [" + reply + "]");
}
}
}
/**
* Get the message text from the intent.
* Note that you should call {@code RemoteInput#getResultsFromIntent(intent)} to process
* the RemoteInput.
*/
private CharSequence getMessageText(Intent intent) {
Bundle remoteInput = RemoteInput.getResultsFromIntent(intent);
if (remoteInput != null) {
return remoteInput.getCharSequence(MessagingService.EXTRA_VOICE_REPLY);
}
return null;
}
}

View File

@@ -0,0 +1,170 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import android.app.Fragment;
import android.content.ComponentName;
import android.content.Context;
import android.content.Intent;
import android.content.ServiceConnection;
import android.content.SharedPreferences;
import android.os.Bundle;
import android.os.IBinder;
import android.os.Message;
import android.os.Messenger;
import android.os.RemoteException;
import android.text.method.ScrollingMovementMethod;
import android.util.Log;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.Button;
import android.widget.TextView;
/**
* The main fragment that shows the buttons and the text view containing the log.
*/
public class MessagingFragment extends Fragment implements View.OnClickListener {
private static final String TAG = MessagingFragment.class.getSimpleName();
private Button mSendSingleConversation;
private Button mSendTwoConversations;
private Button mSendConversationWithThreeMessages;
private TextView mDataPortView;
private Button mClearLogButton;
private Messenger mService;
private boolean mBound;
private ServiceConnection mConnection = new ServiceConnection() {
@Override
public void onServiceConnected(ComponentName componentName, IBinder service) {
mService = new Messenger(service);
mBound = true;
setButtonsState(true);
}
@Override
public void onServiceDisconnected(ComponentName componentName) {
mService = null;
mBound = false;
setButtonsState(false);
}
};
private SharedPreferences.OnSharedPreferenceChangeListener listener =
new SharedPreferences.OnSharedPreferenceChangeListener() {
@Override
public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) {
if (MessageLogger.LOG_KEY.equals(key)) {
mDataPortView.setText(MessageLogger.getAllMessages(getActivity()));
}
}
};
public MessagingFragment() {
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
View rootView = inflater.inflate(R.layout.fragment_message_me, container, false);
mSendSingleConversation = (Button) rootView.findViewById(R.id.send_1_conversation);
mSendSingleConversation.setOnClickListener(this);
mSendTwoConversations = (Button) rootView.findViewById(R.id.send_2_conversations);
mSendTwoConversations.setOnClickListener(this);
mSendConversationWithThreeMessages =
(Button) rootView.findViewById(R.id.send_1_conversation_3_messages);
mSendConversationWithThreeMessages.setOnClickListener(this);
mDataPortView = (TextView) rootView.findViewById(R.id.data_port);
mDataPortView.setMovementMethod(new ScrollingMovementMethod());
mClearLogButton = (Button) rootView.findViewById(R.id.clear);
mClearLogButton.setOnClickListener(this);
setButtonsState(false);
return rootView;
}
@Override
public void onClick(View view) {
if (view == mSendSingleConversation) {
sendMsg(1, 1);
} else if (view == mSendTwoConversations) {
sendMsg(2, 1);
} else if (view == mSendConversationWithThreeMessages) {
sendMsg(1, 3);
} else if (view == mClearLogButton) {
MessageLogger.clear(getActivity());
mDataPortView.setText(MessageLogger.getAllMessages(getActivity()));
}
}
@Override
public void onStart() {
super.onStart();
getActivity().bindService(new Intent(getActivity(), MessagingService.class), mConnection,
Context.BIND_AUTO_CREATE);
}
@Override
public void onPause() {
super.onPause();
MessageLogger.getPrefs(getActivity()).unregisterOnSharedPreferenceChangeListener(listener);
}
@Override
public void onResume() {
super.onResume();
mDataPortView.setText(MessageLogger.getAllMessages(getActivity()));
MessageLogger.getPrefs(getActivity()).registerOnSharedPreferenceChangeListener(listener);
}
@Override
public void onStop() {
super.onStop();
if (mBound) {
getActivity().unbindService(mConnection);
mBound = false;
}
}
private void sendMsg(int howManyConversations, int messagesPerConversation) {
if (mBound) {
Message msg = Message.obtain(null, MessagingService.MSG_SEND_NOTIFICATION,
howManyConversations, messagesPerConversation);
try {
mService.send(msg);
} catch (RemoteException e) {
Log.e(TAG, "Error sending a message", e);
MessageLogger.logMessage(getActivity(), "Error occurred while sending a message.");
}
}
}
private void setButtonsState(boolean enable) {
mSendSingleConversation.setEnabled(enable);
mSendTwoConversations.setEnabled(enable);
mSendConversationWithThreeMessages.setEnabled(enable);
}
}

View File

@@ -0,0 +1,174 @@
/*
* Copyright (C) 2014 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.example.android.messagingservice;
import android.app.PendingIntent;
import android.app.Service;
import android.content.Intent;
import android.graphics.BitmapFactory;
import android.os.Handler;
import android.os.IBinder;
import android.os.Message;
import android.os.Messenger;
import android.preview.support.v4.app.NotificationCompat.CarExtender;
import android.preview.support.v4.app.NotificationCompat.CarExtender.UnreadConversation;
import android.support.v4.app.NotificationCompat;
import android.support.v4.app.NotificationManagerCompat;
import android.support.v4.app.RemoteInput;
import android.util.Log;
import java.util.Iterator;
public class MessagingService extends Service {
private static final String TAG = MessagingService.class.getSimpleName();
public static final String READ_ACTION =
"com.example.android.messagingservice.ACTION_MESSAGE_READ";
public static final String REPLY_ACTION =
"com.example.android.messagingservice.ACTION_MESSAGE_REPLY";
public static final String CONVERSATION_ID = "conversation_id";
public static final String EXTRA_VOICE_REPLY = "extra_voice_reply";
public static final int MSG_SEND_NOTIFICATION = 1;
public static final String EOL = "\n";
private NotificationManagerCompat mNotificationManager;
private final Messenger mMessenger = new Messenger(new IncomingHandler());
/**
* Handler of incoming messages from clients.
*/
class IncomingHandler extends Handler {
@Override
public void handleMessage(Message msg) {
switch (msg.what) {
case MSG_SEND_NOTIFICATION:
int howManyConversations = msg.arg1 <= 0 ? 1 : msg.arg1;
int messagesPerConv = msg.arg2 <= 0 ? 1 : msg.arg2;
sendNotification(howManyConversations, messagesPerConv);
break;
default:
super.handleMessage(msg);
}
}
}
@Override
public void onCreate() {
Log.d(TAG, "onCreate");
mNotificationManager = NotificationManagerCompat.from(getApplicationContext());
}
@Override
public IBinder onBind(Intent intent) {
Log.d(TAG, "onBind");
return mMessenger.getBinder();
}
@Override
public int onStartCommand(Intent intent, int flags, int startId) {
Log.d(TAG, "onStartCommand");
return START_STICKY;
}
@Override
public void onDestroy() {
super.onDestroy();
Log.d(TAG, "onDestroy");
}
// Creates an intent that will be triggered when a message is marked as read.
private Intent getMessageReadIntent(int id) {
return new Intent()
.addFlags(Intent.FLAG_INCLUDE_STOPPED_PACKAGES)
.setAction(READ_ACTION)
.putExtra(CONVERSATION_ID, id);
}
// Creates an Intent that will be triggered when a voice reply is received.
private Intent getMessageReplyIntent(int conversationId) {
return new Intent()
.addFlags(Intent.FLAG_INCLUDE_STOPPED_PACKAGES)
.setAction(REPLY_ACTION)
.putExtra(CONVERSATION_ID, conversationId);
}
private void sendNotification(int howManyConversations, int messagesPerConversation) {
Conversations.Conversation[] conversations = Conversations.getUnreadConversations(
howManyConversations, messagesPerConversation);
for (Conversations.Conversation conv : conversations) {
sendNotificationForConversation(conv);
}
}
private void sendNotificationForConversation(Conversations.Conversation conversation) {
// A pending Intent for reads
PendingIntent readPendingIntent = PendingIntent.getBroadcast(getApplicationContext(),
conversation.getConversationId(),
getMessageReadIntent(conversation.getConversationId()),
PendingIntent.FLAG_UPDATE_CURRENT);
// Build a RemoteInput for receiving voice input in a Car Notification
RemoteInput remoteInput = new RemoteInput.Builder(EXTRA_VOICE_REPLY)
.setLabel(getApplicationContext().getString(R.string.notification_reply))
.build();
// Building a Pending Intent for the reply action to trigger
PendingIntent replyIntent = PendingIntent.getBroadcast(getApplicationContext(),
conversation.getConversationId(),
getMessageReplyIntent(conversation.getConversationId()),
PendingIntent.FLAG_UPDATE_CURRENT);
// Create the UnreadConversation and populate it with the participant name,
// read and reply intents.
UnreadConversation.Builder unreadConvBuilder =
new UnreadConversation.Builder(conversation.getParticipantName())
.setLatestTimestamp(conversation.getTimestamp())
.setReadPendingIntent(readPendingIntent)
.setReplyAction(replyIntent, remoteInput);
// Note: Add messages from oldest to newest to the UnreadConversation.Builder
StringBuilder messageForNotification = new StringBuilder();
for (Iterator<String> messages = conversation.getMessages().iterator();
messages.hasNext(); ) {
String message = messages.next();
unreadConvBuilder.addMessage(message);
messageForNotification.append(message);
if (messages.hasNext()) {
messageForNotification.append(EOL);
}
}
NotificationCompat.Builder builder = new NotificationCompat.Builder(getApplicationContext())
.setSmallIcon(R.drawable.notification_icon)
.setLargeIcon(BitmapFactory.decodeResource(
getApplicationContext().getResources(), R.drawable.android_contact))
.setContentText(messageForNotification.toString())
.setWhen(conversation.getTimestamp())
.setContentTitle(conversation.getParticipantName())
.setContentIntent(readPendingIntent)
.extend(new CarExtender()
.setUnreadConversation(unreadConvBuilder.build())
.setColor(getApplicationContext()
.getResources().getColor(R.color.default_color_light)));
MessageLogger.logMessage(getApplicationContext(), "Sending notification "
+ conversation.getConversationId() + " conversation: " + conversation);
mNotificationManager.notify(conversation.getConversationId(), builder.build());
}
}