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
QTSSFileModule
module for compatibility with 3rd Generation Partnership Project (3GPP) players:compatibility_adjust_sdp_media_bandwidth_percent
andenable_player_compatibility
.RTP play information is now enabled by default in the
QTSSReflectorModule
module. Use the new preference,disable_rtp_play_info
to disable RTP Play information. Another newQTSSReflectorModule
preference isreflector_rtp_info_offset_msec
. For compatibility with 3GPP players, these preferences have also been added to theQTSSReflectorModule
module:enable_play_response_range_header
,enable_player_compatibility
, andforce_rtp_info_sequence_and_time
.This new preference has been added to the
QTSSFlowControlModule
module:flow_control_udp_thinning_module_enabled
.
The following changes have been made to existing preferences:
Default size of the
QTSSFileModule
preferenceshared_buffer_unit_k_size
has been increased from 32 to 64.Default size of the
QTSSFileModule
preferenceprivate_buffer_unit_k_size
has 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:
player
text, where text is the name of the RTSP player. The information is sent to the server as the UserAgent header.sendoptions
setting, where setting isyes
orno
. Ifyes
, a Send Options request is made before theDESCRIBE
statement.requestrandomdata
setting, where setting isyes
orno
. Set setting toyes
to ask for random data from the server.randomdatasize
setting, 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.html
DevNotes.html
SourceCodeFAQ.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