This appendix describes the device capabilities that you can specify for the devices that you use with the Sun Java System Content Delivery Server. It also provides a sample specification for a common device. See Managing Devices for information on how to specify device capabilities.
Descriptions of the Capabilities
Device capabilities are defined in the following categories:
See Specifying a Capability Value for more information.
System Capabilities
System capabilities are primarily used by the Content Delivery Server. They define capabilities that a device must have to perform Content Delivery Server functionality. For instance, system capabilities define whether a device supports Short Message Service (SMS) or WAP Push.
Push Type takes a string value that specifies the device's delivery mechanisms: mms, sms, or wap.
Mandatory Capabilities
Mandatory capabilities are capabilities that must be specified for a device to accept MIDlet applications. TABLE A-1 lists the mandatory capabilities for devices used with the Content Delivery Server.
TABLE A-1 Mandatory Capabilities
|
Name
|
Type
|
Description
|
Example Value
|
|
MicroEdition-Configuration
|
String
|
Software Platform specific: Connected Limited Device (CLDC) Configuration version.
|
CLDC-1.0
|
|
MicroEdition-Profile
|
String
|
Software Platform specific: Mobile Information Device Profile (MIDP) version
|
MIDP-1.0
|
Content Delivery Server-Specific Capabilities
Content Delivery Server-specific capabilities apply to the server's functionality and are not industry standard. Devices must have the Content Delivery Server-specific capabilities listed in TABLE A-2 if they are to be used with the server.
TABLE A-2 Content Delivery Server-Specific Capabilities
|
Name
|
Type
|
Description
|
Example Value
|
|
Supported Libraries
|
List
|
System capability for API validation.
Enables you to set the libraries that the device supports. Libraries define the API sets supported. This capability enables the Content Delivery Server to match an application to a device that supports the libraries used by the application.
|
MIDP-1.0
|
|
Descriptor Template
|
List
|
System capability for two-step download of content.
The template specified is used to generate the descriptor file for content other than MIDlets, if two-step download is specified. If this option is not selected, content is delivered as either OTA one-step or as an SMS message.
|
General Content Descriptor
|
Browser Capabilities
Browser capability refers to the browser type specified for a device. A string value specifying the browser that is rendering markup on the device is given. For example, Browser Type can have one of the following values:
- WML-1_2
- XHTML-NokiaSeries40
- XHTML-Symbain
- XHTML-UP
User Interface and Software Capabilities
The Content Delivery Server uses the user interface and software capabilities to refine the capability matching process.
TABLE A-3 lists the user interface and software capabilities.
TABLE A-3 User Interface and Software Capabilities
|
Name
|
Type
|
Description
|
Example Value
|
|
Bits Per Pixel
|
Integer
|
Hardware platform-specific: Bits Per Pixel
Defines the minimum number of bits per pixel that a device must have to run the application.
|
16
|
|
Ccpp Accept String
|
List
|
Software platform-specific: List of MIME types that the device supports for OTA download.
|
application/java-archive
text/plain
image/gif
|
|
Ccpp Accept Language
|
List
|
Software platform-specific: Locale
Defines the locale supported by the device. Select one or more entries from the list.
|
en_US
|
|
Color Capable
|
Boolean
|
Hardware platform-specific: Color Capable
Defines whether or not the device has a color screen.
|
Yes or No
|
|
Confirm Capable
|
Boolean
|
Software platform-specific: Confirm Capable
Defines whether or not the device sends a confirmation (MIDlet-Install-Notify) after a MIDlet is installed.
|
Yes or No
|
|
Delivery Type
|
List
|
Software platform-specific: Delivery Type
Defines the content delivery mechanism the device supports.
|
OTA
NSM
EMS
|
|
Image Capable
|
Boolean
|
Hardware platform-specific: Image Capable
Defines whether or not the device supports images.
|
Yes or No
|
|
Input CharSet
|
List
|
Hardware platform-specific: Input CharSet
Defines the list of character sets that the device can accept.
|
US-ASCII
ISO-8859-1
|
|
Maximum Application Size
|
Integer
|
The maximum size of an application, in bytes, that can be supported by the device.
|
30000
|
|
Number of softkeys
|
Integer
|
Software platform-specific: Defines the number of soft keys the device requires.
|
2
|
|
Output CharSet
|
List
|
Hardware platform-specific: Defines the list of character sets supported by the device for output to the display.
|
US-ASCII
ISO-8859-1
|
|
Screen Height
|
Integer
|
Hardware platform-specific: The size of the device's screen height in units of pixels.
|
128
|
|
Screen Width
|
Integer
|
Hardware platform-specific: The size of the device's screen width in units of pixels.
|
128
|
Specifying a Capability Value
Depending on the capability, you can specify the value as a List, Integer, or Boolean.
List
A list value can contain one or more values. To select multiple values from the list provided, hold the Control key while clicking on each item that you want to include. Each value is shown on a separate line when the items are displayed as a string. For example, Supported Libraries takes a list value that can be either DOJA-1.0, MIDP-1.0, or MIDP-2.0.
Integer
An integer value is a numeric value. The integer must be a whole number. The value does not support decimal points. For example, Number of Softkeys takes an integer value, such as 2.
Boolean
A valid Boolean value for a device capability is either yes or no. For example, Image Capable can take a Boolean value of Yes.
Device Specifications
This section provides a sample of a device capabilities specification for a device supported by the Content Delivery Server, the Nokia 6310i default device. The last section provides blank tables that you can fill out for other devices that you want to support.
|
Note - The device information given in the specifications table for the Nokia 6310i shows only the device capabilities that are supported in the Content Delivery Server. Any desired MIME types that are supported by a device but are not supported for the device in the Content Delivery Server must be added manually by the Administrator.
|
Nokia 6310i
TABLE A-4 shows the specifications for the Nokia 6310i device.
TABLE A-4 Nokia 6310i Device Specifications
|
Capability
|
Value
|
|
Browser Type
|
WML-1_2
|
|
Bits Per Pixel
|
16
|
|
Ccpp Accept Language
|
en_US
|
|
Ccpp Accept String
|
application/java-archive
image/gif
image/vnd.wap.wbmp
text/plain
text/vnd.sun.j2me.app-descriptor
|
|
Color Capable
|
Yes
|
|
Confirm Capable
|
Yes
|
|
Delivery Type
|
OTA
|
|
Image Capable
|
Yes
|
|
Input CharSet
|
US_ASCII
ISO-8859-1
UTF-8
UTF-16
|
|
Maximum Application Size
|
30000
|
|
MicroEdition-Configuration
|
CLDC-1.0
|
|
MicroEdition-Profile
|
MIDP-1.0
|
|
Number of softkeys
|
2
|
|
Output CharSet
|
US_ASCII
ISO-8859-1
UTF-8
UTF-16
|
|
Push Type
|
wap
|
|
Screen Height
|
65
|
|
Screen Width
|
96
|
User-Defined Devices
The following blank tables are provided for you so you can enter information for the devices that you add to the Content Delivery Server.
TABLE A-5 Device Specifications for a User-Defined Device 1
|
Capability
|
Value
|
|
Browser Type
|
|
|
Bits Per Pixel
|
|
|
Ccpp Accept String
|
|
|
Ccpp Accept Language
|
|
|
MicroEdition-Configuration
|
|
|
Color Capable
|
|
|
Confirm Capable
|
|
|
Delivery Type
|
|
|
Image Capable
|
|
|
Input CharSet
|
|
|
Maximum Application Size
|
|
|
MicroEdition-Profile
|
|
|
Number of softkeys
|
|
|
Output CharSet
|
|
|
Push Type
|
|
|
Screen Height
|
|
|
Screen Width
|
|
TABLE A-6 Device Specifications for a User-Defined Device 2
|
Capability
|
Value
|
|
Browser Type
|
|
|
Bits Per Pixel
|
|
|
Ccpp Accept String
|
|
|
Ccpp Accept Language
|
|
|
MicroEdition-Configuration
|
|
|
Color Capable
|
|
|
Confirm Capable
|
|
|
Delivery Type
|
|
|
Image Capable
|
|
|
Input CharSet
|
|
|
Maximum Application Size
|
|
|
MicroEdition-Profile
|
|
|
Number of softkeys
|
|
|
Output CharSet
|
|
|
Push Type
|
|
|
Screen Height
|
|
|
Screen Width
|
|
| Administration Guide
|
819-3209-10
|
   
|
Copyright © 2005, Sun Microsystems, Inc. All Rights Reserved.