Network Working Group H. Schulzrinne Internet-Draft Columbia U. Intended status: Standards Track Y. Zhao Expires: May 15, 2008 Huawei Technologies November 12, 2007 Applications and Media Information (AMI) Extension to the Presence Information Data Format draft-schulzrinne-simple-ami-00.txt Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire on May 15, 2008. Copyright Notice Copyright (C) The IETF Trust (2007). Abstract The Presence Information Data Format (PIDF) defines a basic format for representing presence information for a presentity. The Application and Media Information (AMI) format described here is an extension that adds optional elements to the Presence Information Data Format (PIDF), describing what music a presentity is listening to, what video it is watching, or what game it is playing. Schulzrinne & Zhao Expires May 15, 2008 [Page 1] Internet-Draft Application and Media Extension for PIDF November 2007 Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Music . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 5. Game . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 6. Web page . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7. Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 8. Security Considerations . . . . . . . . . . . . . . . . . . . . 7 9. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 7 10. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 7 11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 8 11.1. Normative References . . . . . . . . . . . . . . . . . . . 8 11.2. Informative References . . . . . . . . . . . . . . . . . . 8 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 8 Intellectual Property and Copyright Statements . . . . . . . . . . 9 Schulzrinne & Zhao Expires May 15, 2008 [Page 2] Internet-Draft Application and Media Extension for PIDF November 2007 1. Introduction The Presence Information Data Format (PIDF) [1]defines a basic format for representing presence information for a presentity. The Application and Media Information (AMI) format described here is an extension that conveys additional information about the audio that a presentity is listening to, the video that it is watching, the web site it is visiting and the game that it is playing. The information format is closely modeled on the similar XMPP extensions XEP-0118, XEP-0197, XEP-0195, and XEP-0196, respectively. Such information may be considered an extension of rich presence [3] and may be integrated into media players or games. The elements defined in this document may appear in the or data elements of the presence data model [4]. 2. Terminology In this document, the key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" are to be interpreted as described in RFC 2119 [2]. 3. Music The element describes the current piece of music that the presentity is listening to. The elements below are a superset of those described in XMPP extension XEP-0118, adding the composer, genre, start_time, and user_comment elements. All elements are OPTIONAL. artist: The performer of the song or piece. composer: The composer of the song or piece. genre: The musical genre or category. length: The duration of the song or piece in seconds. source: The collection (e.g., album) or other source (e.g., a band website that hosts streams or audio files). start_time: The time the presentity has started listening to the piece.. title: The title of the song or piece. track: A unique identifier for the tune; e.g., the track number within a collection or the specific URI for the object (e.g., a stream or audio file). Schulzrinne & Zhao Expires May 15, 2008 [Page 3] Internet-Draft Application and Media Extension for PIDF November 2007 uri: A URI or URL pointing to information about the song, collection, or artist. user_comment: A user's free-form comments about the piece. +--------------+-----------------------+------------------+ | Element | Example | Datatype | +--------------+-----------------------+------------------+ | artist | Chicago Symphony | xs:string | | composer | Carl Orff | xs:string | | genre | classical | xs:string | | length | 3658 | xs:unsignedShort | | source | Orff Carmina Burana | xs:string | | start_time | 2007-11-12T08:30Z | xs:dateTime | | title | Omnia Sol temperat | xs:string | | track | 4 | xs:string | | user_comment | Stirring | xs:string | | uri | http://example.com/CB | xs:anyURI | +--------------+-----------------------+------------------+ Table 1 4. Video The video element describes a video program that the presentity is watching, e.g., on a DVD, VCR or DVR, from a web site, or a broadcast service such as over-the-air television, satellite TV or CATV. The elements are copied from XMPP XEP-0197. All elements are OPTIONAL. author: The author or producer of the program. cast: The cast members of the program. channel_id: A globally unique channel identifier (URN). channel_name: The name of the TV or satellite channel showing the program. description: A description of the program. duration: The duration of the program (in seconds). end_time: The end time of the program. The end time is a prediction and does not take pausing and other VCR operations into account. episode: The episode number of the program. program_name: The name of the program (for television series) or movie title. program_type: The type of the program, such as comedy, drama, sports or news. start_time: The start time of the program. For time-shifted viewing, the start_time describes the time that the presentity has started watching the video, not the original broadcast time, is shown. Schulzrinne & Zhao Expires May 15, 2008 [Page 4] Internet-Draft Application and Media Extension for PIDF November 2007 subprogram_type: The type of the sub-program (e.g., outtakes on an extended DVD). uri: A URI for the video or relevant service. user_comment: A user's free-form comments about the program. user_rating: The user's personal rating of the program (on a scale of 1 to 10, with 10 being highest). +-----------------+----------------------------+--------------------+ | Element | Example | Datatype | +-----------------+----------------------------+--------------------+ | author | Frank Capra | xs:string | | cast | James Stewart, Donna Reed, | xs:string | | | Lionel Barrymore | | | channel_id | ? | xs:anyURI | | channel_name | WFBR | xs:string | | description | Holiday movie. | xs:string | | duration | 7800 | xs:positiveInteger | | end_time | 2007-11-12T05:10Z | xs:dateTime | | episode | | xs:string | | program_name | It's a wonderful life | xs:string | | program_type | drama | xs:string | | start_time | 2007-11-12T03:00Z | xs:dateTime | | subprogram_type | feature | xs:string | | uri | http://example.com/iawl | xs:anyURI | | user_comment | A Christmas classic | xs:string | | user_rating | 8 | xs:unsignedShort | +-----------------+----------------------------+--------------------+ Table 2 5. Game Game information can be used to gauge what activity the user is engaged in and can be part of social networking applications. The information is similar to the XMPP extension XEP-0196 and contains the information in the table below. All elements are OPTIONAL. character_name: The name of the user's character in the game. character_profile: A URI for a profile of the user's character. name: The name of the game level: The user's level in the game. server_address: The hostname or IP address of the server where the user is playing. Schulzrinne & Zhao Expires May 15, 2008 [Page 5] Internet-Draft Application and Media Extension for PIDF November 2007 server_name: The name of the server where the user is playing. uri: A URI for the game or relevant gaming service. +-------------------+--------------------------+-----------+ | Element | Example | Datatype | +-------------------+--------------------------+-----------+ | character_name | Stentor | xs:string | | character_profile | http://example.com/12345 | xs:anyURI | | name | Worlds of Peace | xs:string | | level | 66 | xs:string | | server_address | wop6.example.com | xs:string | | server_name | WOP Example | xs:string | | uri | http://wp.example.com/ | xs:anyURI | +-------------------+--------------------------+-----------+ Table 3 6. Web page The element describes the web page the presentity is browsing. A presence document MAY contain multiple such elements since a single user may have multiple windows open at the same time. This element is also useful for remote collaboration or joint web browsing. The elements and their characteristics are derived from XMPP XEP-0195. All elements except uri are OPTIONAL, uri is REQUIRED. description: The value of the HTML "description" META tag. keywords: The value of the HTML "keywords" META tag. title: The value of the HTML element uri: The URI of the page. +-------------+-------------------------+-----------+ | Element | Example | Datatype | +-------------+-------------------------+-----------+ | description | RFC 3261 | xs:string | | keywords | SIP, protocol | xs:string | | title | RFC 3261 | xs:string | | uri | http://example.org/3261 | xs:anyURI | +-------------+-------------------------+-----------+ Table 4 Schulzrinne & Zhao Expires May 15, 2008 [Page 6] Internet-Draft Application and Media Extension for PIDF November 2007 7. Example <?xml version="1.0" encoding="UTF-8"?> <presence xmlns="urn:ietf:params:xml:ns:pidf" xmlns:gp="urn:ietf:params:xml:ns:pidf:geopriv10" xmlns:gml="urn:opengis:specification:gml:schema-xsd:feature:v3.0" entity="pres:geotarget@example.com"> <tuple id="sg89ae"> <status> </status> <timestamp>2003-06-22T20:57:29Z</timestamp> </tuple> </presence> Figure 1: Example AMI extension 8. Security Considerations This document defines additional location elements carried by PIDF [1], so its security considerations apply. Revealing ones taste in music or video entertainment can be embarrassing; employers and parents may not appreciate the games being played by a presentity, so presentity discretion and privacy policies are strongly advised. In particular, audio and video tools MUST NOT publish such information without explicit consent of the presentity. The watcher MUST NOT automatically resolves URLs provided in the information elements, as these may lead to malicious or inappropriate material. 9. IANA Considerations A future version of this document will provide IANA considerations. 10. Acknowledgements The data formats were derived from the XMPP extensions XEP-0118, XEP- 0195, XEP-0196 and XEP-0197. Tracking channels was suggested by Erik Huizer and Pascal Decointet. 11. References Schulzrinne & Zhao Expires May 15, 2008 [Page 7] Internet-Draft Application and Media Extension for PIDF November 2007 11.1. Normative References [1] Sugano, H., Fujimoto, S., Klyne, G., Bateman, A., Carr, W., and J. Peterson, "Presence Information Data Format (PIDF)", RFC 3863, August 2004. [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. 11.2. Informative References [3] Schulzrinne, H., Gurbani, V., Kyzivat, P., and J. Rosenberg, "RPID: Rich Presence Extensions to the Presence Information Data Format (PIDF)", RFC 4480, July 2006. [4] Rosenberg, J., "A Data Model for Presence", RFC 4479, July 2006. Authors' Addresses Henning Schulzrinne Columbia University Department of Computer Science 450 Computer Science Building New York, NY 10027 US Phone: +1 212 939 7004 Email: hgs+simple@cs.columbia.edu URI: http://www.cs.columbia.edu/~hgs Yang Zhao Huawei Technologies Bantian Longgang Shenzhen, Guandong 518129 P.R China Phone: +86 755 28780808 Email: yangzhao@huawei.com Schulzrinne & Zhao Expires May 15, 2008 [Page 8] Internet-Draft Application and Media Extension for PIDF November 2007 Full Copyright Statement Copyright (C) The IETF Trust (2007). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Intellectual Property The IETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. Acknowledgment Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA). Schulzrinne & Zhao Expires May 15, 2008 [Page 9]