asternet/docs/html/M_AsterNET_FastAGI_AGIScript_ControlStreamFile_3.htm
2016-10-03 11:15:07 +02:00

40 lines
14 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<html><head><meta http-equiv="X-UA-Compatible" content="IE=edge" /><link rel="shortcut icon" href="../icons/favicon.ico" /><link rel="stylesheet" type="text/css" href="../styles/branding.css" /><link rel="stylesheet" type="text/css" href="../styles/branding-en-US.css" /><script type="text/javascript" src="../scripts/branding.js"> </script><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>AGIScript.ControlStreamFile Method (String, String, Int32, String, String, String)</title><meta name="Language" content="en-us" /><meta name="Microsoft.Help.Id" content="M:AsterNET.FastAGI.AGIScript.ControlStreamFile(System.String,System.String,System.Int32,System.String,System.String,System.String)" /><meta name="Description" content="Plays the given file, allowing playback to be interrupted by the given digits, if any, and allows the listner to control the stream. If offset is provided then the audio will seek to sample offset before play starts." /><meta name="Microsoft.Help.ContentType" content="Reference" /><meta name="BrandingAware" content="true" /><meta name="container" content="AsterNET.FastAGI" /><meta name="file" content="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_3" /><meta name="guid" content="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_3" /><link rel="stylesheet" type="text/css" href="../styles/branding-Website.css" /><script type="text/javascript" src="../scripts/jquery-1.11.0.min.js"></script><script type="text/javascript" src="../scripts/branding-Website.js"></script></head><body onload="OnLoad('cs')"><input type="hidden" id="userDataCache" class="userDataStyle" /><div class="pageHeader" id="PageHeader">AsterNet Class Library (Sandcastle documentation)<form id="SearchForm" method="get" action="#" onsubmit="javascript:TransferToSearchPage(); return false;"><input id="SearchTextBox" type="text" maxlength="200" /><button id="SearchButton" type="submit"></button></form></div><div class="pageBody"><div class="leftNav" id="leftNav"><div id="tocNav"><div class="toclevel0" data-toclevel="0"><a class="tocCollapsed" onclick="javascript: Toggle(this);" href="#!"></a><a data-tochassubtree="true" href="79b6241e-05a3-441c-b6a1-51f2b5b7f265.htm" title="AsterNet Class Library (Sandcastle documentation)" tocid="roottoc">AsterNet Class Library (Sandcastle documentation)</a></div><div class="toclevel0" data-toclevel="0"><a class="tocCollapsed" onclick="javascript: Toggle(this);" href="#!"></a><a data-tochassubtree="true" href="N_AsterNET_FastAGI.htm" title="AsterNET.FastAGI" tocid="N_AsterNET_FastAGI">AsterNET.FastAGI</a></div><div class="toclevel0" data-toclevel="0"><a class="tocCollapsed" onclick="javascript: Toggle(this);" href="#!"></a><a data-tochassubtree="true" href="T_AsterNET_FastAGI_AGIScript.htm" title="AGIScript Class" tocid="T_AsterNET_FastAGI_AGIScript">AGIScript Class</a></div><div class="toclevel0" data-toclevel="0"><a class="tocCollapsed" onclick="javascript: Toggle(this);" href="#!"></a><a data-tochassubtree="true" href="Methods_T_AsterNET_FastAGI_AGIScript.htm" title="AGIScript Methods" tocid="Methods_T_AsterNET_FastAGI_AGIScript">AGIScript Methods</a></div><div class="toclevel1" data-toclevel="1" data-childrenloaded="true"><a class="tocExpanded" onclick="javascript: Toggle(this);" href="#!"></a><a data-tochassubtree="true" href="Overload_AsterNET_FastAGI_AGIScript_ControlStreamFile.htm" title="ControlStreamFile Method " tocid="Overload_AsterNET_FastAGI_AGIScript_ControlStreamFile">ControlStreamFile Method </a></div><div class="toclevel2" data-toclevel="2"><a data-tochassubtree="false" href="M_AsterNET_FastAGI_AGIScript_ControlStreamFile.htm" title="ControlStreamFile Method (String)" tocid="M_AsterNET_FastAGI_AGIScript_ControlStreamFile">ControlStreamFile Method (String)</a></div><div class="toclevel2" data-toclevel="2"><a data-tochassubtree="false" href="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_1.htm" title="ControlStreamFile Method (String, String)" tocid="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_1">ControlStreamFile Method (String, String)</a></div><div class="toclevel2" data-toclevel="2"><a data-tochassubtree="false" href="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_2.htm" title="ControlStreamFile Method (String, String, Int32)" tocid="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_2">ControlStreamFile Method (String, String, Int32)</a></div><div class="toclevel2 current" data-toclevel="2"><a data-tochassubtree="false" href="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_3.htm" title="ControlStreamFile Method (String, String, Int32, String, String, String)" tocid="M_AsterNET_FastAGI_AGIScript_ControlStreamFile_3">ControlStreamFile Method (String, String, Int32, String, String, String)</a></div></div><div id="tocResizableEW" onmousedown="OnMouseDown(event);"></div><div id="TocResize" class="tocResize"><img id="ResizeImageIncrease" src="../icons/TocOpen.gif" onclick="OnIncreaseToc()" alt="Click or drag to resize" title="Click or drag to resize"><img id="ResizeImageReset" src="../icons/TocClose.gif" style="display:none" onclick="OnResetToc()" alt="Click or drag to resize" title="Click or drag to resize"></div></div><div class="topicContent" id="TopicContent"><table class="titleTable"><tr><td class="logoColumn"><img src="../icons/Help.png" /></td><td class="titleColumn">AGIScript<span id="LST975AC40_0"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_0?cpp=::|nu=.");</script>ControlStreamFile Method (String, String, Int32, String, String, String)</td></tr></table><span class="introStyle"></span><div class="summary">
Plays the given file, allowing playback to be interrupted by the given
digits, if any, and allows the listner to control the stream.<br />
If offset is provided then the audio will seek to sample offset before play
starts.<br />
Returns 0 if playback completes without a digit being pressed, or the ASCII
numerical value of the digit if one was pressed, or -1 on error or if the
channel was disconnected. <br />
Remember, the file extension must not be included in the filename.<br />
Available since Asterisk 1.2
</div><p> </p><strong>Namespace:</strong> <a href="N_AsterNET_FastAGI.htm">AsterNET.FastAGI</a><br /><strong>Assembly:</strong> AsterNET (in AsterNET.dll) Version: 1.0.0.0 (1.0.0.0)<div class="collapsibleAreaRegion"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('ID1RB')" onkeypress="SectionExpandCollapse_CheckKey('ID1RB', event)" tabindex="0"><img id="ID1RBToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />Syntax</span></div><div id="ID1RBSection" class="collapsibleSection"><div class="codeSnippetContainer"><div class="codeSnippetContainerTabs"><div id="ID0EDCA_tab1" class="codeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','cs','1','4');return false;">C#</a></div><div id="ID0EDCA_tab2" class="codeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','vb','2','4');return false;">VB</a></div><div id="ID0EDCA_tab3" class="codeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','cpp','3','4');return false;">C++</a></div><div id="ID0EDCA_tab4" class="codeSnippetContainerTab"><a href="#" onclick="javascript:ChangeTab('ID0EDCA','fs','4','4');return false;">F#</a></div></div><div class="codeSnippetContainerCodeContainer"><div class="codeSnippetToolBar"><div class="codeSnippetToolBarText"><a id="ID0EDCA_copyCode" href="#" onclick="javascript:CopyToClipboard('ID0EDCA');return false;" title="Copy">Copy</a></div></div><div id="ID0EDCA_code_Div1" class="codeSnippetContainerCode" style="display: block"><pre xml:space="preserve"><span class="keyword">protected</span> <span class="identifier">int</span> <span class="identifier">ControlStreamFile</span>(
<span class="identifier">string</span> <span class="parameter">file</span>,
<span class="identifier">string</span> <span class="parameter">escapeDigits</span>,
<span class="identifier">int</span> <span class="parameter">offset</span>,
<span class="identifier">string</span> <span class="parameter">forwardDigit</span>,
<span class="identifier">string</span> <span class="parameter">rewindDigit</span>,
<span class="identifier">string</span> <span class="parameter">pauseDigit</span>
)</pre></div><div id="ID0EDCA_code_Div2" class="codeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">Protected</span> <span class="keyword">Function</span> <span class="identifier">ControlStreamFile</span> (
<span class="parameter">file</span> <span class="keyword">As</span> <span class="identifier">String</span>,
<span class="parameter">escapeDigits</span> <span class="keyword">As</span> <span class="identifier">String</span>,
<span class="parameter">offset</span> <span class="keyword">As</span> <span class="identifier">Integer</span>,
<span class="parameter">forwardDigit</span> <span class="keyword">As</span> <span class="identifier">String</span>,
<span class="parameter">rewindDigit</span> <span class="keyword">As</span> <span class="identifier">String</span>,
<span class="parameter">pauseDigit</span> <span class="keyword">As</span> <span class="identifier">String</span>
) <span class="keyword">As</span> <span class="identifier">Integer</span></pre></div><div id="ID0EDCA_code_Div3" class="codeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">protected</span>:
<span class="identifier">int</span> <span class="identifier">ControlStreamFile</span>(
<span class="identifier">String</span>^ <span class="parameter">file</span>,
<span class="identifier">String</span>^ <span class="parameter">escapeDigits</span>,
<span class="identifier">int</span> <span class="parameter">offset</span>,
<span class="identifier">String</span>^ <span class="parameter">forwardDigit</span>,
<span class="identifier">String</span>^ <span class="parameter">rewindDigit</span>,
<span class="identifier">String</span>^ <span class="parameter">pauseDigit</span>
)</pre></div><div id="ID0EDCA_code_Div4" class="codeSnippetContainerCode" style="display: none"><pre xml:space="preserve"><span class="keyword">member</span> <span class="identifier">ControlStreamFile</span> :
<span class="parameter">file</span> : <span class="identifier">string</span> *
<span class="parameter">escapeDigits</span> : <span class="identifier">string</span> *
<span class="parameter">offset</span> : <span class="identifier">int</span> *
<span class="parameter">forwardDigit</span> : <span class="identifier">string</span> *
<span class="parameter">rewindDigit</span> : <span class="identifier">string</span> *
<span class="parameter">pauseDigit</span> : <span class="identifier">string</span> <span class="keyword">-&gt;</span> <span class="identifier">int</span>
</pre></div></div></div><script type="text/javascript">AddLanguageTabSet("ID0EDCA");</script><h4 class="subHeading">Parameters</h4><dl><dt><span class="parameter">file</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/s1wwdcbf" target="_blank">System<span id="LST975AC40_1"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_1?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>String</a><br />the name of the file to stream, must not include extension.</dd><dt><span class="parameter">escapeDigits</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/s1wwdcbf" target="_blank">System<span id="LST975AC40_2"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_2?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>String</a><br />contains the digits that allow the user to interrupt this command.</dd><dt><span class="parameter">offset</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/td2s409d" target="_blank">System<span id="LST975AC40_3"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_3?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>Int32</a><br />the offset samples to skip before streaming.</dd><dt><span class="parameter">forwardDigit</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/s1wwdcbf" target="_blank">System<span id="LST975AC40_4"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_4?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>String</a><br />the digit for fast forward.</dd><dt><span class="parameter">rewindDigit</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/s1wwdcbf" target="_blank">System<span id="LST975AC40_5"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_5?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>String</a><br />the digit for rewind.</dd><dt><span class="parameter">pauseDigit</span></dt><dd>Type: <a href="http://msdn2.microsoft.com/en-us/library/s1wwdcbf" target="_blank">System<span id="LST975AC40_6"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_6?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>String</a><br />the digit for pause and unpause.</dd></dl><h4 class="subHeading">Return Value</h4>Type: <a href="http://msdn2.microsoft.com/en-us/library/td2s409d" target="_blank">Int32</a><br />result code</div><div class="collapsibleAreaRegion" id="seeAlsoSection"><span class="collapsibleRegionTitle" onclick="SectionExpandCollapse('ID2RB')" onkeypress="SectionExpandCollapse_CheckKey('ID2RB', event)" tabindex="0"><img id="ID2RBToggle" class="collapseToggle" src="../icons/SectionExpanded.png" />See Also</span></div><div id="ID2RBSection" class="collapsibleSection"><h4 class="subHeading">Reference</h4><div class="seeAlsoStyle"><a href="T_AsterNET_FastAGI_AGIScript.htm">AGIScript Class</a></div><div class="seeAlsoStyle"><a href="Overload_AsterNET_FastAGI_AGIScript_ControlStreamFile.htm">ControlStreamFile Overload</a></div><div class="seeAlsoStyle"><a href="N_AsterNET_FastAGI.htm">AsterNET.FastAGI Namespace</a></div><div class="seeAlsoStyle"><a href="T_AsterNET_FastAGI_Command_ControlStreamFileCommand.htm">AsterNET.FastAGI.Command<span id="LST975AC40_7"></span><script type="text/javascript">AddLanguageSpecificTextSet("LST975AC40_7?cs=.|vb=.|cpp=::|nu=.|fs=.");</script>ControlStreamFileCommand</a></div></div></div></div><div id="pageFooter" class="pageFooter"> </div></body></html>