[go: up one dir, main page]
Menu ▾ ▴

[r17]: / mms / __init__.py  Maximize  Restore  History

Download this file

65 lines (51 with data), 3.1 kB 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
#!/usr/bin/env python

#

# This library is free software, distributed under the terms of

# the GNU Lesser General Public License Version 2.

# See the COPYING file included in this archive

#

# Copyright (C) 2007 Francois Aucamp <faucamp@csir.co.za>

#

# The docstrings in this module contain epytext markup; API documentation

# may be created by processing this file with epydoc: http://epydoc.sf.net



"""

Python Multimedia Messaging Service (MMS) library



The C{mms} module provides several classes for the creation and manipulation of

MMS messages (multimedia messages) used in mobile devices such as cellular

telephones.



Multimedia Messaging Service (MMS) is a messaging service for the mobile

environment standardized by the WAP Forum and 3GPP. To the end-user MMS is

very similar to the text-based Short Message Service (SMS): it provides

automatic immediate delivery for user-created content from device to device.



In addition to text, however, MMS messages can contain multimedia content such

as still images, audio clips and video clips, which are binded together

into a "mini presentation" (or slideshow) that controls for example, the order

in which images are to appear on the screen, how long they will be displayed,

when an audio clip should be played, etc. Furthermore, MMS messages do not have

the 160-character limit of SMS messages.



An MMS message is a multimedia presentation in one entity; it is not a text

file with attachments.

 

This library enables the creation of MMS messages with full support for

presentation layout, and multimedia data parts such as JPEG, GIF, AMR, MIDI,

3GP, etc. It also allows the decoding and unpacking of received MMS messages.



@version: 0.2

@author: Francois Aucamp C{<faucamp@csir.co.za>}

@license: GNU Lesser General Public License, version 2.1

@note: References used in the code and this document:

    1. MMS Conformance Document version 2.0.0, 6 February 2002

    U{www.bogor.net/idkf/bio2/mobile-docs/mms_conformance_v2_0_0.pdf}



    2. Forum Nokia, "How To Create MMS Services, Version 4.0"

    U{http://forum.nokia.com/info/sw.nokia.com/id/a57a4f20-b7f2-475b-b426-19eff18a5afb/How_To_Create_MMS_Services_v4_0_en2.pdf.html}



    3. Wap Forum/Open Mobile ALliance, "WAP-206 MMS Client Transactions"

    U{http://www.openmobilealliance.org/tech/affiliates/LicenseAgreement.asp?DocName=/wap/wap-206-mmsctr-20020115-a.pdf}



    4. Wap Forum/Open Mobile Alliance, "WAP-209 MMS Encapsulation Protocol"

    U{http://www.openmobilealliance.org/tech/affiliates/LicenseAgreement.asp?DocName=/wap/wap-209-mmsencapsulation-20020105-a.pdf}



    5. Wap Forum/Open Mobile Alliance, "WAP-230 Wireless Session Protocol Specification"

    U{http://www.openmobilealliance.org/tech/affiliates/LicenseAgreement.asp?DocName=/wap/wap-230-wsp-20010705-a.pdf}



    6. IANA: "Character Sets"

    U{http://www.iana.org/assignments/character-sets}

"""



# Expose the high-level classes directly

from message import MMSMessage, MMSMessagePage, DataPart

# ...as well as the high-level decoder

from mms_pdu import MMSDecoder