Interfaces

Public Interfaces

Intent
Content Provider
Addon Interfaces
SuntimesCalculator

Intent

Main Activity
Alarm Clock
Color Picker
Action List
Places List
Theme List
Widget List
Settings

Main Activity

com.forrestguice.suntimeswidget.SuntimesActivity

To open the main activity and highlight the time of the next sunset.

Intent intent = new Intent();
intent.setComponent("com.forrestguice.suntimeswidget", "com.forrestguice.suntimeswidget.SuntimesActivity");
intent.setAction("suntimes.action.SEEK_NOTE");
intent.putExtra("solarevent", "SUNSET");
startActivity(intent);

The following solarevent identifiers are recognized: MORNING_ASTRONOMICAL, MORNING_NAUTICAL, MORNING_BLUE8, MORNING_CIVIL, MORNING_BLUE4, SUNRISE, MORNING_GOLDEN, NOON, EVENING_GOLDEN, SUNSET, EVENING_BLUE4, EVENING_CIVIL, EVENING_BLUE8, EVENING_NAUTICAL, EVENING_ASTRONOMICAL, MOONRISE, MOONSET.

Alarm Clock

com.forrestguice.suntimeswidget.alarmclock.ui.AlarmClockActivity

To schedule an alarm create an Intent with the ACTION_SET_ALARM action.

Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM);
intent.putExtra(AlarmClock.EXTRA_MESSAGE, "My Alarm");
intent.putExtra(AlarmClock.EXTRA_HOUR, hour);
intent.putExtra(AlarmClock.EXTRA_MINUTES, minutes);
startActivity(intent);

This is the same as scheduling using the Android Alarm Clock, where EXTRA_MESSAGE, EXTRA_HOUR, and EXTRA_MINUTES are expected parameters. Other standard extras include; AlarmClock.EXTRA_VIBRATE, AlarmClock.EXTRA_RINGTONE, AlarmClock.EXTRA_SKIP_UI, and AlarmClock.EXTRA_DAYS.

See https://developer.android.com/reference/android/provider/AlarmClock.

The alarmtype extra is a Suntimes Alarms feature that overrides the alarm type. The following values are recognized: ALARM (default), NOTIFICATION.

The timezone extra is a Suntimes Alarms features indicating a timezoneID should be applied to the hour and minute values. Use special values Local Mean Time or Apparent Solar Time to specify hours and minutes in solar time.

The solarevent extra is a Suntimes Alarms feature that overrides the hour and minute using the specified solar event.

The following solar event identifiers are recognized: MORNING_ASTRONOMICAL, MORNING_NAUTICAL, MORNING_BLUE8, MORNING_CIVIL, MORNING_BLUE4, SUNRISE, MORNING_GOLDEN, NOON, EVENING_GOLDEN, SUNSET, EVENING_BLUE4, EVENING_CIVIL, EVENING_BLUE8, EVENING_NAUTICAL, EVENING_ASTRONOMICAL, MOONRISE, MOONSET.

Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM);
intent.putExtra("solarevent", "SUNRISE");
startActivity(intent);

The latitude, longitude, and altitude extras allow overriding the event location (defaults to the app location). If these extras are supplied, the location_label extra can also be supplied to set the place name.

Intent intent = new Intent(AlarmClock.ACTION_SET_ALARM);
intent.putExtra("alarmtype", "notification");
intent.putExtra("solarevent", "SUNSET");
intent.putExtra("latitude", 35.0);                  // dd (double)
intent.putExtra("longitude", -112.0);               // dd (double)
intent.putExtra("altitude", 1000);                  // meters (double)
intent.putExtra("location_label", "The Place");     // label (String; may be null)
startActivity(intent);

Color Picker

com.forrestguice.suntimeswidget.settings.colors.ColorActivity

To use the color picker create an Intent (either implicit or explicit) with the Intent.ACTION_PICK action and a color:// data uri.

ArrayList<Integer> recentColors = new ArrayList<>();
recentColors.add(Color.RED);
int color = Color.GREEN;

Intent intent = new Intent(Intent.ACTION_PICK);
intent.setData(Uri.parse("color://" + String.format("#%08X", color)));        // selected color as uri fragment; color://#hexColor
//intent.putExtra("color", color);                                            // selected color as an int (another way to do same as above)

// may be necessary to make Intent explicit depending on Android version
//intent.setComponent("com.forrestguice.suntimeswidget", "com.forrestguice.suntimeswidget.settings.colors.ColorActivity");     

intent.putExtra("showAlpha", false);                                          // show alpha slider
intent.putExtra("recentColors", recentColors);                                // show "recent" palette of colors

startActivityForResult(intent, REQUEST_CODE);

public void onActivityResult(int requestCode, int resultCode, Intent data)
{
    if (resultCode == RESULT_OK && resultCode == REQUEST_CODE)
    {
        int color;
        Uri uri = data.getData();
        if (uri != null)
        {
            try {
                color = Color.parseColor("#" + uri.getFragment());
                // color = color data.getIntExtra("color", 0);    // another way to do the same as above
                onColorPicked(color);    // do something with returned value

            } catch (IllegalArgumentException e) {
                Log.e("onActivityResult", "bad color uri; " + e);
            }
        }
    }
}