|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface RDSControl
RDSControl is an interface for accessing
the Radio Data System for VHF/FM sound broadcasting
(RDS) (BS EN 50067:1998) settings of a Player.
RDSControl can also be used with
Radio Broadcast Data System (RBDS)
(U.S. RBDS Standard - April 1998), but RDS terminology
is used in this API documentation.
Control,
Player,
PlayerListener,
TunerControl| Field Summary | ||
|---|---|---|
static String |
RADIO_CHANGED
Posted to PlayerListener when the tuning settings (usually the frequency) of a radio
Player have been changed automatically for some reason. |
|
static String |
RDS_NEW_ALARM
Posted to PlayerListener when the Programme TYpe (PTY) field of a Player changes to "alarm". |
|
static String |
RDS_NEW_DATA
Posted to PlayerListener when new data
is available via RDS on a Player. |
|
| Method Summary | ||
|---|---|---|
boolean |
getAutomaticSwitching()
Gets the mode of the automatic switching of the transmitter in case of a stronger transmitter with the same PI presence. |
|
boolean |
getAutomaticTA()
Gets the mode of the automatic switching of the program in case of the presence of Traffic Announcement in another program. |
|
Date |
getCT()
Gets the current Clock Time and date (CT). |
|
int[] |
getFreqsByPTY(short PTY)
Gets the frequencies sending the given Programme TYpe. |
|
int[][] |
getFreqsByTA(boolean TA)
Gets the frequencies sending Traffic Announcements (TA). |
|
short |
getPI()
Gets the current Programme Identification code. |
|
String |
getPS()
Gets the current Programme Service name. |
|
String[] |
getPSByPTY(short PTY)
Gets the Programme Service names (PS) sending the given Programme TYpe. |
|
String[] |
getPSByTA(boolean TA)
Gets the Programme Service names (PS) sending Traffic Announcements. |
|
short |
getPTY()
Gets the current Programme TYpe as short. |
|
String |
getPTYString(boolean longer)
Gets the current Programme TYpe as a String with the maximum of 8 or 16 characters in English. |
|
String |
getRT()
Gets the current Radio Text. |
|
boolean |
getTA()
Gets the current status of the Traffic Announcement (TA) switch. |
|
boolean |
getTP()
Gets the current status of the Traffic Programme (TP) switch. |
|
boolean |
isRDSSignal()
Returns the status of the RDS reception. |
|
void |
setAutomaticSwitching(boolean automatic)
Sets the automatic switching of the transmitter in the case of a stronger transmitter with the same PI presence. |
|
void |
setAutomaticTA(boolean automatic)
Sets the automatic switching of the program in case of the presence of Traffic Announcement in another program. |
|
| Field Detail |
|---|
static final String RDS_NEW_DATA
PlayerListener when new data
is available via RDS on a Player. Typically, this happens
within few seconds after tuning to a new channel or when some part of
the RDS data, such as Radio Text, is changed.
When this event is received, the eventData parameter
will be a Short object that is
the Programme Identification of the program where new data was
received.
Value RDS_NEW_DATA is assigned to
RDS_NEW_DATA.
static final String RDS_NEW_ALARM
PlayerListener when the Programme TYpe (PTY) field of a Player changes to "alarm".
When this event is received, the eventData parameter
will be a Short object that is
the Programme Identification of the program where the alarm
was switched on.
Value RDS_ALARM is assigned to RDS_NEW_ALARM.
static final String RADIO_CHANGED
PlayerListener when the tuning settings (usually the frequency) of a radio
Player have been changed automatically for some reason. This typically happens
when the radio has been ordered to change, based on RDS,
the transmitter, for example, to get stronger signal when
moving the location of the mobile
device or when Traffic Announcement is on in an other
program.
When this event is received, the eventData parameter
will be a Short object that is
the Programme Identification of the new program.
Value radio_changed is assigned to
RADIO_CHANGED.
| Method Detail |
|---|
boolean isRDSSignal()
true if RDS signal can be recepted,
false otherwiseString getPS()
String getRT()
short getPTY()
Please note that PTYs in RBDS differ from the ones in RDS.
String getPTYString(boolean longer)
Please note that PTYs in RBDS differ from the ones in RDS.
longer - true for the maximum length of 16 characters,
false for the maximum length of 8 characters
short getPI()
int[] getFreqsByPTY(short PTY)
PTY - Programme TYpe
null if none are found
or EON field is not supported.int[][] getFreqsByTA(boolean TA)
TA - true to get TAs, false to get no TAs
null if none is found or EON field is not supported.String[] getPSByPTY(short PTY)
PTY - the Programme TYpe of programmes whose Programme Service names to get
null if none are found
or EON field is not supported.String[] getPSByTA(boolean TA)
TA - true to get TAs, false to get no TAs
null if none are found
or EON field is not supported.Date getCT()
null if unknownboolean getTA()
true if TA is on,
false otherwiseboolean getTP()
true if TP is on,
false otherwise
void setAutomaticSwitching(boolean automatic)
throws MediaException
automatic - true to turn on the automatic switching,
false to turn it off
MediaException - if setting the given value is not supportedboolean getAutomaticSwitching()
true if the automatic switching is on,
false otherwise
void setAutomaticTA(boolean automatic)
throws MediaException
automatic - true to turn on the automatic switching,
false to turn it off
MediaException - if setting the given value is not supportedboolean getAutomaticTA()
true if the automatic switching is on,
false otherwise
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal