Upload
others
View
2
Download
0
Embed Size (px)
Citation preview
Tizen - Web Application
Tizen Content API Overview
Ajou Univrsity
Contents
• Introduction to Tizen Content API• ContentManager interface• update• updateBatch• getDirectories• find• scanFile• setChangeListener• unsetChangeListener
Ajou Univrsity
Introduction to Tizen Content API
Ajou Univrsity
Intro. to Tizen Content API
• Tizen allows you to search for contents in local devices using Content API• Type of contents include images, videos, music and etc.• Contents API also supports management tasks such as:
• Viewing• Updating content attributes
• Types of tizen contents are:• Content
• General interface for contents• VideoContent, AudioContents, ImageContents
• An extension of Content interface to contain specific attributes for each content type
• AudioContentLyrics• Lyrics content for songs. Can be synchronized with songs
using timestamps
Ajou Univrsity
Intro. to Tizen Content API
• Main features of Tizen Content API are:• Content Retrieval
• Browsing and searching for content directories and contents
• Can use filters to search for content items• Allows sorting of the search results
• Content Management• Viewing and editing of content item details:
• Common file information and metadata attributes• Provides scanning that allows you to find moved or copied
items• Content Change Notifications
• Keeps contents in an application synchronized with external content manager
Ajou Univrsity
ContentManager Interface
• ContentManager interface is used for all content-related functionalities
• Provides operations to retrieve and manipulate content
Ajou Univrsity
Tizen Content API - ContentManager
• Update• Updates attributes of the content in content database
synchronously• When an application has changed some attributes of a content,
this method allows writing it back to the content database• Parameter is the content to be changed
• Example
https://developer.tizen.org/dev-guide/2.2.1/org.tizen.web.device.apireference/tizen/content.html#::Content::ContentManager
The attribute “description” of this
content is changed.
The update function
updates this change to the
content database
https://developer.tizen.org/dev-guide/2.2.1/org.tizen.web.device.apireference/tizen/content.html#::Content::ContentManager
Ajou Univrsity
Tizen Content API - ContentManager
• updateBatch
• Updates a “batch of content attributes” in the content database synchronously
• When an application has changed any attributes in “array of content”, this method allows writing them back to the content database
• Parameters are:• Contents – an array of contents to be changed• SuccessCallback – optional, nullable function. Launched when
attributes have been changed• ErrorCallback – optional, nullable function. Launched with following
errors:• InvalidValuesError: If any of the input parameters contain an invalid value.• UnknownError: In any other error case.
Ajou Univrsity
Tizen Content API - ContentManager
• updateBatch Example
Defining callback
functions to display
success or error
message
Increment the “rating”
attribute by 1
Ajou Univrsity
Tizen Content API - ContentManager
• getDirectories• Returns a list of content directory objects
• Parameters:• successCallback: Function called when content directories have
been retrieved successfully.• This callback function can be used to process the directory objects
that are returned
• errorCallback [optional] [nullable]: Function called when an error has occurred
Ajou Univrsity
Tizen Content API - ContentManager
• getDirectories Example
A function to print the
directory information
Upon finding directories,
the callback function
calls the printing
function
Ajou Univrsity
Tizen Content API - ContentManager
• find• Finds contents using filter• The filter allows precise searching - "return all songs by artist U2,
ordered by name"
• Parameters• successCallback: Function called when a content have been retrieved.
• errorCallback [optional] [nullable]: Function called when an error has occurred.
• directoryId [optional] [nullable]: Directory ID that is use to select content to retrieve in a specified directory.
• filter [optional] [nullable]: Filter that is used to select content to retrieve.
• sortMode [optional] [nullable]: Used to determine the sort order in which the content are returned.
• count [optional] [nullable]: Maximum amount of content to return.
• offset [optional] [nullable]: Offset of the result set.
Ajou Univrsity
Tizen Content API - ContentManager
• Example using find
Setting the sorting mode
and search conditions
Print the attributes of
each song
Updates the offset and
keeps searching
Ajou Univrsity
Tizen Content API - ContentManager
• scanFile
• Scan a file to create or update a content in the content database• When an application creates or updates a content, this method
allows scan it to insert or update the content in the content database
• Parameters:• contentURI: The URI of the content to scan.• successCallback [optional] [nullable]: Function called when
scanning has been completed.• errorCallback [optional] [nullable]: Function called when an error
has occurred.
Ajou Univrsity
Tizen Content API - ContentManager
• scanFile Example
Scans the specified path –
file:///opt/usr/media/ for tizen.jpg
Print success or error
message using
callback functions
/opt/usr/media//opt/usr/media/tizen.jpg
Ajou Univrsity
Tizen Content API - ContentManager
• setChangeListener
• Sets a listener to receive notifications about content changes and execute the callback function when a change is captured
• Parameter:• changeCallback: A callback to be invoked for receiving content
change notification
Ajou Univrsity
Tizen Content API - ContentManager
• setChangeListener Example
Defining functions of the listener.
This listener will be used as a
content’s change listener
Content’s change listener is set to the
listener defined above
Ajou Univrsity
Tizen Content API - ContentManager
• unsetChangeListener
• Unsets the listener to unsubscribes from receiving notificationfor any content changes
• unsetChangeListener Example
The content’s change listener is unset and
the content’s change notification will not
be handled by a listener
Ajou Univrsity
References
• Jaygarl, Hojun. "Multimedia." Professional Tizen progra
mming development. Chichester: Wrox, 2014. 89-95. Pri
nt.
• https://developer.tizen.org/dev-guide/2.2.1/org.tizen.we
b.device.apireference/tizen/content.html