Retired Document
Important: Apple recommends that developers explore QTKit and Core Video for new development in this technology area. See QTKit Framework Reference and Core Video Programming Guide for more information.
About This Manual
This manual describes version 5.0 of the programming interface for creating QuickTime Streaming Server (QTSS) modules for the open source Darwin Streaming Server. The QTSS programming interface provides an easy way for developers to add new functionality to the Streaming Server. This version of the programming interface is compatible with QuickTime Streaming Server version 5.5.
This chapter describes the callback rotuines and data types that modules use to call the QuickTime Streaming Server.
What’s New
Version 5.0 of the QTSS programming interface provides the following new features:
These new internal server preferences have been added:
disable_thinning,player_requires_rtp_header_info, andplayer_requires_bandwidth_adjustment.These new preferences have been added to the
QTSSFileModulemodule for compatibility with 3rd Generation Partnership Project (3GPP) players:compatibility_adjust_sdp_media_bandwidth_percentandenable_player_compatibility.RTP play information is now enabled by default in the
QTSSReflectorModulemodule. Use the new preference,disable_rtp_play_infoto disable RTP Play information. Another newQTSSReflectorModulepreference isreflector_rtp_info_offset_msec. For compatibility with 3GPP players, these preferences have also been added to theQTSSReflectorModulemodule:enable_play_response_range_header,enable_player_compatibility, andforce_rtp_info_sequence_and_time.This new preference has been added to the
QTSSFlowControlModulemodule:flow_control_udp_thinning_module_enabled.
The following changes have been made to existing preferences:
Default size of the
QTSSFileModulepreferenceshared_buffer_unit_k_sizehas been increased from 32 to 64.Default size of the
QTSSFileModulepreferenceprivate_buffer_unit_k_sizehas been increased from 32 to 64.
The enable_rtp_play_info preference
has been removed from the QTSSReflectorModule module.
The -D command
line option has been added to the StreamingServer. When specified,
the -D option outputs
performance status information.
The file streamingloadtool.conf,
installed in /Library/QuickTimeStreaming/Config,
has new file tags:
playertext, where text is the name of the RTSP player. The information is sent to the server as the UserAgent header.sendoptionssetting, where setting isyesorno. Ifyes, a Send Options request is made before theDESCRIBEstatement.requestrandomdatasetting, where setting isyesorno. Set setting toyesto ask for random data from the server.randomdatasizesetting, where setting is a number from 0 to 262144 that specifies the number of random bytes the server should send.
Conventions Used in This Manual
The Letter Gothic font
is used to indicate text that you type or see displayed. This manual includes
special text elements to highlight important or supplemental information:
For More Information
Go to http://www.opensource.apple.com to
register as a member of the Apple open source community. Then download
the source code for the Darwin Streaming Server at http://www.publicsource.apple.com/projects/streaming.
The source code’s Documentation directory contains valuable information:
AboutTheSource.htmlDevNotes.htmlSourceCodeFAQ.html
The following RFCs provide additional information of interest to developers of QuickTime Streaming Server modules and are available at many locations on the Internet:
RFC 2326, Real Time Streaming Protocol (RTSP)
RFC 1889, RTP: A Transport Protocol for Real-Time Applications
RFC 2327, SDP: Session Description Protocol
RFC 2616, HTTP 1.1
For an overview of the Darwin Streaming Server and links to the latest QuickTime information, go to http://developer.apple.com/darwin/projects/streaming.
Go to http://developer.apple.com/documentation/quicktime for
QuickTime developer documentation.
Communicate with other Darwin Streaming Server developers by joining the discussion list at http://lists.apple.com/mailman/listinfo/streaming-server-dev.
See what with other Darwin Streaming Server developers are doing by joining the discussion list at http://lists.apple.com/mailman/listinfo/publicsource-modifications.
Copyright © 2002, 2009 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2009-06-01