Как отправить email с Android-устройства из приложения Unity, не написав ни строчки кода на Java

Часто разработчики добавляют в приложение возможность отослать письмо другу с ссылкой на приложение. Обычно это возможно сделать штатными средствами конечной ОС. При портировании нашего приложения на Android мне пришлось потратить некоторое время, чтобы добавить эту функциональность. В последний раз я работал с языком Java лет 5 назад, и мне не хотелось лезть в дебри написания Android-плагина для Unity, установки Eclipse, сборки jar-файла, настройки AndroidManifest.xml и тд. Мне удалось это сделать на C#, не написав ни строчки кода на Java (если не считать в комментариях). Хочу поделиться с Вами, как я это сделал, чтобы Вы не тратили свое время. При этом указанный в статье метод можно использовать для вызова любого Java-кода.

Простой вариант

Существует очень простой вариант. Если текст письма небольшой, не содержит html-коды, то можно воспользоваться URI-схемой mailto:

string url = string.Format("mailto:{0}?subject={1}&body={2}", to, WWW.EscapeURL(subject), WWW.EscapeURL(body));
Application.OpenURL(url);

Т.е. создается специальная ссылка и открывается с помощью функции Unity Application.OpenURL. Не все почтовые программы адекватно воспринимают такую ссылку, особенно если в тексте есть пробелы. Поэтому приходится воспользоваться WWW.EscapeURL.
Что же делать, если нужно послать письмо, содержащее ссылки, изображения и т.д.?

Вариант с HTML

Это можно сделать с помощью встроенной почтовой программы Android. Для этого нужно писать следующий Java-код:

intent = new Intent(Intent.ACTION_SEND);
if (isHTML)
  intent.setType("text/html");
else
  intent.setType("message/rfc822");
intent.putExtra(Intent.EXTRA_SUBJECT, subject);
if (isHTML)
  intent.putExtra(Intent.EXTRA_TEXT, Html.fromHtml(body));
else
  intent.putExtra(Intent.EXTRA_TEXT, body);
startActivity(intent);

Его можно найти в многочисленных примерах в сети. На Хабре была статья о том, как это сделать на Andoird. Если интересно, что делает этот код, почитайте ее.

Далее, чтобы вызвать этот код из Unity, нужно собрать jar-файл, вызвать Java-функцию из C#-скрипта и тд. Но можно обойтись без всего этого. Нам помогут вспомогательные классы Unity AndroidJavaClass и AndroidJavaObject. Это очень полезные инструменты. С их помощью можно получить доступ к любому Java-классу и любому Java-объекту, соответственно, а также создавать Java-объекты, получить доступ к методам класса, статическим методам и данным и тд.

Я переписал его на C#, используя указанные выше классы:

/// <summary>
/// Sends mail using default mail application.
/// </summary>
private static void SendMail(string subject, string body, bool isHTML)
{
  using (var intentClass = new AndroidJavaClass("android.content.Intent"))
  {
    // intent = new Intent(Intent.ACTION_SEND);
    using (var intentObject = new AndroidJavaObject("android.content.Intent", intentClass.GetStatic<string>("ACTION_SEND")))
    {
      // Setting text type
      if (isHTML)
        // intent.setType("text/html");
        intentObject.Call<AndroidJavaObject>("setType", "text/html");
      else
        // intent.setType("message/rfc822");
        intentObject.Call<AndroidJavaObject>("setType", "message/rfc822");

      // intent.putExtra(Intent.EXTRA_SUBJECT, subject);
      intentObject.Call<AndroidJavaObject>("putExtra", intentClass.GetStatic<string>("EXTRA_SUBJECT"), subject);

      // Setting body
      if (isHTML)
      {
        // intent.putExtra(Intent.EXTRA_TEXT, Html.fromHtml(body));
        using (var html = new AndroidJavaClass("android.text.Html"))
        {
          var htmlBody = html.CallStatic<AndroidJavaObject>("fromHtml", body);
          intentObject.Call<AndroidJavaObject>("putExtra", intentClass.GetStatic<string>("EXTRA_TEXT"), htmlBody);
        }
      }
      else
      {
        // intent.putExtra(Intent.EXTRA_TEXT, body);
        intentObject.Call<AndroidJavaObject>("putExtra", intentClass.GetStatic<string>("EXTRA_TEXT"), body);
      }

      // startActivity(intent);
      using (var unity = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
      {
        using (var currentActivity = unity.GetStatic<AndroidJavaObject>("currentActivity"))
        {
          currentActivity.Call("startActivity", intentObject);
        }
      }
    }
  }
}

Переменная intentClass предоставляет доступ к Java-классу android.content.Intent, чем я и воспользовался для получения доступа к константам типа Intent.EXTRA_TEXT используя функцию GetStatic:

intentClass.GetStatic<string>("EXTRA_TEXT")

Переменная intentObject — ссылка на созданный объект Java-класса android.content.Intent. Как видите, создавать объекты Java-класса очень легко:

var intentObject = new AndroidJavaObject("android.content.Intent", intentClass.GetStatic<string>("ACTION_SEND"))

Первый параметр конструктора класса AndroidJavaObject — имя Java-класса, остальные параметры — параметры конструктора уже самого Java-класса.

Не стоит путать AndroidJavaObject c AndroidJavaClass, используйте каждый по назначению. Эти классы настолько похожи визуально (AndroidJavaClass даже наследуется от AndroidJavaObject), что в одном месте я использовал AndroidJavaClass вместо AndroidJavaObject и не заметил этого. Печально, но на исправление этой маленькой детали ушло время.

Директива using используется для своевременного «освобождения» Java-объектов. Об этом хорошо написано в Best practice when using Java plugins with Unity.
Доступ к методам класса осуществаляется через функцию Call, при этом если метод возвращает результат, то используется обобщенный вариант функции, для указания типа возвращаемого результата:

intentObject.Call<AndroidJavaObject>("putExtra", intentClass.GetStatic<string>("EXTRA_TEXT"), body);

Не забывайте об этом: даже если вам не нужен возвращаемый результат, тип результата нужно все равно указывать, иначе получите неправильную сигнатуру метода и он не будет найден, или, что еще хуже, вы нехотя вызовете похожий метод (если он есть), не возвращающий результат, и не сразу заметите ошибку.

В конце получаем текущий контекст (currentActivity и будет им) и инициируем отсылку с помощью созданного объекта intentObject:

using (var unity = new AndroidJavaClass("com.unity3d.player.UnityPlayer"))
{
  using (var currentActivity = unity.GetStatic<AndroidJavaObject>("currentActivity"))
  {
    currentActivity.Call("startActivity", intentObject);
  }
}

Вот и все.
Похожим образом можно переписать практически любой Java-код. Рекомендую этот метод в том случае, если код небольшой и не хочется писать плагин. В ином случае, конечно, получается очень громоздкий код, непонятный несведущему человеку.

Готов выслушать вопросы и предложения;)

Возможно, кому-то будет интересно почитать мои предыдущие статьи:

• Игра за два дня
• Как сделать промо-ролик игры малыми силами — Статья написана Алексеем Луниным — type_2.
• 2d на Unity3d
• Принципы минимализма при разработке игр для мобильных платформ
• Оптимизация 2d-приложений для мобильных устройств в Unity3d

Удачи Вам в Ваших разработках!