PageRenderTime 2024ms CodeModel.GetById 30ms RepoModel.GetById 29ms app.codeStats 2ms

/frameworks/projects/playerglobal/bundles/zh_CN/docs/flash.media.xml

https://github.com/adufilie/flex-sdk
XML | 2458 lines | 1823 code | 617 blank | 18 comment | 0 complexity | 6dd34f8e7fea92828f5c6c9459dbe726 MD5 | raw file
Possible License(s): Apache-2.0 
    

  1. <?xml version="1.0" encoding="UTF-8"?>
    2. 

  2. <!--
    3. 

  3. 

  4.   Licensed to the Apache Software Foundation (ASF) under one or more
    5. 

  5.   contributor license agreements.  See the NOTICE file distributed with
    6. 

  6.   this work for additional information regarding copyright ownership.
    7. 

  7.   The ASF licenses this file to You under the Apache License, Version 2.0
    8. 

  8.   (the "License"); you may not use this file except in compliance with
    9. 

  9.   the License.  You may obtain a copy of the License at
    10. 

  10. 

  11.       http://www.apache.org/licenses/LICENSE-2.0
    12. 

  12. 

  13.   Unless required by applicable law or agreed to in writing, software
    14. 

  14.   distributed under the License is distributed on an "AS IS" BASIS,
    15. 

  15.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    16. 

  16.   See the License for the specific language governing permissions and
    17. 

  17.   limitations under the License.
    18. 

  18. 

  19. -->
    20. 

  20. <apiPackage xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" id="flash.media" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiPackage/apiPackage "><apiName class="- topic/title reference/title apiRef/apiName ">flash.media</apiName><apiDetail class="- topic/body reference/refbody apiRef/apiDetail "/><apiClassifier languages="" id="flash.media:ID3Info" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">ID3Info</apiName><shortdesc class="- topic/shortdesc ">
    21. 

  21. 	 ID3Info 类包含反映 ID3 元数据的属性。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    22. 

  22. 	 ID3Info 类包含反映 ID3 元数据的属性。可以通过访问 Sound 类的 <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> 属性来获取 MP3 文件的其他元数据；例如，<codeph class="+ topic/ph pr-d/codeph ">mySound.id3.TIME</codeph>。有关详细信息，请在 <xref href="http://www.id3.org" class="- topic/xref ">http://www.id3.org</xref> 上参阅 <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> 条目和 ID3 标签定义。
    23. 

  23. 	 </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/id3" class="- topic/link "><linktext class="- topic/linktext ">Sound.id3</linktext></link></related-links><apiValue id="flash.media:ID3Info:album" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">album</apiName><shortdesc class="- topic/shortdesc ">
    24. 

  24. 		 专辑的名称；对应于 ID3 2.0 标签 TALB。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    25. 

  25. 		 专辑的名称；对应于 ID3 2.0 标签 TALB。
    26. 

  26. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:ID3Info:artist" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">artist</apiName><shortdesc class="- topic/shortdesc ">
    27. 

  27. 		 歌手的姓名；对应于 ID3 2.0 标签 TPE1。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    28. 

  28. 		 歌手的姓名；对应于 ID3 2.0 标签 TPE1。
    29. 

  29. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:ID3Info:comment" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">comment</apiName><shortdesc class="- topic/shortdesc ">
    30. 

  30. 		 录制的相关注解；对应于 ID3 2.0 标签 COMM。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    31. 

  31. 		 录制的相关注解；对应于 ID3 2.0 标签 COMM。
    32. 

  32. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:ID3Info:genre" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">genre</apiName><shortdesc class="- topic/shortdesc ">
    33. 

  33. 		 歌曲的流派；对应于 ID3 2.0 标签 TCON。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    34. 

  34. 		 歌曲的流派；对应于 ID3 2.0 标签 TCON。
    35. 

  35. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:ID3Info:songName" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">songName</apiName><shortdesc class="- topic/shortdesc ">
    36. 

  36. 		 歌曲的名称；对应于 ID3 2.0 标签 TIT2。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    37. 

  37. 		 歌曲的名称；对应于 ID3 2.0 标签 TIT2。
    38. 

  38. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:ID3Info:track" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">track</apiName><shortdesc class="- topic/shortdesc ">
    39. 

  39. 		 曲目编号；对应于 ID3 2.0 标签 TRCK。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    40. 

  40. 		 曲目编号；对应于 ID3 2.0 标签 TRCK。
    41. 

  41. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:ID3Info:year" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">year</apiName><shortdesc class="- topic/shortdesc ">
    42. 

  42. 		 录制的年份；对应于 ID3 2.0 标签 TYER。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    43. 

  43. 		 录制的年份；对应于 ID3 2.0 标签 TYER。
    44. 

  44. 		 </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:MediaType" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">MediaType</apiName><shortdesc class="- topic/shortdesc ">
    45. 

  45.  MediaType 类枚举可以由摄像头返回的媒体的常规类型。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    46. 

  46.  MediaType 类枚举可以由摄像头返回的媒体的常规类型。
    47. 

  47.  
    48. 

  48.  <p class="- topic/p ">使用在此类中定义的常量作为 CameraUI 类的 <codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> 方法的输入。MediaType 值也用于 MediaPromise 类的 <codeph class="+ topic/ph pr-d/codeph ">mediaType</codeph> 属性。</p>
    49. 

  49.  
    50. 

  50.  </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#CameraUI/launch()" class="- topic/link "><linktext class="- topic/linktext ">CameraUI.launch()</linktext></link><link href="" invalidHref="flash.media.MediaPromise.mediaType.xml" class="- topic/link "><linktext class="- topic/linktext ">MediaPromise.mediaType</linktext></link></related-links><apiValue id="flash.media:MediaType:IMAGE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">IMAGE</apiName><shortdesc class="- topic/shortdesc ">
    51. 

  51. 		一个图像。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">image</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    52. 

  52. 		一个图像。
    53. 

  53. 		
    54. 

  54. 		</apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MediaType:VIDEO" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">VIDEO</apiName><shortdesc class="- topic/shortdesc ">
    55. 

  55. 		视频。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">video</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    56. 

  56. 		视频。
    57. 

  57. 		
    58. 

  58. 		</apiDesc></apiValueDetail></apiValue></apiClassifier><apiOperation id="globalOperation:flash.media:scanHardware" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">scanHardware</apiName><shortdesc class="- topic/shortdesc ">
    59. 

  59. 	 强制重新扫描系统上的麦克风和摄像头。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    60. 

  60. 	 强制重新扫描系统上的麦克风和摄像头。
    61. 

  61. 	 
    62. 

  62. 	 </apiDesc></apiOperationDetail></apiOperation><apiClassifier languages="" id="flash.media:Camera" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Camera</apiName><shortdesc class="- topic/shortdesc ">
    63. 

  63.  使用 Camera 类从客户端系统的摄像头捕获视频。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video
    64. 

  64.  </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    65. 

  65.  使用 Camera 类从客户端系统的摄像头捕获视频。使用 Video 类可在本地监视视频。使用 NetConnection 和 NetStream 类可将视频传输到 Flash Media Server。Flash Media Server 可以将视频流发送到其他服务器，并向运行 Flash Player 的其他客户端广播此视频流。
    66. 

  66.  
    67. 

  67.  <p class="- topic/p ">Camera 实例以横向长宽比捕获视频。在可以更改屏幕方向的设备（例如移动电话）上，与摄像头关联的 Video 对象仅以横向长宽比显示垂直视频。因此，移动应用程序在显示视频时应使用横向并且不应自动旋转。</p>
    68. 

  68.  
    69. 

  69.  <p class="- topic/p ">从 AIR 2.6 开始，在具有自动聚焦摄像头的移动设备上自动启动自动聚焦。如果摄像头不支持持续自动聚焦，许多移动设备摄像头都不支持，则当 Camera 对象附加到视频流且只要调用 <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> 方法时，摄像头就会聚焦。 在台式机上，自动对焦行为取决于摄像头驱动程序和设置。</p>
    70. 

  70.  
    71. 

  71.  <p class="- topic/p ">在 Android 和 iOS 上的 AIR 应用程序中，当 AIR 应用程序（前台应用程序）不活动时，摄像头不捕获视频。此外，当应用程序处于后台时，会丢失流连接。在 iOS 上，当应用程序使用 GPU 呈现模式时，无法显示摄像头视频。摄像头视频仍然可以流向服务器。</p>
    72. 

  72.  
    73. 

  73.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">移动浏览器支持：</b>移动浏览器不支持此类。</p>
    74. 

  74.  
    75. 

  75.  <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>桌面操作系统支持此功能，但所有移动设备均不支持此功能。用于电视的 AIR 设备不支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。</p>
    76. 

  76.  
    77. 

  77.  <p class="- topic/p ">您可以使用 <codeph class="+ topic/ph pr-d/codeph ">Camera.isSupported</codeph> 属性在运行时测试是否受支持。请注意，对于用于电视的 AIR 设备，<codeph class="+ topic/ph pr-d/codeph ">Camera.isSupported</codeph> 为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，但是 <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> 始终返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。</p>
    78. 

  78.  
    79. 

  79.  <p class="- topic/p ">
    80. 

  80.  有关捕获音频的信息，请参阅 Microphone 类。
    81. 

  81.  </p>
    82. 

  82.  
    83. 

  83.  <p class="- topic/p ">
    84. 

  84.  <b class="+ topic/ph hi-d/b ">重要说明：</b>Flash Player 将显示“隐私”对话框，用户可从中选择是允许还是拒绝访问摄像头。确保应用程序窗口大小至少为 215 x 138 个像素；这是显示该对话框所需的最小大小。
    85. 

  85.  </p>
    86. 

  86.  
    87. 

  87.  <p class="- topic/p ">要创建或引用 Camera 对象，请使用 <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> 方法。</p>
    88. 

  88.  
    89. 

  89.  </apiDesc><example conref="examples\CameraExample.as" class="- topic/example "> 以下示例显示了在确认安全警告之后来自摄像头的图像。舞台被设置为无法进行缩放，并与播放器窗口左上角对齐。<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件在会话开始和结束（如果有）时被调度，并由 <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> 方法捕获，该方法会输出有关这一事件的信息。
    90. 

  90.  
    91. 

  91.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>必须将摄像头与计算机连接，此示例才能正常运行。</p>
    92. 

  92. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    93. 

  93. 

  94. package {
    95. 

  95.     import flash.display.Sprite;
    96. 

  96.     import flash.display.StageAlign;
    97. 

  97.     import flash.display.StageScaleMode;
    98. 

  98.     import flash.events.*;
    99. 

  99.     import flash.media.Camera;
    100. 

  100.     import flash.media.Video;
    101. 

  101. 

  102.     public class CameraExample extends Sprite {
    103. 

  103.         private var video:Video;
    104. 

  104.         
    105. 

  105.         public function CameraExample() {
    106. 

  106.             stage.scaleMode = StageScaleMode.NO_SCALE;
    107. 

  107.             stage.align = StageAlign.TOP_LEFT;
    108. 

  108.             
    109. 

  109.             var camera:Camera = Camera.getCamera();
    110. 

  110.             
    111. 

  111.             if (camera != null) {
    112. 

  112.                 camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
    113. 

  113.                 video = new Video(camera.width * 2, camera.height * 2);
    114. 

  114.                 video.attachCamera(camera);
    115. 

  115.                 addChild(video);
    116. 

  116.             } else {
    117. 

  117.                 trace("You need a camera.");
    118. 

  118.             }
    119. 

  119.         }
    120. 

  120.         
    121. 

  121.         private function activityHandler(event:ActivityEvent):void {
    122. 

  122.             trace("activityHandler: " + event);
    123. 

  123.         }
    124. 

  124.     }
    125. 

  125. }
    126. 

  126. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone</linktext></link><link href="http://coenraets.org/blog/2010/07/video-chat-for-android-in-30-lines-of-code/" class="- topic/link "><linktext class="- topic/linktext ">Cristophe Coenraets：用 30 行代码实现 Android 的视频聊天</linktext></link><link href="http://www.riagora.com/2010/07/android-air-and-the-camera/" class="- topic/link "><linktext class="- topic/linktext ">Michael Chaize：Android、AIR 和摄像头</linktext></link></related-links><adobeApiEvent id="flash.media:Camera_flash.events.StatusEvent.STATUS_status" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">status</apiName><shortdesc class="- topic/shortdesc ">
    127. 

  127.  在摄像头报告其状态时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.StatusEvent.STATUS</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.StatusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    128. 

  128.  在摄像头报告其状态时调度。在访问摄像头之前，Flash Player 将显示一个“隐私”对话框，用户可以在该对话框中允许或拒绝对其摄像头的访问。若 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为 <codeph class="+ topic/ph pr-d/codeph ">"Camera.Muted"</codeph>，则表示用户已拒绝 SWF 文件访问其摄像头。如果 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为“<codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph>”，则表示用户允许 SWF 文件访问其摄像头。  
    129. 

  129.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">Camera.getCamera()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Camera_flash.events.ActivityEvent.ACTIVITY_activity" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">activity</apiName><shortdesc class="- topic/shortdesc ">
    130. 

  130.  在摄像头开始或结束会话时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ActivityEvent.ACTIVITY</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ActivityEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    131. 

  131.  在摄像头开始或结束会话时调度。可以调用 <codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> 以指定触发 <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 的 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件所需的运动量，或者指定在没有活动的情况下经过多长时间才会触发 <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph> 的 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件。
    132. 

  132.  
    133. 

  133.  
    134. 

  134.  
    135. 

  135.  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiOperation id="flash.media:Camera:getCamera" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getCamera</apiName><shortdesc class="- topic/shortdesc ">
    136. 

  136. 	 返回对用于捕获视频的 Camera 对象的引用。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, constructor, Camera.getCamera, getCamera
    137. 

  137. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">如果未指定 <codeph class="+ topic/ph pr-d/codeph ">name</codeph> 参数，则此方法返回对默认摄像头的引用；或者，如果默认摄像头正由另一个应用程序使用，则此方法返回对第一个可用摄像头的引用。（如果安装了多个摄像头，则用户可以在 Flash Player 的“摄像头设置”面板中指定默认的摄像头。）如果没有可用摄像头或没有安装摄像头，则该方法返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。 
    138. 

  138.  	  
    139. 

  139.  	 </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:Camera</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定要获取哪一个摄像头，这由 <codeph class="+ topic/ph pr-d/codeph ">names</codeph> 属性返回的数组确定。对于大多数应用程序，可省略此参数来获取默认摄像头。要为此参数指定值，请使用 Camera.names 数组内从零开始的索引位置的字符串表示形式。例如，要在数组中指定第三个摄像头，请使用 <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera("2")</codeph>。 
    140. 

  140.  	 
    141. 

  141.  	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    142. 

  142. 	 返回对用于捕获视频的 Camera 对象的引用。要开始捕获视频，必须将 Camera 对象附加到 Video 对象（请参阅 <codeph class="+ topic/ph pr-d/codeph ">Video.attachCamera() </codeph>）。要将视频传输到 Flash Media Server，请调用 <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachCamera()</codeph> 以将 Camera 对象附加到 NetStream 对象。
    143. 

  143. 	 
    144. 

  144. 	 <p class="- topic/p ">对 <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> 方法的多次调用会引用相同的摄像头驱动程序。因此，如果代码包含诸如 <codeph class="+ topic/ph pr-d/codeph ">firstCam:Camera = getCamera()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">secondCam:Camera = getCamera()</codeph> 之类的代码，则 <codeph class="+ topic/ph pr-d/codeph ">firstCam</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">secondCam</codeph> 会引用同一个摄像头，该摄像头为用户的默认摄像头。</p>
    145. 

  145. 	 
    146. 

  146. 	 <p class="- topic/p ">在同时具有前面摄像头和后面摄像头的 iOS 设备上，您在同一时刻只能从一个摄像头捕获视频。在 Android 设备上，您只能访问后面摄像头。</p>
    147. 

  147. 	 
    148. 

  148. 	 <p class="- topic/p ">通常不应为 <codeph class="+ topic/ph pr-d/codeph ">name</codeph> 参数传递值，而只是使用 <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> 来返回对默认摄像头的引用。通过“摄像头设置面板”（此章节的稍后部分将进行讨论），用户可以指定要使用的默认摄像头。 </p>
    149. 

  149. 	 
    150. 

  150.   	 <p class="- topic/p ">您不能使用 ActionScript 来设置用户用于访问摄像头的 Allow 或 Deny 权限设置，但可以显示“Adobe Flash Player 设置”摄像头设置对话框，用户可以在其中设置摄像头权限。当使用 <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> 方法的 SWF 文件尝试将 <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> 方法返回的摄像头附加到 Video 或 NetStream 对象时，Flash Player 将显示一个对话框，用户可从中选择是允许还是拒绝访问摄像头。（确保应用程序窗口大小至少为 215 x 138 个像素；这是 Flash Player 显示该对话框所需的最小大小。）当用户对摄像头设置对话框做出响应时，Flash Player 将在表示用户响应的 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件中返回信息对象：<codeph class="+ topic/ph pr-d/codeph ">Camera.muted</codeph> 表示用户拒绝访问摄像头；<codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph> 表示用户允许访问摄像头。要在不处理 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件的情况下确定用户是拒绝还是允许访问摄像头，请使用 <codeph class="+ topic/ph pr-d/codeph ">muted</codeph> 属性。</p>
    151. 

  151.   	 
    152. 

  152.  	 <p class="- topic/p ">在 Flash Player 中，用户可以为特定域指定永久隐私设置，方法是在播放 SWF 文件时右键单击（Windows 和 Linux 系统）或按住 Control 并单击 (Macintosh)，选择“设置”，打开“隐私”对话框，然后选择“记住”。如果用户选择“记住”，Flash Player 将不再询问用户是允许还是拒绝此域的 SWF 文件访问摄像头。</p>
    153. 

  153.   	 
    154. 

  154.   	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>如果用户已通过选择“Flash Player 设置”对话框中的“记住”来拒绝访问摄像头，则 <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> 方法将不会调用该对话框来允许或拒绝对摄像头的访问。在这种情况下，您可以通过使用 <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings(SecurityPanel.PRIVACY)</codeph> 为用户显示“Flash Player 隐私”面板，提示用户更改 Allow 或 Deny 设置。</p>
    155. 

  155.  	 
    156. 

  156.  	 <p class="- topic/p ">如果 <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> 返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，则表明摄像头正由另一个应用程序使用，或者系统上没有安装摄像头。要确定是否安装了任何摄像头，请使用 <codeph class="+ topic/ph pr-d/codeph ">names.length</codeph> 属性。要显示 Flash Player 的“摄像头设置”面板（让用户选择将由 <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> 引用的摄像头），请使用 <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings(SecurityPanel.CAMERA)</codeph>。 </p>
    157. 

  157.  	 
    158. 

  158. 	 <p class="- topic/p ">扫描硬件以找到摄像头需要花一些时间。当运行时找到至少一个摄像头后，在播放器实例的生存期内将不再扫描硬件。但是，如果运行时没有找到任何摄像头，则每次调用 <codeph class="+ topic/ph pr-d/codeph ">getCamera</codeph> 时它都将进行扫描。这对虽然有摄像头但摄像头被禁用的情况非常适用；如果 SWF 文件提供了调用 <codeph class="+ topic/ph pr-d/codeph ">getCamera</codeph> 的“重试”按钮，则用户不必重新启动 SWF 文件，Flash Player 就可以找到摄像头。</p>
    159. 

  159.  	 
    160. 

  160. 	 </apiDesc><example conref="examples\Camera_getCameraExample.as" class="- topic/example "> 在下面的示例中，在用户允许访问摄像头后，使用连接的摄像头捕获视频图像。还会显示有关视频流的信息，如当前每秒帧数。
    161. 

  161.  
    162. 

  162.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> 方法将返回对 camera 对象的引用，如果没有可用的摄像头或未安装摄像头，则返回 null。if 语句检查是否找到摄像头，以及用户是否允许访问该摄像头。如果用户拒绝访问，则 <codeph class="+ topic/ph pr-d/codeph ">muted</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。</p> 
    163. 

  163.  
    164. 

  164.  <p class="- topic/p ">通常，在调用 <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> 方法时，将出现一个对话框，提示用户允许或拒绝 Flash Player 访问该摄像头。但是，如果用户拒绝访问并选择了<codeph class="+ topic/ph pr-d/codeph ">“记住”</codeph>选项，则不会出现该对话框并且不会显示任何信息。为确保向用户提供允许访问摄像头的选项，<codeph class="+ topic/ph pr-d/codeph ">myTextField</codeph> 文本字段将指示用户单击该文本字段以调用“Flash Player 设置”对话框。</p>
    165. 

  165.  
    166. 

  166.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 方法调用 <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> 方法，后者会显示“设置”对话框的<codeph class="+ topic/ph pr-d/codeph ">“隐私”</codeph>面板。如果用户允许访问，则调度 <codeph class="+ topic/ph pr-d/codeph ">StatusEvent.STATUS</codeph> 事件，并将该事件的 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性值设置为 <codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph>。（摄像头对象的 <codeph class="+ topic/ph pr-d/codeph ">mute</codeph> 属性值也设置为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。）</p>
    167. 

  167.  
    168. 

  168.  <p class="- topic/p ">如果用户允许访问，则为侦听用户设置状态更改而添加的 <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph> 方法将调用 <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> 方法。<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> 方法使用捕获的流的宽度和高度实例化视频对象。要显示摄像头捕获的视频，请将对视频流的引用附加到该视频对象，并将该视频对象添加到显示列表中。</p>
    169. 

  169.  
    170. 

  170.  <p class="- topic/p ">还将启动一个 Timer 对象。每秒都会调度 Timer 对象的 timer 事件并调用 <codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> 方法。将显示 <codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> 方法并更新 Camera 对象的许多属性。 </p> 
    171. 

  171.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>对于本示例，唯一发生更改的属性是 <codeph class="+ topic/ph pr-d/codeph ">currentFPS</codeph> 属性。</p>    
    172. 

  172.     
    173. 

  173. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    174. 

  174. package {
    175. 

  175.     import flash.display.Sprite;
    176. 

  176.     import flash.media.Camera;
    177. 

  177.     import flash.media.Video;
    178. 

  178.     import flash.text.TextField;
    179. 

  179.     import flash.text.TextFieldAutoSize;
    180. 

  180.     import flash.utils.Timer;
    181. 

  181.     import flash.events.TimerEvent;
    182. 

  182.     import flash.events.StatusEvent;
    183. 

  183.     import flash.events.MouseEvent;
    184. 

  184.     import flash.system.SecurityPanel;
    185. 

  185.     import flash.system.Security;
    186. 

  186. 

  187.     public class Camera_getCameraExample extends Sprite {
    188. 

  188.         private var myTextField:TextField;
    189. 

  189.         private var cam:Camera;
    190. 

  190.         private var t:Timer = new Timer(1000);
    191. 

  191.         
    192. 

  192.         public function Camera_getCameraExample() {
    193. 

  193.             myTextField = new TextField();
    194. 

  194.             myTextField.x = 10;
    195. 

  195.             myTextField.y = 10;
    196. 

  196.             myTextField.background = true;
    197. 

  197.             myTextField.selectable = false;
    198. 

  198.             myTextField.autoSize = TextFieldAutoSize.LEFT;    
    199. 

  199.         
    200. 

  200.             if (Camera.isSupported)
    201. 

  201.             {
    202. 

  202.                 cam = Camera.getCamera();
    203. 

  203.                 
    204. 

  204.                  if (!cam) {
    205. 

  205.                     myTextField.text = "No camera is installed.";
    206. 

  206.                     
    207. 

  207.                 } else if (cam.muted) {
    208. 

  208.                     myTextField.text = "To enable the use of the camera,\n"
    209. 

  209.                                      + "please click on this text field.\n" 
    210. 

  210.                                      + "When the Flash Player Settings dialog appears,\n"
    211. 

  211.                                      + "make sure to select the Allow radio button\n" 
    212. 

  212.                                      + "to grant access to your camera.";
    213. 

  213.     
    214. 

  214.                     myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
    215. 

  215.     
    216. 

  216.                 }else {
    217. 

  217.                     myTextField.text = "Connecting";
    218. 

  218.                     connectCamera(); 
    219. 

  219.                 }
    220. 

  220.        
    221. 

  221.                 addChild(myTextField);
    222. 

  222.     
    223. 

  223.                 t.addEventListener(TimerEvent.TIMER, timerHandler);
    224. 

  224.             }else {
    225. 

  225.                 myTextField.text = "The Camera class is not supported on this device.";
    226. 

  226.             }
    227. 

  227.         }
    228. 

  228. 

  229.         private function clickHandler(e:MouseEvent):void {
    230. 

  230.             Security.showSettings(SecurityPanel.PRIVACY);
    231. 

  231. 

  232.             cam.addEventListener(StatusEvent.STATUS, statusHandler);
    233. 

  233. 

  234.             myTextField.removeEventListener(MouseEvent.CLICK, clickHandler);
    235. 

  235.         }
    236. 

  236. 

  237.         private function statusHandler(event:StatusEvent):void {
    238. 

  238. 

  239.             if (event.code == "Camera.Unmuted") {
    240. 

  240.                 connectCamera(); 
    241. 

  241.                 cam.removeEventListener(StatusEvent.STATUS, statusHandler);
    242. 

  242.             }
    243. 

  243.         }
    244. 

  244. 

  245.         private function connectCamera():void {
    246. 

  246.                 var vid:Video = new Video(cam.width, cam.height);
    247. 

  247.                 vid.x = 10;
    248. 

  248.                 vid.y = 10;
    249. 

  249.                 vid.attachCamera(cam);
    250. 

  250.                 addChild(vid);    
    251. 

  251. 

  252.                 t.start();
    253. 

  253.         }
    254. 

  254. 

  255.         private function timerHandler(event:TimerEvent):void {
    256. 

  256.             myTextField.y = cam.height + 20;
    257. 

  257.             myTextField.text = "";
    258. 

  258.             myTextField.appendText("bandwidth: " + cam.bandwidth + "\n");
    259. 

  259.             myTextField.appendText("currentFPS: " + Math.round(cam.currentFPS) + "\n");
    260. 

  260.             myTextField.appendText("fps: " + cam.fps + "\n");
    261. 

  261.             myTextField.appendText("keyFrameInterval: " + cam.keyFrameInterval + "\n");
    262. 

  262.         }
    263. 

  263.     }
    264. 

  264. }
    265. 

  265. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/index" class="- topic/link "><linktext class="- topic/linktext ">index</linktext></link><link href="flash.media.xml#Camera/muted" class="- topic/link "><linktext class="- topic/linktext ">muted</linktext></link><link href="flash.media.xml#Camera/names" class="- topic/link "><linktext class="- topic/linktext ">names</linktext></link><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link><link href="flash.media.xml#Camera/event:status" class="- topic/link "><linktext class="- topic/linktext ">status</linktext></link><link href="flash.media.xml#Video/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">Video.attachCamera()</linktext></link></related-links><adobeApiEvent id="flash.media:Camera:getCamera_status" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">status</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:StatusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">在摄像头报告其状态时调度。在访问摄像头之前，Flash Player 将显示一个“隐私”对话框，用户可以在该对话框中允许或拒绝对其摄像头的访问。若 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为 <codeph class="+ topic/ph pr-d/codeph ">"Camera.muted"</codeph>，则表示用户拒绝 SWF 文件访问他的摄像头。如果 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为“<codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph>”，则表示用户允许 SWF 文件访问其摄像头。
    266. 

  266.  	 </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">在摄像头报告其状态时调度。</shortdesc></adobeApiEvent></apiOperation><apiOperation id="flash.media:Camera:setKeyFrameInterval" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setKeyFrameInterval</apiName><shortdesc class="- topic/shortdesc ">
    267. 

  267. 	 指定进行完整传输而不由视频压缩算法进行插值处理的视频帧（称为关键帧）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">keyFrameInterval</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个值，用于指定将哪些视频帧（作为关键帧）进行完整传输而不由视频压缩算法进行插补处理。值 1 表示每一帧都是关键帧，值 3 表示每隔两个帧后的那一帧为关键帧，依此类推。可接受值为 1 至 48。
    268. 

  268. 	 
    269. 

  269. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    270. 

  270. 	 指定进行完整传输而不由视频压缩算法进行插值处理的视频帧（称为<i class="+ topic/ph hi-d/i ">关键帧</i>）。此方法仅在使用 Flash Media Server 传输视频时适用。
    271. 

  271. 	 
    272. 

  272. 	 <p class="- topic/p ">Flash 视频压缩算法通过只传输自视频的上一帧以来的更改内容来压缩视频；这些部分被视为插补帧。可以根据前一帧的内容插补视频帧。但是，关键帧是完整的视频帧；它并不是根据前面的帧插补的。</p> 
    273. 

  273. 	 
    274. 

  274. 	 <p class="- topic/p ">要确定如何设置 <codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> 参数的值，请考虑带宽使用率和视频播放辅助功能。例如，为 <codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> 指定较高的值（以较低的频率发送关键帧）可降低带宽使用率。但是，这可能会增加在视频某一特定点上定位播放头所需的时间量；可能需要插补更多以前的视频帧才能继续播放视频。</p> 
    275. 

  275. 	 
    276. 

  276. 	 <p class="- topic/p ">反之，为 <codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> 指定较低的值（以较高的频率发送关键帧）会提高带宽使用率（因为会更频繁地传输所有的视频帧），但可能会减少在已录制视频内搜索特定视频帧所需的时间量。</p>
    277. 

  277. 	 
    278. 

  278. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/keyFrameInterval" class="- topic/link "><linktext class="- topic/linktext ">keyFrameInterval</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Camera:setLoopback" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setLoopback</apiName><shortdesc class="- topic/shortdesc ">
    279. 

  279. 	 指定在本地查看摄像头时是否使用压缩视频流。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">compress</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">针对本地查看摄像头所接收内容指定是使用压缩视频流 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) 还是使用未压缩的流 (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>)。
    280. 

  280. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    281. 

  281. 	 指定在本地查看摄像头时是否使用压缩视频流。此方法仅在使用 Flash Media Server 传输视频时适用；如果将 <codeph class="+ topic/ph pr-d/codeph ">compress</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，则可以更精确地看到在用户实时查看视频时向用户呈现视频的方式。
    282. 

  282. 	 
    283. 

  283. 	 <p class="- topic/p ">虽然压缩流在用于测试（如预览视频品质设置）时很有用，但对它进行处理要花很大的代价，因为对本地视图并不只是进行压缩处理；就像通过实时连接进行传输那样，需要对视频进行压缩和编辑以进行传输，然后要对其进行解压缩处理以供本地查看。</p>
    284. 

  284. 	 
    285. 

  285. 	 <p class="- topic/p ">要在 <codeph class="+ topic/ph pr-d/codeph ">compress</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 的情况下设置使用的压缩量，请使用 <codeph class="+ topic/ph pr-d/codeph ">Camera.setQuality()</codeph>。</p>
    286. 

  286. 	 
    287. 

  287. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setQuality()" class="- topic/link "><linktext class="- topic/linktext ">setQuality()</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Camera:setMode" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setMode</apiName><shortdesc class="- topic/shortdesc ">
    288. 

  288. 	 将摄像头的捕获模式设置为最符合指定要求的本机模式。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.setMode, setMode
    289. 

  289. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">width</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">请求的捕获宽度，以像素为单位。默认值为 160。	 
    290. 

  290. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">height</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">请求的捕获高度，以像素为单位。默认值为 120。	 
    291. 

  291. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fps</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">摄像头捕获数据应使用的请求速率，以每秒帧数为单位。默认值为 15。	 
    292. 

  292. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">favorArea</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">true</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定在摄像头不具有满足指定要求的本机模式的情况下是否控制宽度、高度和帧速率。默认值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，这意味着支持保持捕获大小；使用此参数选择与 <codeph class="+ topic/ph pr-d/codeph ">width</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 值最匹配的模式，即使这样做会由于降低帧速率而对性能造成不利影响。要最大限度地提高帧速率，而不考虑摄像头的高度和宽度，请将 <codeph class="+ topic/ph pr-d/codeph ">false</codeph> 传递给 <codeph class="+ topic/ph pr-d/codeph ">favorArea</codeph> 参数。
    293. 

  293. 	 
    294. 

  294. 	 
    295. 

  295. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    296. 

  296. 	 将摄像头的捕获模式设置为最符合指定要求的本机模式。如果摄像头没有与您传递的所有参数相匹配的本机模式，Flash Player 将选择与所请求的模式最接近的合成捕获模式。此操作可能涉及裁切图像和删除帧。 
    297. 

  297. 	 
    298. 

  298. 	 <p class="- topic/p ">默认情况下，Flash Player 根据需要删除一些帧以保持图像大小。要将删除的帧数降至最低（即使这意味着减小图像大小），请为 <codeph class="+ topic/ph pr-d/codeph ">favorArea</codeph> 参数传递 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。</p>
    299. 

  299. 	 
    300. 

  300. 	 <p class="- topic/p ">在选择本机模式时，Flash Player 将设法尽量保持所请求的高宽比。例如，如果发出 <codeph class="+ topic/ph pr-d/codeph ">myCam.setMode(400, 400, 30)</codeph> 命令，并且摄像头上可用的最大宽度和高度值分别为 320 和 288，则 Flash Player 将宽度和高度都设置为 288；通过将这些属性设置为相同的值，Flash Player 可以保持所请求的 1:1 高宽比。</p>
    301. 

  301. 	 
    302. 

  302. 	 <p class="- topic/p ">要确定在 Flash Player 选择与所请求的值最匹配的模式后分配给这些属性的值，请使用 <codeph class="+ topic/ph pr-d/codeph ">width</codeph>、<codeph class="+ topic/ph pr-d/codeph ">height</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">fps</codeph> 属性。</p>
    303. 

  303. 	 
    304. 

  304. 	 <p class="- topic/p ">
    305. 

  305. 	 如果使用 Flash Media Server，您也可以捕获单个帧或创建延时拍摄。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachCamera()</codeph>。
    306. 

  306. 	 </p>
    307. 

  307. 	 
    308. 

  308. 	 </apiDesc><example conref="examples\Camera_setModeExample.as" class="- topic/example "> 在下面的示例中，当用户单击舞台时，将调整视频大小并将每秒帧数捕获率设置为新值。  
    309. 

  309.  
    310. 

  310.  <p class="- topic/p ">舞台的设置使其不会缩放。<codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> 方法将返回对 camera 对象的引用，如果没有可用的摄像头或未安装摄像头，则返回 null。如果存在摄像头，则调用 <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> 方法。<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> 方法实例化一个视频对象。要显示摄像头捕获的视频，请将对视频流的引用附加到该视频对象，并将该视频对象添加到显示列表中。还为 <codeph class="+ topic/ph pr-d/codeph ">MouseEvent.CLICK</codeph> 事件设置了一个事件侦听器。当用户单击舞台之后，将调用 <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 方法。该方法检查捕获视频的宽度并设置摄像头捕获模式的宽度、高度和每秒帧数请求速率。为了使这些设置生效，必须删除并重新创建该视频对象。还必须将该视频的宽度和高度设置为 camera 对象的宽度和高度。</p>      
    311. 

  311.  
    312. 

  312. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    313. 

  313. package {
    314. 

  314.     import flash.display.Sprite;
    315. 

  315.     import flash.media.Camera;
    316. 

  316.     import flash.media.Video;
    317. 

  317.     import flash.events.MouseEvent;
    318. 

  318.     import flash.display.StageScaleMode;
    319. 

  319. 

  320.     public class Camera_setModeExample extends Sprite {
    321. 

  321.         private var cam:Camera;
    322. 

  322.         private var vid:Video;
    323. 

  323. 

  324.         public function Camera_setModeExample() {
    325. 

  325.             stage.scaleMode = StageScaleMode.NO_SCALE;
    326. 

  326. 

  327.             cam = Camera.getCamera();
    328. 

  328.             
    329. 

  329.             if (!cam) {
    330. 

  330.                 trace("No camera is installed.");
    331. 

  331.             }else {
    332. 

  332.                 connectCamera();
    333. 

  333.             }
    334. 

  334.         }
    335. 

  335. 

  336.         private function connectCamera():void {
    337. 

  337.             vid = new Video();
    338. 

  338.             vid.width = cam.width;
    339. 

  339.             vid.height = cam.height; 
    340. 

  340.             vid.attachCamera(cam);
    341. 

  341.             addChild(vid);    
    342. 

  342. 

  343.             stage.addEventListener(MouseEvent.CLICK, clickHandler);
    344. 

  344.         }
    345. 

  345.     
    346. 

  346.         private function clickHandler(e:MouseEvent):void {
    347. 

  347. 

  348.             switch (cam.width) {
    349. 

  349.                 case 160:
    350. 

  350.                 cam.setMode(320, 240, 10); 
    351. 

  351.                 break;
    352. 

  352.                 case 320:
    353. 

  353.                 cam.setMode(640, 480, 5); 
    354. 

  354.                 break;
    355. 

  355.                 default:
    356. 

  356.                 cam.setMode(160, 120, 15); 
    357. 

  357.                 break;
    358. 

  358.             } 
    359. 

  359. 

  360.             removeChild(vid);           
    361. 

  361.             connectCamera();
    362. 

  362.         }
    363. 

  363.     }
    364. 

  364. }
    365. 

  365. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/fps" class="- topic/link "><linktext class="- topic/linktext ">fps</linktext></link><link href="flash.media.xml#Camera/height" class="- topic/link "><linktext class="- topic/linktext ">height</linktext></link><link href="flash.media.xml#Camera/width" class="- topic/link "><linktext class="- topic/linktext ">width</linktext></link><link href="flash.net.xml#NetStream/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.attachCamera()</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Camera:setMotionLevel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setMotionLevel</apiName><shortdesc class="- topic/shortdesc ">
    366. 

  366. 	 指定调度 activity 事件所需的运动量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.setMotionLevel, setMotionLevel
    367. 

  367. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">motionLevel</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件所需的运动量。可接受值的范围为 0 到 100。默认值为 50。
    368. 

  368. 	 
    369. 

  369. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">timeout</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">2000</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定在没有活动的情况下经过多长时间（以毫秒为单位）后，Flash Player 才会认为活动已停止并调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件。默认值为 2000 毫秒（2 秒）。
    370. 

  370. 	 
    371. 

  371. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    372. 

  372. 	 指定调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件所需的运动量。可以选择设置在没有活动的情况下经过多长时间（以毫秒为单位）后，Flash Player 才会认为动作已停止并调度该事件。 
    373. 

  373. 	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>不管 <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph> 参数值是什么，都可以显示视频。此参数只确定在何时以及哪些情况下调度事件，并不确定实际上是在捕获视频还是显示视频。</p>
    374. 

  374. 	 <p class="- topic/p ">
    375. 

  375. 	 要完全阻止摄像头检测动作，请将值 100 传递到 <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph> 参数；从不调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件。（您可能只将此值用于测试目的 -- 例如，暂时禁用在调度事件时通常会触发的任何处理函数。）
    376. 

  376. 	 </p>
    377. 

  377. 	 <p class="- topic/p ">
    378. 

  378. 	 要确定摄像头当前检测到的运动量，请使用 <codeph class="+ topic/ph pr-d/codeph ">activityLevel</codeph> 属性。运动敏感度值直接对应于活动值。完全不运动对应于活动值 0。持续运动对应于活动值 100。您不移动时，活动值小于运动敏感度值；当您移动时，活动值通常会超过运动敏感度值。
    379. 

  379. 	 </p>
    380. 

  380. 	 <p class="- topic/p ">
    381. 

  381. 	 此方法和 <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> 方法在目的上类似；这两种方法都用于指定应该在何时调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件。不过，这两种方法在对发布流的影响上具有显著的差异：
    382. 

  382. 	 </p>
    383. 

  383. 	 
    384. 

  384. 	 <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> 设计用于优化带宽。在认为音频流被静音时，不发送任何音频数据。而改为发送一条表示静音已启动的消息。 </li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> 设计用于检测运动，并且不影响带宽用量。即使视频流未检测到运动，仍将发送视频。</li></ul>
    385. 

  385. 	   
    386. 

  386. 	 
    387. 

  387. 	 
    388. 

  388. 	 </apiDesc><example conref="examples\Camera_setMotionLevelExample.as" class="- topic/example "> 在下面的示例中，将用户的摄像头用作监视器或监视摄像头。摄像头检测运动，文本字段显示活动级别。（可以扩展此示例，以使其发出警报声音或将通过 Web 服务向其他应用程序发送消息。）
    389. 

  389.  
    390. 

  390.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> 方法将返回对 camera 对象的引用，如果没有可用的摄像头或未安装摄像头，则返回 null。if 语句检查摄像头是否可用，并在摄像头可用时调用 <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> 方法。<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> 方法使用捕获的流的宽度和高度实例化视频对象。要显示摄像头捕获的视频，请将对视频流的引用附加到该视频对象，并将该视频对象添加到显示列表中。（通常，在调用 <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> 方法时，将出现一个对话框，提示用户允许或拒绝 Flash Player 访问该摄像头。但是，如果用户拒绝访问并选择了<codeph class="+ topic/ph pr-d/codeph ">“记住”</codeph>选项，则不会出现该对话框并且不会显示任何信息。要确保用户可以使用允许访问摄像头的选项，请使用 <codeph class="+ topic/ph pr-d/codeph ">system.Security.showSettings()</codeph> 方法来调用“Flash Player 设置”对话框。）</p>
    391. 

  391.  
    392. 

  392.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph> 方法在调用 activity 事件前将最小动作的活动级别（运动量）设置为 5。摄像头停止检测运动时与调用 activity 事件时之间的时间设置为 1 秒（1000 毫秒）。在经过 1 秒没有活动的时间或活动级别达到 5 后，将调度 <codeph class="+ topic/ph pr-d/codeph ">ActivityEvent.ACTIVITY</codeph> 事件并调用 <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> 方法。如果该事件由活动级别触发，则将 <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 并且启动 Timer 对象。每秒都会调度 Timer 对象的 timer 事件并调用 <codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> 方法，该方法会显示当前的活动级别。（尽管 5 级或更大的级别会触发计时器，但显示的当前活动级别可能是一个较小的数字。）</p>
    393. 

  393.   
    394. 

  394. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    395. 

  395. package {
    396. 

  396.     import flash.display.Sprite;
    397. 

  397.     import flash.media.Camera;
    398. 

  398.     import flash.media.Video;
    399. 

  399.     import flash.text.TextField;
    400. 

  400.     import flash.text.TextFieldAutoSize;
    401. 

  401.     import flash.utils.Timer;
    402. 

  402.     import flash.events.TimerEvent;
    403. 

  403.     import flash.events.ActivityEvent;
    404. 

  404. 

  405.     public class Camera_setMotionLevelExample extends Sprite {
    406. 

  406.         private var myTextField:TextField;
    407. 

  407.         private var cam:Camera;
    408. 

  408.         private var t:Timer = new Timer(1000);
    409. 

  409. 

  410.         public function Camera_setMotionLevelExample() {
    411. 

  411.             myTextField = new TextField();
    412. 

  412.             myTextField.background = true;
    413. 

  413.             myTextField.selectable = false;
    414. 

  414.             myTextField.autoSize = TextFieldAutoSize.LEFT;    
    415. 

  415.         
    416. 

  416.             cam = Camera.getCamera();
    417. 

  417.             
    418. 

  418.             if (!cam) {
    419. 

  419.                 myTextField.text = "No camera is installed.";
    420. 

  420. 

  421.             }else {
    422. 

  422.                 myTextField.text = "Waiting to connect.";
    423. 

  423.                 connectCamera(); 
    424. 

  424.             }
    425. 

  425. 

  426.             addChild(myTextField);
    427. 

  427. 

  428.             t.addEventListener(TimerEvent.TIMER, timerHandler);
    429. 

  429.         }
    430. 

  430. 

  431.         private function connectCamera():void {
    432. 

  432.                 var vid:Video = new Video(cam.width, cam.height);
    433. 

  433.                 vid.x = 10;
    434. 

  434.                 vid.y = 10;
    435. 

  435.                 vid.attachCamera(cam);
    436. 

  436.                 addChild(vid);    
    437. 

  437. 

  438.                 cam.setMotionLevel(5, 1000);
    439. 

  439.                 cam.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
    440. 

  440.         }
    441. 

  441. 

  442.         private function activityHandler(e:ActivityEvent):void {
    443. 

  443.             if (e.activating == true) {
    444. 

  444.                 t.start();    
    445. 

  445.             } else {
    446. 

  446.                 myTextField.text = "Everything is quiet.";
    447. 

  447.                 t.stop();
    448. 

  448.             }    
    449. 

  449.         }
    450. 

  450. 

  451.         private function timerHandler(event:TimerEvent):void {
    452. 

  452.              myTextField.x = 10;
    453. 

  453.              myTextField.y = cam.height + 20;
    454. 

  454.              myTextField.text = "There is some activity. Level: " + cam.activityLevel;
    455. 

  455.         }
    456. 

  456.     }
    457. 

  457. }
    458. 

  458. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/motionLevel" class="- topic/link "><linktext class="- topic/linktext ">motionLevel</linktext></link><link href="flash.media.xml#Camera/motionTimeout" class="- topic/link "><linktext class="- topic/linktext ">motionTimeout</linktext></link><link href="flash.media.xml#Microphone/setSilenceLevel()" class="- topic/link "><linktext class="- topic/linktext ">Microphone.setSilenceLevel()</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Camera:setQuality" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setQuality</apiName><shortdesc class="- topic/shortdesc ">
    459. 

  459. 	 设置每秒的最大带宽或当前输出视频输入信号所需的画面质量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera.setQuality, setQuality
    460. 

  460. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bandwidth</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定当前输出视频输入信号可以使用的最大带宽，以每秒字节数为单位。要指定 Flash Player 视频可以使用所需数量的带宽来保持 <codeph class="+ topic/ph pr-d/codeph ">quality</codeph> 的值，请为 <codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> 传递 0。默认值为 16384。	 
    461. 

  461. 	 
    462. 

  462. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">quality</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个整数，指定所需的画面质量级别，该级别由应用于每一视频帧的压缩量确定。可接受的值的范围为 1（最低品质，最大压缩）到 100（最高品质，无压缩）。要指定画面质量可以根据需要进行变化以避免超出带宽，请将 0 传递给 <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>。 
    463. 

  463. 	 
    464. 

  464. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    465. 

  465. 	 设置每秒的最大带宽或当前输出视频输入信号所需的画面质量。此方法通常只在使用 Flash Media Server 传输视频时适用。
    466. 

  466. 	 
    467. 

  467. 	 <p class="- topic/p ">使用此方法可以指定输出视频输入信号的哪一方面对于您的应用程序更重要：是带宽使用率还是图片品质。</p>
    468. 

  468. 	 
    469. 

  469. 	 <ul class="- topic/ul "><li class="- topic/li ">要表示带宽使用率更为重要，请将一个值传递给 <codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> 并将 0 传递给 <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>。Flash Player 将在指定的带宽内以可能的最高品质传输视频。如有必要，Flash Player 将降低图片品质以避免超出指定的带宽。通常，随着运动的增加，质量将降低。</li><li class="- topic/li ">要表示品质更为重要，请将 0 传递给 <codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> 并将一个数值传递给 <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>。Flash Player 使用所需数量的带宽来保持指定的品质。如有必要，Flash Player 将降低帧速率以保持图片品质。通常，随着运动的增加，带宽的使用率也将增加。</li><li class="- topic/li ">要指定带宽和品质同等重要，请为这两个参数都传递数值。Flash Player 将传输达到指定品质并且不超过指定带宽的视频。如有必要，Flash Player 将降低帧速率以保持图片品质，而不会超出指定的带宽。</li></ul>
    470. 

  470. 	 
    471. 

  471. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">getCamera()</linktext></link><link href="flash.media.xml#Camera/quality" class="- topic/link "><linktext class="- topic/linktext ">quality</linktext></link></related-links></apiOperation><apiValue id="flash.media:Camera:activityLevel:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">activityLevel</apiName><shortdesc class="- topic/shortdesc ">
    472. 

  472. 	 摄像头正在检测的运动量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video
    473. 

  473. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    474. 

  474. 	 摄像头正在检测的运动量。该数值的范围为 0（检测到没有运动）到 100（检测到大运动量）。该属性的值可帮助确定是否需要将设置传递到 <codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph> 方法。
    475. 

  475. 	 <p class="- topic/p ">如果摄像头可用，但由于未调用 <codeph class="+ topic/ph pr-d/codeph ">Video.attachCamera()</codeph> 方法而尚未被使用，则将此属性设置为 -1。</p>
    476. 

  476. 	 <p class="- topic/p ">如果只对未压缩的本地视频进行流式处理，则只有在为事件处理函数分配函数后才能设置此属性。否则，它为未定义。</p>
    477. 

  477. 	 
    478. 

  478. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/motionLevel" class="- topic/link "><linktext class="- topic/linktext ">motionLevel</linktext></link><link href="flash.media.xml#Camera/setMotionLevel()" class="- topic/link "><linktext class="- topic/linktext ">setMotionLevel()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:bandwidth:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">bandwidth</apiName><shortdesc class="- topic/shortdesc ">
    479. 

  479. 	 当前输出视频输入信号可以使用的最大带宽，以字节为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.bandwidth, bandwidth
    480. 

  480. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    481. 

  481. 	 当前输出视频输入信号可以使用的最大带宽，以字节为单位。值为 0 表示输入信号可以使用所需数量的带宽来保持所需的帧品质。
    482. 

  482. 	 <p class="- topic/p ">要设置此属性，请使用 <codeph class="+ topic/ph pr-d/codeph ">setQuality()</codeph> 方法。</p>
    483. 

  483. 	 
    484. 

  484. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setQuality()" class="- topic/link "><linktext class="- topic/linktext ">setQuality()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:currentFPS:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">currentFPS</apiName><shortdesc class="- topic/shortdesc ">	
    485. 

  485. 	 摄像头捕获数据的速率，以每秒帧数为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.currentFPS, currentFPS
    486. 

  486. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">	
    487. 

  487. 	 摄像头捕获数据的速率，以每秒帧数为单位。无法设置此属性；不过，可以使用 <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> 方法来设置相关属性 <codeph class="+ topic/ph pr-d/codeph ">fps</codeph>，该属性指定摄像头捕获数据时希望使用的最大帧速率。 
    488. 

  488. 	 
    489. 

  489. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:fps:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">fps</apiName><shortdesc class="- topic/shortdesc ">
    490. 

  490. 	 摄像头捕获数据的最大速率，以每秒帧数为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.fps, fps
    491. 

  491. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    492. 

  492. 	 摄像头捕获数据的最大速率，以每秒帧数为单位。可能的最大速率取决于摄像头性能；有可能会达不到此帧速率。
    493. 

  493. 	 <ul class="- topic/ul "><li class="- topic/li ">要为该属性设置所需值，请使用 <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> 方法。</li><li class="- topic/li ">要确定摄像头当前捕获数据的速率，请使用 <codeph class="+ topic/ph pr-d/codeph ">currentFPS</codeph> 属性。</li></ul>
    494. 

  494. 	 
    495. 

  495. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/currentFPS" class="- topic/link "><linktext class="- topic/linktext ">currentFPS</linktext></link><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:height:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">height</apiName><shortdesc class="- topic/shortdesc ">
    496. 

  496. 	 当前捕获高度，以像素为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.height, height
    497. 

  497. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    498. 

  498. 	 当前捕获高度，以像素为单位。要设置此属性的值，请使用 <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> 方法。 
    499. 

  499. 	 
    500. 

  500. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/width" class="- topic/link "><linktext class="- topic/linktext ">width</linktext></link><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:index:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">index</apiName><shortdesc class="- topic/shortdesc ">
    501. 

  501. 	 从零开始的整数，指定由 names 属性返回的数组中所反映的摄像头的索引。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.index, index
    502. 

  502. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    503. 

  503. 	 从零开始的整数，指定由 <codeph class="+ topic/ph pr-d/codeph ">names</codeph> 属性返回的数组中所反映的摄像头的索引。
    504. 

  504. 	 
    505. 

  505. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/names" class="- topic/link "><linktext class="- topic/linktext ">names</linktext></link><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">getCamera()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:isSupported:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isSupported</apiName><shortdesc class="- topic/shortdesc ">
    506. 

  506.     如果当前平台支持 Camera 类，则 isSupported 属性设置为 true，否则设置为 false。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    507. 

  507.     如果当前平台支持 Camera 类，则 <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，否则设置为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。 
    508. 

  508.     
    509. 

  509.     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Camera:keyFrameInterval:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">keyFrameInterval</apiName><shortdesc class="- topic/shortdesc ">
    510. 

  510. 	 完整传输而没有使用视频压缩算法进行插值处理的视频帧（称为关键帧）数。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    511. 

  511. 	 完整传输而没有使用视频压缩算法进行插值处理的视频帧（称为<i class="+ topic/ph hi-d/i ">关键帧</i>）数。默认值为 15，指每隔 14 个帧后的那一帧为关键帧。值为 1 表示每个帧都是关键帧。允许的值为 1 至 48。
    512. 

  512. 	 
    513. 

  513. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setKeyFrameInterval()" class="- topic/link "><linktext class="- topic/linktext ">setKeyFrameInterval()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:loopback:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">loopback</apiName><shortdesc class="- topic/shortdesc ">
    514. 

  514. 	 表示在本地查看摄像头所捕获的图像时是进行压缩和解压缩 (true)，就像使用 Flash Media Server 进行实时传输一样，还是不进行压缩 (false)。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    515. 

  515. 	 表示在本地查看摄像头所捕获的图像时是进行压缩和解压缩 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>)，就像使用 Flash Media Server 进行实时传输一样，还是不进行压缩 (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>)。默认值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。 
    516. 

  516. 	 
    517. 

  517. 	 <p class="- topic/p ">
    518. 

  518. 	 虽然压缩流在进行测试方面（如预览视频品质设置）非常有用，但会产生大量的处理开销。就像通过实时连接进行传输一样，将对本地查看的内容进行压缩和编辑以进行传输，然后再对其进行解压缩处理以便在本地进行查看。
    519. 

  519. 	 </p>
    520. 

  520. 	 
    521. 

  521. 	 <p class="- topic/p ">要设置此值，请使用 <codeph class="+ topic/ph pr-d/codeph ">Camera.setLoopback()</codeph>。要设置此属性为 True 时使用的压缩量，请使用 <codeph class="+ topic/ph pr-d/codeph ">Camera.setQuality()</codeph>。</p>
    522. 

  522. 	  
    523. 

  523. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setLoopback()" class="- topic/link "><linktext class="- topic/linktext ">setLoopback()</linktext></link><link href="flash.media.xml#Camera/setQuality()" class="- topic/link "><linktext class="- topic/linktext ">setQuality()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:motionLevel:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">motionLevel</apiName><shortdesc class="- topic/shortdesc ">
    524. 

  524. 	 调用 activity 事件所需的运动量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.motionLevel, motionLevel
    525. 

  525. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    526. 

  526. 	 调用 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件所需的运动量。可接受值的范围为 0 到 100。默认值为 50。
    527. 

  527. 	 <p class="- topic/p ">不论 <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph> 属性为何值都能显示视频。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph "> setMotionLevel()</codeph>。</p>
    528. 

  528. 	 
    529. 

  529. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setMotionLevel()" class="- topic/link "><linktext class="- topic/linktext ">setMotionLevel()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:motionTimeout:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">motionTimeout</apiName><shortdesc class="- topic/shortdesc ">
    530. 

  530. 	 摄像头停止检测运动的时间与调用 activity 事件的时间之间相差的毫秒数。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.motionTimeout, motionTimeout
    531. 

  531. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    532. 

  532. 	 摄像头停止检测运动的时刻和调用 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件的时刻之间相差的毫秒数。默认值为 2000（2 秒）。 
    533. 

  533. 	 <p class="- topic/p ">要设置此值，请使用 <codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph>。 </p>
    534. 

  534. 	 
    535. 

  535. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setMotionLevel()" class="- topic/link "><linktext class="- topic/linktext ">setMotionLevel()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:muted:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">muted</apiName><shortdesc class="- topic/shortdesc ">
    536. 

  536. 	 布尔值，表示用户在 Flash Player 的“隐私”对话框中是拒绝访问摄像头 (true) 还是允许访问 (false)。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.muted, muted
    537. 

  537. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    538. 

  538. 	 布尔值，表示用户在 Flash Player 的“隐私”对话框中是拒绝访问摄像头 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) 还是允许访问 (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>)。当此值变化时，将调度 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件。
    539. 

  539. 	 
    540. 

  540. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">getCamera()</linktext></link><link href="flash.media.xml#Camera/event:status" class="- topic/link "><linktext class="- topic/linktext ">status</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:name:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">name</apiName><shortdesc class="- topic/shortdesc ">
    541. 

  541. 	 由摄像头硬件返回的当前摄像头的名称。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.name, name
    542. 

  542. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    543. 

  543. 	 由摄像头硬件返回的当前摄像头的名称。
    544. 

  544. 	 
    545. 

  545. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/names" class="- topic/link "><linktext class="- topic/linktext ">names</linktext></link><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">getCamera()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:names:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">names</apiName><shortdesc class="- topic/shortdesc ">
    546. 

  546. 	 字符串数组，表示所有可用的摄像头名称，而不显示 Flash Player 的“隐私”对话框。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.names, names
    547. 

  547. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Array</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    548. 

  548. 	 字符串数组，表示所有可用的摄像头名称，而不显示 Flash Player 的“隐私”对话框。此数组的行为方式与其他任何 ActionScript 数组的行为方式相同，隐式提供每一摄像头从零开始的索引以及系统上摄像头的数目（通过 <codeph class="+ topic/ph pr-d/codeph ">names.length</codeph>）。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph ">names</codeph> Array 类条目。
    549. 

  549. 	 
    550. 

  550. 	 <p class="- topic/p ">调用 <codeph class="+ topic/ph pr-d/codeph ">names</codeph> 属性要求全面检查硬件。在大多数情况下，您只能使用默认的摄像头。</p>
    551. 

  551. 	 
    552. 

  552. 	 <p class="- topic/p ">在 Android 上，仅支持一个摄像头，即使设备有多个摄像头设备也是如此。摄像头的名称始终是“默认”。</p>
    553. 

  553. 	 
    554. 

  554. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">getCamera()</linktext></link><link href="flash.media.xml#Camera/index" class="- topic/link "><linktext class="- topic/linktext ">index</linktext></link><link href="flash.media.xml#Camera/name" class="- topic/link "><linktext class="- topic/linktext ">name</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:quality:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">quality</apiName><shortdesc class="- topic/shortdesc ">
    555. 

  555. 	 所需的图片品质级别，该级别是由应用于每个视频帧的压缩量决定的。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.quality, quality
    556. 

  556. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    557. 

  557. 	 所需的图片品质级别，该级别是由应用于每个视频帧的压缩量决定的。可接受的品质值范围为 1（最低品质，最大压缩）到 100（最高品质，无压缩）。默认值为 0，这意味着画面质量可以根据需要进行变化，以避免超出可用带宽。
    558. 

  558. 	 
    559. 

  559. 	 <p class="- topic/p ">要设置此属性，请使用 <codeph class="+ topic/ph pr-d/codeph ">setQuality()</codeph> 方法。</p>
    560. 

  560. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setQuality()" class="- topic/link "><linktext class="- topic/linktext ">setQuality()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:width:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">width</apiName><shortdesc class="- topic/shortdesc ">
    561. 

  561. 	 当前捕获宽度，以像素为单位。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.width, width
    562. 

  562. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    563. 

  563. 	 当前捕获宽度，以像素为单位。要为该属性设置所需值，请使用 <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> 方法。
    564. 

  564. 	 
    565. 

  565. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:SoundTransform" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SoundTransform</apiName><shortdesc class="- topic/shortdesc ">
    566. 

  566.  SoundTransform 类包含音量和平移的属性。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    567. 

  567.   
    568. 

  568.   </refpath></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    569. 

  569.  SoundTransform 类包含音量和平移的属性。 
    570. 

  570.  
    571. 

  571.  </apiDesc><example conref="examples\SoundTransformExample.as" class="- topic/example "> 以下示例将加载并播放 MP3 文件。当 MP3 文件播放时，移动鼠标或其他用户输入设备；当您在舞台上方移动用户输入设备时，音量和全景模式将更改。要运行此示例，请将一个名为 MySound.mp3 的文件放在 SWF 文件所在的同一目录中。
    572. 

  572. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    573. 

  573. package {
    574. 

  574.     import flash.display.Sprite;
    575. 

  575.     import flash.display.StageAlign;
    576. 

  576.     import flash.display.StageScaleMode;
    577. 

  577.     import flash.events.*;
    578. 

  578.     import flash.media.Sound;
    579. 

  579.     import flash.media.SoundChannel;
    580. 

  580.     import flash.media.SoundTransform;
    581. 

  581.     import flash.net.URLRequest;
    582. 

  582.     import flash.utils.Timer;
    583. 

  583. 

  584.     public class SoundTransformExample extends Sprite {
    585. 

  585.         private var url:String = "MySound.mp3";
    586. 

  586.         private var soundFactory:Sound;
    587. 

  587.         private var channel:SoundChannel;
    588. 

  588.         private var positionTimer:Timer;
    589. 

  589. 

  590.         public function SoundTransformExample() {
    591. 

  591.             stage.align = StageAlign.TOP_LEFT;
    592. 

  592.             stage.scaleMode = StageScaleMode.NO_SCALE;
    593. 

  593. 

  594.             var request:URLRequest = new URLRequest(url);
    595. 

  595.             soundFactory = new Sound();
    596. 

  596.             soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    597. 

  597.             soundFactory.load(request);
    598. 

  598.             channel = soundFactory.play();
    599. 

  599.             stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
    600. 

  600.         }
    601. 

  601. 

  602.         private function ioErrorHandler(event:Event):void {
    603. 

  603.             trace("ioErrorHandler: " + event);
    604. 

  604.         }
    605. 

  605. 

  606.         private function setPan(pan:Number):void {
    607. 

  607.             trace("setPan: " + pan.toFixed(2));
    608. 

  608.             var transform:SoundTransform = channel.soundTransform;
    609. 

  609.             transform.pan = pan;
    610. 

  610.             channel.soundTransform = transform;
    611. 

  611.         }
    612. 

  612. 

  613.         private function setVolume(volume:Number):void {
    614. 

  614.             trace("setVolume: " + volume.toFixed(2));
    615. 

  615.             var transform:SoundTransform = channel.soundTransform;
    616. 

  616.             transform.volume = volume;
    617. 

  617.             channel.soundTransform = transform;
    618. 

  618.         }
    619. 

  619. 

  620.         private function mouseMoveHandler(event:MouseEvent):void {
    621. 

  621.             var halfStage:uint = Math.floor(stage.stageWidth / 2);
    622. 

  622.             var xPos:uint = event.stageX;
    623. 

  623.             var yPos:uint = event.stageY;
    624. 

  624.             var value:Number;
    625. 

  625.             var pan:Number;
    626. 

  626. 

  627.             if (xPos > halfStage) {
    628. 

  628.                 value = xPos / halfStage;
    629. 

  629.                 pan = value - 1;
    630. 

  630.             } else if (xPos &lt; halfStage) {
    631. 

  631.                 value = (xPos - halfStage) / halfStage;
    632. 

  632.                 pan = value;
    633. 

  633.             } else {
    634. 

  634.                 pan = 0;
    635. 

  635.             }
    636. 

  636. 

  637.             var volume:Number = 1 - (yPos / stage.stageHeight);
    638. 

  638. 

  639.             setVolume(volume);
    640. 

  640.             setPan(pan);
    641. 

  641.             
    642. 

  642.         }
    643. 

  643.     }
    644. 

  644. }
    645. 

  645. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#SimpleButton/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.display.SimpleButton.soundTransform</linktext></link><link href="flash.display.xml#Sprite/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Sprite.soundTransform</linktext></link><link href="flash.media.xml#Microphone/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.soundTransform</linktext></link><link href="flash.media.xml#SoundChannel/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.media.SoundChannel.soundTransform</linktext></link><link href="flash.media.xml#SoundMixer/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.media.SoundMixer.soundTransform</linktext></link><link href="flash.net.xml#NetStream/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.soundTransform</linktext></link></related-links><apiConstructor id="flash.media:SoundTransform:SoundTransform" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">SoundTransform</apiName><shortdesc class="- topic/shortdesc ">
    646. 

  646. 	 创建 SoundTransform 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    647. 

  647. 	 
    648. 

  648. 	 </refpath></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">vol</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">音量范围从 0（静音）至 1（最大音量）。
    649. 

  649. 	 
    650. 

  650. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">panning</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">声音从左到右的平移，范围从 -1（左侧最大平移）至 1（右侧最大平移）。值 0 表示没有平移（居中）。 
    651. 

  651. 	 
    652. 

  652. 	 
    653. 

  653. 	 </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    654. 

  654. 	 创建 SoundTransform 对象。 
    655. 

  655. 	 
    656. 

  656. 	 </apiDesc><example conref="examples\SoundTransform_constructorExample.as" class="- topic/example "> 在下面的示例中，仅从右声道中播放声音，并将音量设置为 50%。
    657. 

  657.  
    658. 

  658.  <p class="- topic/p ">在构造函数中，加载了声音并将其分配给一个声道 (<codeph class="+ topic/ph pr-d/codeph ">channel</codeph>)。还会创建一个 SoundTranform 对象 (<codeph class="+ topic/ph pr-d/codeph ">transform</codeph>)。它的第一个参数将音量设置为 50%（范围从 0.0 到 1.0）。它的第二个参数设置平移。在本示例中，将平移设置为 1.0，这表示仅从右扬声器中播放声音。为了使这些设置生效，将 <codeph class="+ topic/ph pr-d/codeph ">transform</codeph> SoundTranform 对象分配给了声道的 <codeph class="+ topic/ph pr-d/codeph ">souundTransform</codeph> 属性。</p> 
    659. 

  659. <p class="- topic/p "> <b class="+ topic/ph hi-d/b ">注意：</b>仅为本示例编写了有限的错误处理代码。</p>
    660. 

  660.  
    661. 

  661. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    662. 

  662. package {
    663. 

  663.     import flash.display.Sprite;
    664. 

  664.     import flash.net.URLRequest;
    665. 

  665.     import flash.media.Sound;
    666. 

  666.     import flash.media.SoundChannel;
    667. 

  667.     import flash.media.SoundTransform;
    668. 

  668.     import flash.events.IOErrorEvent;
    669. 

  669. 

  670.     public class SoundTransform_constructorExample extends Sprite
    671. 

  671.     {
    672. 

  672.         public function SoundTransform_constructorExample() {
    673. 

  673.             var mySound:Sound = new Sound();
    674. 

  674.             var url:URLRequest = new URLRequest("mySound.mp3");
    675. 

  675.             var channel:SoundChannel;
    676. 

  676.             var transform:SoundTransform = new SoundTransform(0.5, 1.0);
    677. 

  677. 

  678.             mySound.load(url);    
    679. 

  679.             channel = mySound.play();
    680. 

  680.             channel.soundTransform = transform;
    681. 

  681. 

  682.             mySound.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
    683. 

  683.         }
    684. 

  684. 

  685.         private function errorHandler(errorEvent:IOErrorEvent):void {
    686. 

  686.             trace("The sound could not be loaded: " + errorEvent.text);
    687. 

  687.         }
    688. 

  688.     }
    689. 

  689. }
    690. 

  690. </codeblock></example></apiConstructorDetail></apiConstructor><apiValue id="flash.media:SoundTransform:leftToLeft:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">leftToLeft</apiName><shortdesc class="- topic/shortdesc ">
    691. 

  691. 	 从 0（无）至 1（全部）的值，指定了左输入在左扬声器里播放的量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    692. 

  692. 	  
    693. 

  693. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    694. 

  694. 	 从 0（无）至 1（全部）的值，指定了左输入在左扬声器里播放的量。
    695. 

  695. 	 
    696. 

  696. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundTransform:leftToRight:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">leftToRight</apiName><shortdesc class="- topic/shortdesc ">
    697. 

  697. 	 从 0（无）至 1（全部）的值，指定了左输入在右扬声器里播放的量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    698. 

  698. 	  
    699. 

  699. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    700. 

  700. 	 从 0（无）至 1（全部）的值，指定了左输入在右扬声器里播放的量。
    701. 

  701. 	 
    702. 

  702. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundTransform:pan:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">pan</apiName><shortdesc class="- topic/shortdesc ">
    703. 

  703. 	 声音从左到右的平移，范围从 -1（左侧最大平移）至 1（右侧最大平移）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    704. 

  704. 	  
    705. 

  705. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    706. 

  706. 	 声音从左到右的平移，范围从 -1（左侧最大平移）至 1（右侧最大平移）。值 0 表示没有平移（在左侧和右侧之间平衡居中）。
    707. 

  707. 	 
    708. 

  708. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundTransform:rightToLeft:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rightToLeft</apiName><shortdesc class="- topic/shortdesc ">
    709. 

  709. 	 从 0（无）至 1（全部）的值，指定了右输入在左扬声器里播放的量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    710. 

  710. 	  
    711. 

  711. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    712. 

  712. 	 从 0（无）至 1（全部）的值，指定了右输入在左扬声器里播放的量。
    713. 

  713. 	 
    714. 

  714. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundTransform:rightToRight:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rightToRight</apiName><shortdesc class="- topic/shortdesc ">
    715. 

  715. 	 从 0（无）至 1（全部）的值，指定了右输入在右扬声器里播放的量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    716. 

  716. 	  
    717. 

  717. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    718. 

  718. 	 从 0（无）至 1（全部）的值，指定了右输入在右扬声器里播放的量。
    719. 

  719. 	 
    720. 

  720. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundTransform:volume:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">volume</apiName><shortdesc class="- topic/shortdesc ">
    721. 

  721. 	 音量范围从 0（静音）至 1（最大音量）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    722. 

  722. 	  
    723. 

  723. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    724. 

  724. 	 音量范围从 0（静音）至 1（最大音量）。
    725. 

  725. 	 
    726. 

  726. 	 </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:StageVideoAvailability" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">StageVideoAvailability</apiName><shortdesc class="- topic/shortdesc ">
    727. 

  727. 	此类定义表示舞台视频当前是否可用的枚举。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">表示舞台视频当前是否可用的枚举。
    728. 

  728.    	</apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    729. 

  729. 	此类定义表示舞台视频当前是否可用的枚举。
    730. 

  730. 	</apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.events.xml#StageVideoAvailabilityEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.StageVideoAvailabilityEvent</linktext></link></related-links><apiValue id="flash.media:StageVideoAvailability:AVAILABLE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">AVAILABLE</apiName><shortdesc class="- topic/shortdesc ">
    731. 

  731. 		 舞台视频当前可用。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">available</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">舞台视频当前可用。
    732. 

  732. 		 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    733. 

  733. 		 舞台视频当前可用。
    734. 

  734. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideoAvailability:UNAVAILABLE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">UNAVAILABLE</apiName><shortdesc class="- topic/shortdesc ">
    735. 

  735. 		 舞台视频当前不可用。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">unavailable</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">舞台视频当前不可用。
    736. 

  736. 		 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    737. 

  737. 		 舞台视频当前不可用。
    738. 

  738. 		 </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:StageWebView" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">StageWebView</apiName><shortdesc class="- topic/shortdesc ">
    739. 

  739.      StageWebView 类在舞台视口中显示 HTML 内容。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    740. 

  740.      StageWebView 类在舞台视口中显示 HTML 内容。 
    741. 

  741.      
    742. 

  742.      <p class="- topic/p ">在不支持 HTMLLoader 类的设备上，StageWebView 类通过一种简单方式来显示 HTML 内容。该类不提供 ActionScript 和 HTML 内容之间的交互，除非通过 StageWebView 类自身的方法和属性。例如，无法在 ActionScript 和 JavaScript 之间传递值或调用函数。</p>
    743. 

  743.      
    744. 

  744.      <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>所有桌面操作系统和移动设备均支持此功能，但用于电视的 AIR 设备不支持此功能。您可以使用 <codeph class="+ topic/ph pr-d/codeph ">StageWebView.isSupported</codeph> 属性，测试在运行时上是否支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。</p>	 
    745. 

  745. 	 
    746. 

  746.      <p class="- topic/p ">在设备上的移动和扩展的移动配置文件中，StageWebView 类使用设备操作系统提供的系统 Web 控件。因此，可用的属性和呈现外观可能因设备而异。在桌面计算机上（在桌面和扩展的桌面配置文件中），StageWebView 类使用内部 AIR WebKit 引擎。可用的功能和呈现外观与 HTMLLoader 类相同（没有由 HTMLLoader 实例提供的 ActionScript 和 JavaScript 之间的紧密集成和脚本桥接）。测试 StageWebView 类的 <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> 属性以确定当前设备是否支持该类。</p>
    747. 

  747.      
    748. 

  748.      <p class="- topic/p ">StageWebView 类不是显示对象，无法添加到 Flash 显示列表。相反，您应通过使用 <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> 属性将 StageWebView 对象直接附加到舞台来显示该对象。附加到舞台的 StageWebView 实例显示在任何 Flash 显示对象的前面。您使用 <codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> 属性控制呈现区域的大小和位置。无法控制不同 StageWebView 对象的深度顺序。不建议重叠两个实例。</p>
    749. 

  749.      
    750. 

  750.      <p class="- topic/p ">当 StageWebView 对象内的内容处于焦点时，StageWebView 对象首先有机会处理键盘输入。StageWebView 对象所附加到的舞台调度任何未处理的键盘输入。由于 StageWebView 实例不是显示列表的一部分，普通的事件捕获/冒泡循环在此处不适用。</p>
    751. 

  751.      
    752. 

  752.      <p class="- topic/p ">在 Android 3.0+ 中，应用程序必须在 AIR 应用程序描述符的 Android manifestAdditions 元素中启用硬件加速，才能显示 StageWebView 对象中的插件内容。</p>
    753. 

  753.      
    754. 

  754.      </apiDesc><example conref="examples\StageWebViewExample.1.as" class="- topic/example "> 以下示例设置 StageWebView 对象以填充舞台。该示例使用 <codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph> 方法加载一个 Web 站点，并使用设备的“后退”和“搜索”软键进行历史记录导航。 
    755. 

  755. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    756. 

  756. package  {
    757. 

  757.     import flash.display.MovieClip;
    758. 

  758.     import flash.media.StageWebView;
    759. 

  759.     import flash.geom.Rectangle;
    760. 

  760.     import flash.events.KeyboardEvent;
    761. 

  761.     import flash.ui.Keyboard;
    762. 

  762.     import flash.desktop.NativeApplication;
    763. 

  763.                 
    764. 

  764.     public class StageWebViewExample extends MovieClip{
    765. 

  765. 

  766.         private var webView:StageWebView = new StageWebView();
    767. 

  767.                                 
    768. 

  768.         public function StageWebViewExample() 
    769. 

  769.         {
    770. 

  770.             webView.stage = this.stage;
    771. 

  771.             webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight );
    772. 

  772.             webView.loadURL( "http://www.example.com" );
    773. 

  773.                                                 
    774. 

  774.             stage.addEventListener( KeyboardEvent.KEY_DOWN, onKey );
    775. 

  775.         }
    776. 

  776.                                 
    777. 

  777.         private function onKey( event:KeyboardEvent ):void
    778. 

  778.         {
    779. 

  779.             if( event.keyCode == Keyboard.BACK &amp;&amp; webView.isHistoryBackEnabled )
    780. 

  780.             {
    781. 

  781.                 trace("Back.");
    782. 

  782.                 webView.historyBack();
    783. 

  783.                 event.preventDefault();
    784. 

  784.             }
    785. 

  785. 

  786.             if( event.keyCode == Keyboard.SEARCH &amp;&amp; webView.isHistoryForwardEnabled )
    787. 

  787.             {
    788. 

  788.                 trace("Forward.");
    789. 

  789.                 webView.historyForward();
    790. 

  790.             }
    791. 

  791.         }
    792. 

  792.     }
    793. 

  793. }
    794. 

  794. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="../../flash/html/HTMLLoader.html" class="- topic/link "><linktext class="- topic/linktext ">HTMLLoader 类</linktext></link><link href="http://www.flashmobileblog.com/2010/06/18/air-on-android-tweetrapp-video-walk-through/" class="- topic/link "><linktext class="- topic/linktext ">Mark Doherty：Android 上的 AIR：TweetrApp</linktext></link><link href="http://www.flashmobileblog.com/2010/07/17/air2-5-stagewebview-demo-oauth-support/" class="- topic/link "><linktext class="- topic/linktext ">Mark Doherty：OAuth 支持</linktext></link><link href="http://help.adobe.com/en_US/air/build/WSfffb011ac560372f-5d0f4f25128cc9cd0cb-7ffe.html#WS365a66ad37c9f5102ec8a8ba12f2d91095a-8000" class="- topic/link "><linktext class="- topic/linktext ">在 StageWebView 对象中启用 Flash Player 和其他插件</linktext></link></related-links><adobeApiEvent id="flash.media:StageWebView_flash.events.FocusEvent_focusOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">focusOut</apiName><shortdesc class="- topic/shortdesc ">
    795. 

  795.      当 StageWebView 放弃焦点时进行调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    796. 

  796.      当 StageWebView 放弃焦点时进行调度。
    797. 

  797.      
    798. 

  798.      </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:StageWebView_flash.events.FocusEvent_focusIn" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">focusIn</apiName><shortdesc class="- topic/shortdesc ">
    799. 

  799.      当此 StageWebView 对象接收焦点时进行调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    800. 

  800.      当此 StageWebView 对象接收焦点时进行调度。
    801. 

  801.      
    802. 

  802.      </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:StageWebView_flash.events.ErrorEvent_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><shortdesc class="- topic/shortdesc ">
    803. 

  803.      表示已出错。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    804. 

  804.      表示已出错。 
    805. 

  805.      
    806. 

  806.      </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:StageWebView_flash.events.Event.COMPLETE_complete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">complete</apiName><shortdesc class="- topic/shortdesc ">
    807. 

  807. 	 表示 loadString() 或 loadURL() 方法上次请求的加载操作已完成。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">表示 loadString() 或 load() 方法上次请求的加载操作已完成。
    808. 

  808. 	 
    809. 

  809. 	 </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    810. 

  810. 	 表示 <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph> 方法上次请求的加载操作已完成。
    811. 

  811. 	 
    812. 

  812. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:StageWebView_flash.events.LocationChangeEvent.LOCATION_CHANGING_locationChanging" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">locationChanging</apiName><shortdesc class="- topic/shortdesc ">
    813. 

  813. 	 表示 StageWebView 对象的 location 属性将更改。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.LocationChangeEvent.LOCATION_CHANGING</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.LocationChangeEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">表示 StageWebView 对象的 location 属性将更改。
    814. 

  814. 	 
    815. 

  815.      </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    816. 

  816. 	 表示 StageWebView 对象的 <codeph class="+ topic/ph pr-d/codeph ">location</codeph> 属性将更改。
    817. 

  817. 	 
    818. 

  818. 	 <p class="- topic/p ">仅当通过 StageWebView 对象内部运行的 HTML 内容或代码启动位置更改时（例如用户单击链接时），才调度 locationChanging 事件。默认情况下，新位置在此 StageWebView 对象中显示。您可以调用事件对象的 <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> 方法取消默认行为。例如，您可以使用 <codeph class="+ topic/ph pr-d/codeph ">flash.net.navigateToURL()</codeph> 函数在基于事件对象的 <codeph class="+ topic/ph pr-d/codeph ">location</codeph> 属性的系统浏览器中打开页面</p>
    819. 

  819. 	 
    820. 

  820. 	 <p class="- topic/p ">当使用下列方法更改位置时，不会调度 locationChanging 事件。</p>
    821. 

  821. 	 <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">historyBack()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">historyForward()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">historyGo()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">reload()</codeph></li></ul>
    822. 

  822. 	 
    823. 

  823. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:StageWebView_flash.events.LocationChangeEvent.LOCATION_CHANGE_locationChange" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">locationChange</apiName><shortdesc class="- topic/shortdesc ">
    824. 

  824. 	 表示更改了 StageWebView 对象的 location 属性。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.LocationChangeEvent.LOCATION_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.LocationChangeEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">表示更改了 StageWebView 对象的 location 属性。
    825. 

  825.  	 
    826. 

  826.      </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    827. 

  827. 	 表示更改了 StageWebView 对象的 <codeph class="+ topic/ph pr-d/codeph ">location</codeph> 属性。
    828. 

  828. 	 
    829. 

  829. 	 <p class="- topic/p ">此事件无法取消。</p>
    830. 

  830. 	 
    831. 

  831. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="flash.media:StageWebView:StageWebView" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">StageWebView</apiName><shortdesc class="- topic/shortdesc ">
    832. 

  832. 	     创建一个 StageWebView 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    833. 

  833. 	     创建一个 StageWebView 对象。
    834. 

  834. 	     
    835. 

  835. 	     <p class="- topic/p ">在将该对象附加到舞台并设置 <codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> 之前，该对象不可见。</p>
    836. 

  836. 	     
    837. 

  837. 	     </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.media:StageWebView:assignFocus" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">assignFocus</apiName><shortdesc class="- topic/shortdesc ">
    838. 

  838. 	     将焦点赋予此 StageWebView 对象内的内容。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">direction</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">none</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定是显示的内容中的第一个还是最后一个可放置焦点的对象应该接收焦点。
    839. 

  839. 	     
    840. 

  840. 	     </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    841. 

  841. 	     将焦点赋予此 StageWebView 对象内的内容。
    842. 

  842. 	     
    843. 

  843. 	     <p class="- topic/p ">方向值在 FocusDirection 类中定义并包括：“bottom”、“none”和“top”。</p>
    844. 

  844. 	     
    845. 

  845. 	     </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#FocusDirection" class="- topic/link "><linktext class="- topic/linktext ">FocusDirection</linktext></link></related-links></apiOperation><apiOperation id="flash.media:StageWebView:dispose" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">dispose</apiName><shortdesc class="- topic/shortdesc ">
    846. 

  846. 	     此 StageWebView 对象的处理。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    847. 

  847. 	     此 StageWebView 对象的处理。
    848. 

  848. 	     
    849. 

  849. 	     <p class="- topic/p ">调用 <codeph class="+ topic/ph pr-d/codeph ">dispose()</codeph> 是可选的。如果您不维护对此 StageWebView 实例的引用，它将符合垃圾回收条件。调用 <codeph class="+ topic/ph pr-d/codeph ">dispose()</codeph> 会使垃圾回收更快发生，或者在更方便的时间发生。</p>
    850. 

  850. 	     
    851. 

  851. 	     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:drawViewPortToBitmapData" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">drawViewPortToBitmapData</apiName><shortdesc class="- topic/shortdesc ">
    852. 

  852. 		 将 StageWebView 的视口绘制到位图。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 位图的宽度或高度不同于视口的宽度或高度。
    853. 

  853. 		 </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ArgumentError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">ArgumentError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">位图为空。
    854. 

  854. 		</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">Error</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Error</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bitmap</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:BitmapData</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">对其绘制 StageWebView 视口的可见部分的 BitmapData 对象。 		  
    855. 

  855.              </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    856. 

  856. 		 将 StageWebView 的视口绘制到位图。
    857. 

  857. 	     	 <p class="- topic/p ">捕获位图并将舞台设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，以便在 StageWebView 对象上显示内容。 </p>
    858. 

  858. 		 
    859. 

  859. 		 </apiDesc><example conref="examples\StageWebView.bitmapcapture.as" class="- topic/example "> 下面的示例显示两个标签：google 和 facebook。单击标签可捕获相应的网页，并将其显示为舞台上的快照。 
    860. 

  860. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    861. 

  861. 

  862. package
    863. 

  863. {
    864. 

  864.     import flash.display.Bitmap;
    865. 

  865.     import flash.display.BitmapData;
    866. 

  866.     import flash.display.Sprite;
    867. 

  867.     import flash.events.*;
    868. 

  868.     import flash.geom.Rectangle;
    869. 

  869.     import flash.media.StageWebView;
    870. 

  870.     import flash.net.*;
    871. 

  871.     import flash.text.TextField;
    872. 

  872.     
    873. 

  873.     public class stagewebview1 extends Sprite
    874. 

  874.     {    
    875. 

  875.         public var webView:StageWebView = new StageWebView();
    876. 

  876.         public var textGoogle:TextField=new TextField();
    877. 

  877.         public var textFacebook:TextField=new TextField();
    878. 

  878.     
    879. 

  879.         public function stagewebview()
    880. 

  880.         
    881. 

  881.         {
    882. 

  882.             textGoogle.htmlText="&lt;b>Google&lt;/b>";
    883. 

  883.             textGoogle.x=300;
    884. 

  884.             textGoogle.y=-80;        
    885. 

  885.             addChild(textGoogle);
    886. 

  886.             textFacebook.htmlText="&lt;b>Facebook&lt;/b>";
    887. 

  887.             textFacebook.x=0;
    888. 

  888.             textFacebook.y=-80;        
    889. 

  889.             addChild(textFacebook);
    890. 

  890.             textGoogle.addEventListener(MouseEvent.CLICK,goGoogle);
    891. 

  891.             textFacebook.addEventListener(MouseEvent.CLICK,goFaceBook);
    892. 

  892.             webView.stage = this.stage;
    893. 

  893.             webView.viewPort = new Rectangle(0, 0, stage.stageWidth, stage.stageHeight);
    894. 

  894. 

  895.         }    
    896. 

  896.     
    897. 

  897.         public function goGoogle(e:Event):void
    898. 

  898.         
    899. 

  899.         {
    900. 

  900.             webView.loadURL("http://www.google.com");
    901. 

  901.             webView.stage = null;
    902. 

  902.             webView.addEventListener(Event.COMPLETE,handleLoad);
    903. 

  903.         }
    904. 

  904.     
    905. 

  905.         public function goFaceBook(e:Event):void
    906. 

  906.         {
    907. 

  907.             webView.loadURL("http://www.facebook.com");
    908. 

  908.             webView.stage = null;
    909. 

  909.             webView.addEventListener(Event.COMPLETE,handleLoad);
    910. 

  910.         }
    911. 

  911.     
    912. 

  912.         public function handleLoad(e:Event):void
    913. 

  913.         {
    914. 

  914.             var bitmapData:BitmapData = new BitmapData(webView.viewPort.width, webView.viewPort.height);
    915. 

  915.             webView.drawViewPortToBitmapData(bitmapData);
    916. 

  916.             var webViewBitmap:Bitmap=new Bitmap(bitmapData);
    917. 

  917.             addChild(webViewBitmap);
    918. 

  918.         }
    919. 

  919.     }
    920. 

  920. }
    921. 

  921. </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:historyBack" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">historyBack</apiName><shortdesc class="- topic/shortdesc ">
    922. 

  922. 	     在浏览历史记录中导航到上一个页面。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    923. 

  923. 	     在浏览历史记录中导航到上一个页面。
    924. 

  924. 	     
    925. 

  925. 	     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:historyForward" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">historyForward</apiName><shortdesc class="- topic/shortdesc ">
    926. 

  926. 	     在浏览历史记录中导航到下一个页面。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    927. 

  927. 	     在浏览历史记录中导航到下一个页面。
    928. 

  928. 	     
    929. 

  929. 	     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:loadString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">loadString</apiName><shortdesc class="- topic/shortdesc ">
    930. 

  930. 	     加载并显示指定的 HTML 字符串。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">text</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要显示的 HTML 或 XHTML 内容的字符串。
    931. 

  931. 	     </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">mimeType</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">text/html</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">内容的 MIME 类型，“文本/html”或“应用程序/xhtml+xml”。
    932. 

  932. 	     
    933. 

  933. 	     </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    934. 

  934. 	     加载并显示指定的 HTML 字符串。
    935. 

  935. 	     
    936. 

  936. 	     <p class="- topic/p ">当使用 <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> 方法时，<codeph class="+ topic/ph pr-d/codeph ">location</codeph> 将报告为“about:blank”。在 HTML 字符串内的 URL 中只能使用标准 URI 方案。不允许使用 AIR URI 方案“app:”和“app-storage:”。</p>
    937. 

  937. 	     
    938. 

  938. 	     <p class="- topic/p ">HTML 内容无法加载本地资源，例如图像文件。不允许使用 XMLHttpRequests。</p>
    939. 

  939. 	     
    940. 

  940. 	     <p class="- topic/p ">仅支持“文本/html”和“应用程序/xhtml+xml”MIME 类型。</p>
    941. 

  941. 	     
    942. 

  942. 	     </apiDesc><example conref="examples\StageWebView.loadString.1.as" class="- topic/example "> 以下示例设置 StageWebView 对象以填充舞台。该示例使用 <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> 方法加载 HTML 页。 
    943. 

  943. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    944. 

  944. 

  945. var webView:StageWebView = new StageWebView();
    946. 

  946. webView.stage = this.stage;
    947. 

  947. webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight );
    948. 

  948. 

  949. var htmlString:String = "&lt;!DOCTYPE HTML>" +
    950. 

  950.                         "&lt;html>" +
    951. 

  951.                             "&lt;body>" +
    952. 

  952.                                 "&lt;h1>Example&lt;/h1>" +
    953. 

  953.                                 "&lt;p>King Phillip cut open five green snakes.&lt;/p>" +
    954. 

  954.                             "&lt;/body>" +
    955. 

  955.                         "&lt;/html>";
    956. 

  956. 

  957. webView.loadString( htmlString, "text/html" );
    958. 

  958. </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:loadURL" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">loadURL</apiName><shortdesc class="- topic/shortdesc ">
    959. 

  959. 	     在指定的 URL 加载页面。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">url</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    960. 

  960. 	     在指定的 URL 加载页面。
    961. 

  961. 	     
    962. 

  962. 	     <p class="- topic/p ">URL 可以使用下列 URI 方案：http:、https:、file:、data: 和 JavaScript:。使用 file: 方案加载的内容可以加载其他本地资源。</p>
    963. 

  963. 	     
    964. 

  964. 	     </apiDesc><example conref="examples\StageWebView.loadURL.1.as" class="- topic/example "> 以下示例设置 StageWebView 对象以填充舞台。该示例使用 <codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph> 方法加载一个网站。 
    965. 

  965.  
    966. 

  966.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>在 Android 上，必须在 AIR 应用程序描述符中指定 INTERNET 权限才能加载远程 URL。</p>
    967. 

  967. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    968. 

  968. 

  969. var webView:StageWebView = new StageWebView();
    970. 

  970. webView.stage = this.stage;
    971. 

  971. webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight );
    972. 

  972. 

  973. webView.loadURL( "http://www.example.com" );
    974. 

  974.                                                 
    975. 

  975. </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:reload" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">reload</apiName><shortdesc class="- topic/shortdesc ">
    976. 

  976. 	     重新载入当前页面。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    977. 

  977. 	     重新载入当前页面。
    978. 

  978. 	     
    979. 

  979. 	     </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:StageWebView:stop" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">stop</apiName><shortdesc class="- topic/shortdesc ">
    980. 

  980. 	     暂停当前加载操作。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    981. 

  981. 	     暂停当前加载操作。
    982. 

  982. 	     
    983. 

  983. 	     </apiDesc></apiOperationDetail></apiOperation><apiValue id="flash.media:StageWebView:isHistoryBackEnabled:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isHistoryBackEnabled</apiName><shortdesc class="- topic/shortdesc ">
    984. 

  984. 	     报告在浏览历史记录中是否有上一个页面。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    985. 

  985. 	     报告在浏览历史记录中是否有上一个页面。
    986. 

  986. 	     
    987. 

  987. 	     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageWebView:isHistoryForwardEnabled:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isHistoryForwardEnabled</apiName><shortdesc class="- topic/shortdesc ">
    988. 

  988. 	     报告在浏览历史记录中是否有下一个页面。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    989. 

  989. 	     报告在浏览历史记录中是否有下一个页面。
    990. 

  990. 	     
    991. 

  991. 	     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageWebView:isSupported:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isSupported</apiName><shortdesc class="- topic/shortdesc ">
    992. 

  992. 	     报告当前设备是否支持 StageWebView 类。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    993. 

  993. 	     报告当前设备是否支持 StageWebView 类。
    994. 

  994. 	     
    995. 

  995. 	     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageWebView:location:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">location</apiName><shortdesc class="- topic/shortdesc ">
    996. 

  996. 	     当前位置的 URL。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    997. 

  997. 	     当前位置的 URL。
    998. 

  998. 	     
    999. 

  999. 	     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageWebView:stage:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">stage</apiName><shortdesc class="- topic/shortdesc ">
    1000. 

  1000. 	     显示此 StageWebView 对象的舞台。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:Stage</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1001. 

  1001. 	     显示此 StageWebView 对象的舞台。
    1002. 

  1002. 	     
    1003. 

  1003. 	     <p class="- topic/p ">将 <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph> 将隐藏此 StageWebView 对象。</p>
    1004. 

  1004. 	     
    1005. 

  1005. 	     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageWebView:title:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">title</apiName><shortdesc class="- topic/shortdesc ">
    1006. 

  1006. 	     HTML 标题值。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1007. 

  1007. 	     HTML 标题值。
    1008. 

  1008. 	     
    1009. 

  1009. 	     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageWebView:viewPort:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">viewPort</apiName><shortdesc class="- topic/shortdesc ">
    1010. 

  1010. 	     舞台上显示 StageWebView 对象的区域。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Rectangle</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">矩形值无效。
    1011. 

  1011. 	     </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1012. 

  1012. 	     舞台上显示 StageWebView 对象的区域。
    1013. 

  1013. 	     
    1014. 

  1014. 	     </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:VideoStatus" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">VideoStatus</apiName><shortdesc class="- topic/shortdesc ">
    1015. 

  1015. 	此类定义描述视频解码的可能级别的枚举。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">描述视频解码的可能级别的枚举。
    1016. 

  1016. 	</apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1017. 

  1017. 	此类定义描述视频解码的可能级别的枚举。
    1018. 

  1018. 	</apiDesc></apiClassifierDetail><apiValue id="flash.media:VideoStatus:ACCELERATED" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">ACCELERATED</apiName><shortdesc class="- topic/shortdesc ">
    1019. 

  1019. 		 表示硬件加速 (GPU) 视频解码。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">accelerated</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">表示硬件加速 (GPU) 视频解码。
    1020. 

  1020. 		 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1021. 

  1021. 		 表示硬件加速 (GPU) 视频解码。
    1022. 

  1022. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:VideoStatus:SOFTWARE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">SOFTWARE</apiName><shortdesc class="- topic/shortdesc ">
    1023. 

  1023. 		 表示软件视频解码。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">software</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">表示软件视频解码。
    1024. 

  1024. 		 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1025. 

  1025. 		 表示软件视频解码。
    1026. 

  1026. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:VideoStatus:UNAVAILABLE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">UNAVAILABLE</apiName><shortdesc class="- topic/shortdesc ">
    1027. 

  1027. 		 不支持视频解码。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">unavailable</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">不支持视频。
    1028. 

  1028. 		 </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1029. 

  1029. 		 不支持视频解码。
    1030. 

  1030. 		 </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:MediaPromise" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">MediaPromise</apiName><shortdesc class="- topic/shortdesc ">
    1031. 

  1031. 	 MediaPromise 类表示承诺提供媒体对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseInterface>flash.desktop:IFilePromise</apiBaseInterface><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1032. 

  1032. 	 MediaPromise 类表示承诺提供媒体对象。 
    1033. 

  1033. 	 
    1034. 

  1034. 	 <p class="- topic/p ">MediaEvent 对象的 <codeph class="+ topic/ph pr-d/codeph ">data</codeph> 属性是 MediaPromise 实例。您可以使用 MediaPromise 方法访问承诺的媒体对象。支持的媒体格式包括静态图像和视频。</p>
    1035. 

  1035. 	 
    1036. 

  1036. 	 <p class="- topic/p ">您无法创建 MediaPromise 对象。调用 <codeph class="+ topic/ph pr-d/codeph ">new MediaPromise()</codeph> 会生成运行时错误。</p>
    1037. 

  1037. 	 
    1038. 

  1038. 	 </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.events.xml#MediaEvent" class="- topic/link "><linktext class="- topic/linktext ">MediaEvent</linktext></link><link href="flash.desktop.xml#IFilePromise" class="- topic/link "><linktext class="- topic/linktext ">IFilePromise</linktext></link><link href="flash.display.xml#Loader/loadFilePromise()" class="- topic/link "><linktext class="- topic/linktext ">Loader.LoadFilePromise()</linktext></link><link href="flash.utils.xml#IDataInput" class="- topic/link "><linktext class="- topic/linktext ">IDataInput</linktext></link><link href="flash.media.xml#CameraRoll/browseForImage()" class="- topic/link "><linktext class="- topic/linktext ">CameraRoll.browseForImage()</linktext></link><link href="flash.media.xml#CameraUI" class="- topic/link "><linktext class="- topic/linktext ">CameraUI</linktext></link></related-links><adobeApiEvent id="flash.media:MediaPromise_flash.events.Event.COMPLETE_complete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">complete</apiName><shortdesc class="- topic/shortdesc ">
    1039. 

  1039.  	 读取所有数据后，MediaPromise 对象调度一个 complete 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1040. 

  1040.  	 读取所有数据后，MediaPromise 对象调度一个 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件。该事件表示在基础流中不再有更多可用数据。
    1041. 

  1041. 	 
    1042. 

  1042. 	 <p class="- topic/p ">同步数据源不调度 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件。</p>
    1043. 

  1043. 	 
    1044. 

  1044.  	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:MediaPromise_flash.events.ProgressEvent.PROGRESS_progress" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">progress</apiName><shortdesc class="- topic/shortdesc ">
    1045. 

  1045.  	 当数据变为可用时，MediaPromise 对象调度 progress 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ProgressEvent.PROGRESS</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ProgressEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1046. 

  1046.  	 当数据变为可用时，MediaPromise 对象调度 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 事件。
    1047. 

  1047.  	 
    1048. 

  1048.  	 <p class="- topic/p ">所有 progress 事件（最后一个除外）的 <codeph class="+ topic/ph pr-d/codeph ">bytesTotal</codeph> 属性的值都为 0。如果所有数据立即可用，可能不调度 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 事件。同步数据源不调度 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 事件。</p>
    1049. 

  1049. 	 
    1050. 

  1050.  	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:MediaPromise_flash.events.IOErrorEvent.IOERROR_ioError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">ioError</apiName><shortdesc class="- topic/shortdesc ">
    1051. 

  1051.  	如果读取基础数据流时遇到错误，MediaPromise 对象会调度 ioError 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.IOErrorEvent.IOERROR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1052. 

  1052.  	如果读取基础数据流时遇到错误，MediaPromise 对象会调度 <codeph class="+ topic/ph pr-d/codeph ">ioError</codeph> 事件。调度此事件后，不再有可读取的数据。
    1053. 

  1053. 	
    1054. 

  1054.  	</apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:MediaPromise_flash.events.Event.CLOSE_close" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">close</apiName><shortdesc class="- topic/shortdesc ">
    1055. 

  1055.  	当基础数据流关闭后，MediaPromise 对象调度 close 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CLOSE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1056. 

  1056.  	当基础数据流关闭后，MediaPromise 对象调度 <codeph class="+ topic/ph pr-d/codeph ">close</codeph> 事件。
    1057. 

  1057. 	
    1058. 

  1058.  	</apiDesc></adobeApiEventDetail></adobeApiEvent><apiOperation id="flash.media:MediaPromise:close" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">close</apiName><shortdesc class="- topic/shortdesc ">
    1059. 

  1059. 		 关闭数据源。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1060. 

  1060. 		 关闭数据源。
    1061. 

  1061. 		 
    1062. 

  1062. 		 </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:MediaPromise:open" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">open</apiName><shortdesc class="- topic/shortdesc ">
    1063. 

  1063. 		 打开基础数据源并返回允许您读取它的 IDataInput 实例。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><returns>the underlying data source.
    1064. 

  1064. 		 
    1065. 

  1065. 		 </returns></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.utils:IDataInput</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1066. 

  1066. 		 打开基础数据源并返回允许您读取它的 IDataInput 实例。
    1067. 

  1067. 		 
    1068. 

  1068. 		 <p class="- topic/p ">如果基础数据源是异步的，则 MediaPromise 对象调度 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件以表示数据是否可读取。如果数据源是同步的，则所有数据立即可用，不调度这些事件。</p>
    1069. 

  1069. 		 
    1070. 

  1070. 		 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>您可以使用 Loader 类的 <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> 方法加载 MediaPromise 对象，而不是手动读取数据。</p>
    1071. 

  1071. 		 
    1072. 

  1072. 		 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Loader/loadFilePromise()" class="- topic/link "><linktext class="- topic/linktext ">Loader.loadFilePromise()</linktext></link></related-links></apiOperation><apiOperation id="flash.media:MediaPromise:reportError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">reportError</apiName><shortdesc class="- topic/shortdesc "> 
    1073. 

  1073. 		 由运行时用来报告错误。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">e</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.events:ErrorEvent</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要调度的 error 事件。
    1074. 

  1074. 		 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1075. 

  1075. 		 由运行时用来报告错误。
    1076. 

  1076. 		 
    1077. 

  1077. 		 <p class="- topic/p ">应用程序代码不应该调用此方法。</p>
    1078. 

  1078. 		 
    1079. 

  1079. 		 </apiDesc></apiOperationDetail></apiOperation><apiValue id="flash.media:MediaPromise:file:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">file</apiName><shortdesc class="- topic/shortdesc ">
    1080. 

  1080. 		 表示媒体对象（如果存在）的 File 实例。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.filesystem:File</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1081. 

  1081. 		 表示媒体对象（如果存在）的 File 实例。
    1082. 

  1082. 		 
    1083. 

  1083. 		 <p class="- topic/p ">如果基础数据源是基于文件的并且该文件可由应用程序访问，则此属性引用 File 对象。否则，属性为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。</p>
    1084. 

  1084. 		 
    1085. 

  1085. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MediaPromise:isAsync:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isAsync</apiName><shortdesc class="- topic/shortdesc ">
    1086. 

  1086. 		 报告基础数据源是异步的还是同步的。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1087. 

  1087. 		 报告基础数据源是异步的还是同步的。
    1088. 

  1088. 		 
    1089. 

  1089. 		 <p class="- topic/p "/>
    1090. 

  1090. 		 
    1091. 

  1091. 		 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MediaPromise:mediaType:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">mediaType</apiName><shortdesc class="- topic/shortdesc ">
    1092. 

  1092. 		 媒体的常规类型，图像或视频。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1093. 

  1093. 		 媒体的常规类型，图像或视频。
    1094. 

  1094. 		 
    1095. 

  1095. 		 <p class="- topic/p ">MediaType 类中的常量定义此属性可能的值：</p>
    1096. 

  1096. 		 <ul class="- topic/ul "><li class="- topic/li ">MediaType.IMAGE</li><li class="- topic/li ">MediaType.VIDEO</li></ul>
    1097. 

  1097. 		 
    1098. 

  1098. 		 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#MediaType" class="- topic/link "><linktext class="- topic/linktext ">MediaType</linktext></link></related-links></apiValue><apiValue id="flash.media:MediaPromise:relativePath:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">relativePath</apiName><shortdesc class="- topic/shortdesc ">
    1099. 

  1099. 		 媒体对象（如果存在）的文件名。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1100. 

  1100. 		 媒体对象（如果存在）的文件名。
    1101. 

  1101. 		 
    1102. 

  1102. 		 <p class="- topic/p ">如果基础数据源是基于文件的并且该文件可由应用程序访问，则文件名是可用的。否则，属性为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。</p>
    1103. 

  1103. 		
    1104. 

  1104. 		</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:SoundLoaderContext" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SoundLoaderContext</apiName><shortdesc class="- topic/shortdesc ">
    1105. 

  1105.  SoundLoaderContext 类为加载声音的 文件提供安全检查。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1106. 

  1106.  SoundLoaderContext 类为加载声音的 文件提供安全检查。SoundLoaderContext 对象以参数的形式传递到构造函数和 Sound 类的 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法。
    1107. 

  1107.  
    1108. 

  1108.  <p class="- topic/p ">在使用此类时，请考虑以下安全模型： </p>
    1109. 

  1109.  
    1110. 

  1110.  <ul class="- topic/ul "><li class="- topic/li ">如果执行调用的 文件在网络沙箱中，并且要加载的声音文件是本地文件，则不允许加载和播放声音。</li><li class="- topic/li ">默认情况下，若执行调用的 是本地的，并且试图加载和播放远程声音，则不允许加载和播放声音。用户必须授予明确许可以允许该操作。</li><li class="- topic/li ">某些处理声音的操作受到限制。除非您实现一个 URL 策略文件，否则位于其他域中的文件无法访问已加载声音中的数据。受此限制约束的、与声音相关的 API 为 <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> 属性以及 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">SoundTransform()</codeph> 方法。</li></ul>
    1111. 

  1111.  
    1112. 

  1112.  <p class="- topic/p ">但在 Adobe AIR 中，<codeph class="+ topic/ph pr-d/codeph ">application</codeph> 安全沙箱中的内容（使用 AIR 应用程序安装的内容）不受这些安全限制的约束。</p>
    1113. 

  1113.  
    1114. 

  1114.  <p class="- topic/p ">有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：<xref href="http://www.adobe.com/go/devnet_security_cn" scope="external" class="- topic/xref ">安全性</xref>。</p>
    1115. 

  1115.  
    1116. 

  1116.  </apiDesc></apiClassifierDetail><apiConstructor id="flash.media:SoundLoaderContext:SoundLoaderContext" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">SoundLoaderContext</apiName><shortdesc class="- topic/shortdesc ">
    1117. 

  1117.      创建新的声音加载器上下文对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bufferTime</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">1000</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">在开始传输声音流之前，将其预加载到缓冲区中所用的秒数。
    1118. 

  1118.      
    1119. 

  1119.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">checkPolicyFile</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定在加载对象时是否应检查 URL 策略文件是否存在，如果是，则为 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>)。
    1120. 

  1120.      
    1121. 

  1121.      </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1122. 

  1122.      创建新的声音加载器上下文对象。  
    1123. 

  1123.      
    1124. 

  1124.      </apiDesc><example conref="examples\SoundLoaderContextExample.as" class="- topic/example "> 在下面的示例中，将要加载的声音的缓冲时间设置为 3 秒。
    1125. 

  1125.  
    1126. 

  1126.  <p class="- topic/p ">可以使用 SoundLoaderContext 对象的第一个参数 (<codeph class="+ topic/ph pr-d/codeph ">context</codeph>) 将默认缓冲时间值从 1 秒增加到 3 秒。（该值以毫秒为单位。）如果将 SoundLoaderContext 对象的第二个参数设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，Flash Player 将在加载对象后检查跨域策略文件。这里将其设置为默认值 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>，所以将不会检查策略文件。声音对象的 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法将使用 context 设置，以确保在开始传输声音流之前，花 3 秒钟的时间将流声音预加载到缓冲区中。<codeph class="+ topic/ph pr-d/codeph ">URLRequest</codeph> 对象确定文件（来自 Adobe 的播客）的位置。如果在加载声音文件的过程中发生 <codeph class="+ topic/ph pr-d/codeph ">IOErrorEvent.IO_ERROR</codeph> 错误，则会调用 <codeph class="+ topic/ph pr-d/codeph ">errorHandler()</codeph> 方法。</p> 
    1127. 

  1127. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1128. 

  1128. package {
    1129. 

  1129.     import flash.display.Sprite;
    1130. 

  1130.     import flash.net.URLRequest;
    1131. 

  1131.     import flash.media.Sound;
    1132. 

  1132.     import flash.media.SoundLoaderContext;
    1133. 

  1133.     import flash.events.IOErrorEvent;
    1134. 

  1134.     
    1135. 

  1135.     public class SoundLoaderContextExample extends Sprite {
    1136. 

  1136. 

  1137.         public function SoundLoaderContextExample() {
    1138. 

  1138.             var snd:Sound = new Sound();
    1139. 

  1139.             var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
    1140. 

  1140.             var context:SoundLoaderContext = new SoundLoaderContext(3000, false);
    1141. 

  1141. 

  1142.             snd.load(req, context);
    1143. 

  1143.             snd.play();      
    1144. 

  1144.  
    1145. 

  1145.             snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
    1146. 

  1146.         }
    1147. 

  1147. 

  1148.         private function errorHandler(errorEvent:IOErrorEvent):void {
    1149. 

  1149.             trace("The sound could not be loaded: " + errorEvent.text);
    1150. 

  1150.         }
    1151. 

  1151. 

  1152.     }
    1153. 

  1153. }
    1154. 

  1154. </codeblock></example></apiConstructorDetail></apiConstructor><apiValue id="flash.media:SoundLoaderContext:bufferTime" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">bufferTime</apiName><shortdesc class="- topic/shortdesc ">
    1155. 

  1155.      在开始传输声音流之前将其预加载到缓冲区中所用的毫秒数。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">1000</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1156. 

  1156.      在开始传输声音流之前将其预加载到缓冲区中所用的毫秒数。
    1157. 

  1157.      
    1158. 

  1158.      <p class="- topic/p ">请注意，无法通过设置全局 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> 属性来覆盖 <codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.bufferTime</codeph> 的值。<ph class="- topic/ph "><codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> 属性影响 SWF 文件中嵌入声音流的缓冲时间，该属性与动态创建的 Sound 对象（即在 ActionScript 中创建的 Sound 对象）无关。</ph></p>
    1159. 

  1159.      
    1160. 

  1160.      </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundLoaderContext:checkPolicyFile" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">checkPolicyFile</apiName><shortdesc class="- topic/shortdesc ">
    1161. 

  1161.      指定应用程序是否应在开始加载声音之前尝试从所加载声音的服务器下载 URL 策略文件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>: please review at same time: checkPolicyFile property in LoaderContext, NetStream
    1162. 

  1162.      </internal></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1163. 

  1163.      指定应用程序是否应在开始加载声音之前尝试从所加载声音的服务器下载 URL 策略文件。此属性应用于使用 <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> 方法从执行调用的文件自己的域外加载的声音。
    1164. 

  1164.      
    1165. 

  1165.      
    1166. 

  1166.      
    1167. 

  1167.      <p class="- topic/p ">如果从执行调用的文件自己的域外加载声音，并且执行调用的文件中的代码需要对声音数据进行低级访问，请将此属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。对声音数据进行低级访问的示例包括引用 <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> 属性以获取 ID3Info 对象，或调用 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph> 方法以便从加载的声音中获取声音样本。如果在加载时没有将 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 的情况下尝试访问声音数据，则可能会出现 SecurityError 异常，因为尚未下载所需的策略文件。</p>
    1168. 

  1168.      
    1169. 

  1169.      <p class="- topic/p ">如果不需要对正在加载的声音数据进行低级访问，请避免将 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>。检查策略文件会占用网络带宽并且可能会延迟下载的开始时间，因此只应在必要时才执行此操作。</p>
    1170. 

  1170.      
    1171. 

  1171.      <p class="- topic/p ">如果在将 <codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.checkPolicyFile</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 的情况下调用 <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph>，则 Flash Player 或 AIR 必须在开始下载指定的声音之前成功下载相关的 URL 策略文件，或确定不存在这样的策略文件。<ph class="- topic/ph ">Flash Player 或 </ph>AIR 将按此顺序执行下列操作，以验证策略文件是否存在：</p>
    1172. 

  1172.      
    1173. 

  1173.      <ul class="- topic/ul "><li class="- topic/li ">Flash Player 或 AIR 考虑已经下载的策略文件。</li><li class="- topic/li ">Flash Player 或 AIR 尝试下载在 <codeph class="+ topic/ph pr-d/codeph ">Security.loadPolicyFile()</codeph> 调用中指定的任何未处理的策略文件。</li><li class="- topic/li ">Flash Player 或 AIR 尝试从与声音的 URL 相对应的默认位置（与 <codeph class="+ topic/ph pr-d/codeph ">URLRequest.url</codeph> 所在的同一服务器上的 <codeph class="+ topic/ph pr-d/codeph ">/crossdomain.xml</codeph>）下载策略文件。（声音的 URL 在传递给 <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> 或 Sound() 构造函数的 URLRequest 对象的 <codeph class="+ topic/ph pr-d/codeph ">url</codeph> 属性中指定。）</li></ul>
    1174. 

  1174.      
    1175. 

  1175.      <p class="- topic/p ">无论哪种情况，Flash Player 或 AIR 都要求声音服务器上存在一个正确的策略文件，该文件可以提供对 <codeph class="+ topic/ph pr-d/codeph ">URLRequest.url</codeph> 上的声音文件的访问（根据该策略文件的位置），并允许执行调用的文件所在的域通过一个或多个 <codeph class="+ topic/ph pr-d/codeph ">&lt;allow-access-from></codeph> 标签来访问该声音。
    1176. 

  1176.      </p>
    1177. 

  1177.      
    1178. 

  1178.      <p class="- topic/p ">如果将 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，则 Flash Player 或 AIR 会等到策略文件验证完成后再加载声音。应该等到从 Sound 对象调度了 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件后再对声音数据执行任何低级操作，如调用 <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph>。
    1179. 

  1179.      </p>
    1180. 

  1180.      
    1181. 

  1181.      <p class="- topic/p ">如果将 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，但未找到适当的策略文件，则将直到执行需要策略文件的操作时才会收到错误，然后，Flash Player 或 AIR 会引发 <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph> 异常。收到 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件后，通过在 <codeph class="+ topic/ph pr-d/codeph ">try</codeph> 块内获取 <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> 的值，并查看是否会引发 <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph>，您可以测试是否已找到相关策略文件。</p>
    1182. 

  1182.      
    1183. 

  1183.      
    1184. 

  1184.      <p class="- topic/p ">如果正在从使用服务器端 HTTP 重定向的 URL 中下载声音，请谨慎使用 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph>。Flash Player 或 AIR 尝试检索与传递到 <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> 的 URLRequest 对象的 <codeph class="+ topic/ph pr-d/codeph ">url</codeph> 属性相对应的策略文件。如果最终声音文件由于 HTTP 重定向而来自不同的 URL，那么，最初下载的策略文件可能不适用于声音的最终 URL，此 URL 与安全决策相关。</p>
    1185. 

  1185.      
    1186. 

  1186.      <p class="- topic/p ">如果发生此情况，这里有一个可能的解决方案。收到 <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件后，可以检查包含声音的最终 URL 的 <codeph class="+ topic/ph pr-d/codeph ">Sound.url</codeph> 属性值。然后用根据声音的最终 URL 计算的策略文件 URL 调用 <codeph class="+ topic/ph pr-d/codeph ">Security.loadPolicyFile()</codeph> 方法。最后，轮询 <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> 的值，直到没有引发异常为止。</p>
    1187. 

  1187.      
    1188. 

  1188.      <p class="- topic/p ">这一点不适用于 AIR 应用程序沙箱中的内容。应用程序沙箱中的内容始终可以通过编程方式访问声音内容，无论这些内容的来源是什么。</p>
    1189. 

  1189.      
    1190. 

  1190.      <p class="- topic/p ">有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：<xref href="http://www.adobe.com/go/devnet_security_cn" scope="external" class="- topic/xref ">安全性</xref>。</p>
    1191. 

  1191.      
    1192. 

  1192.      
    1193. 

  1193.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/load()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Sound.load()</linktext></link><link href="flash.media.xml#Sound/id3" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Sound.id3</linktext></link><link href="flash.media.xml#SoundMixer/computeSpectrum()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.SoundMixer.computeSpectrum()</linktext></link><link href="flash.media.xml#Sound/url" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Sound.url</linktext></link><link href="flash.system.xml#Security/loadPolicyFile()" class="- topic/link "><linktext class="- topic/linktext ">flash.system.Security.loadPolicyFile()</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:SoundChannel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SoundChannel</apiName><shortdesc class="- topic/shortdesc ">
    1194. 

  1194.  SoundChannel 类控制应用程序中的声音。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1195. 

  1195.   
    1196. 

  1196.   </refpath></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1197. 

  1197.  SoundChannel 类控制应用程序中的声音。每个声音均分配给一个声道，而且应用程序可以具有混合在一起的多个声道。SoundChannel 类包含 <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> 方法、用于监控声道幅度（音量）的属性以及用于对声道指定 SoundTransform 对象的属性。
    1198. 

  1198.  
    1199. 

  1199.  </apiDesc><example conref="examples\SoundChannelExample.as" class="- topic/example "> 以下示例加载一个 MP3 文件，进行播放，并显示在加载和播放该 MP3 文件时所发生的声音事件的相关信息。Timer 对象每 50 毫秒提供一次有关播放头位置的更新信息。要运行此示例，请将一个名为 MySound.mp3 的文件放在 SWF 文件所在的同一目录中。
    1200. 

  1200. 

  1201. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1202. 

  1202. package {
    1203. 

  1203.     import flash.display.Sprite;
    1204. 

  1204.     import flash.events.*;
    1205. 

  1205.     import flash.media.Sound;
    1206. 

  1206.     import flash.media.SoundChannel;
    1207. 

  1207.     import flash.net.URLRequest;
    1208. 

  1208.     import flash.utils.Timer;
    1209. 

  1209. 

  1210.     public class SoundChannelExample extends Sprite {
    1211. 

  1211.         private var url:String = "MySound.mp3";
    1212. 

  1212.         private var soundFactory:Sound;
    1213. 

  1213.         private var channel:SoundChannel;
    1214. 

  1214.         private var positionTimer:Timer;
    1215. 

  1215. 

  1216.         public function SoundChannelExample() {
    1217. 

  1217.             var request:URLRequest = new URLRequest(url);
    1218. 

  1218.             soundFactory = new Sound();
    1219. 

  1219.             soundFactory.addEventListener(Event.COMPLETE, completeHandler);
    1220. 

  1220.             soundFactory.addEventListener(Event.ID3, id3Handler);
    1221. 

  1221.             soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    1222. 

  1222.             soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler);
    1223. 

  1223.             soundFactory.load(request);
    1224. 

  1224. 

  1225.             channel = soundFactory.play();
    1226. 

  1226.             channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler);
    1227. 

  1227. 

  1228.             positionTimer = new Timer(50);
    1229. 

  1229.             positionTimer.addEventListener(TimerEvent.TIMER, positionTimerHandler);
    1230. 

  1230.             positionTimer.start();
    1231. 

  1231.         }
    1232. 

  1232.         
    1233. 

  1233. 

  1234.         private function positionTimerHandler(event:TimerEvent):void {
    1235. 

  1235.             trace("positionTimerHandler: " + channel.position.toFixed(2));
    1236. 

  1236.         }
    1237. 

  1237. 

  1238.         private function completeHandler(event:Event):void {
    1239. 

  1239.             trace("completeHandler: " + event);
    1240. 

  1240.         }
    1241. 

  1241. 

  1242.         private function id3Handler(event:Event):void {
    1243. 

  1243.             trace("id3Handler: " + event);
    1244. 

  1244.         }
    1245. 

  1245. 

  1246.         private function ioErrorHandler(event:Event):void {
    1247. 

  1247.             trace("ioErrorHandler: " + event);
    1248. 

  1248.             positionTimer.stop();       
    1249. 

  1249.         }
    1250. 

  1250. 

  1251.         private function progressHandler(event:ProgressEvent):void {
    1252. 

  1252.             trace("progressHandler: " + event);
    1253. 

  1253.         }
    1254. 

  1254. 

  1255.         private function soundCompleteHandler(event:Event):void {
    1256. 

  1256.             trace("soundCompleteHandler: " + event);
    1257. 

  1257.             positionTimer.stop();
    1258. 

  1258.         }
    1259. 

  1259.     }
    1260. 

  1260. }
    1261. 

  1261. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound" class="- topic/link "><linktext class="- topic/linktext ">Sound</linktext></link><link href="flash.media.xml#SoundTransform" class="- topic/link "><linktext class="- topic/linktext ">SoundTransform</linktext></link></related-links><adobeApiEvent id="flash.media:SoundChannel_flash.events.Event.SOUND_COMPLETE_soundComplete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">soundComplete</apiName><shortdesc class="- topic/shortdesc ">
    1262. 

  1262.  在声音完成播放后调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.SOUND_COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1263. 

  1263.  在声音完成播放后调度。 
    1264. 

  1264.  </apiDesc><example conref="examples\SoundChannel_event_soundCompleteExample.as" class="- topic/example "> 在以下示例中，用户从播放列表中选择歌曲，然后选择“播放”以按所选顺序播放歌曲。
    1265. 

  1265.  
    1266. 

  1266.  <p class="- topic/p ">在构造函数中，定义了一个用于保存歌曲列表的文本字段和一个用于选择播放的行。（通常，使用按钮来表示歌曲列表的播放和列表框。）定义了一个文本格式对象，以便在选择歌曲行后将其格式更改为斜体。当用户选择文本字段时，将调用 <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 方法。</p> 
    1267. 

  1267.  
    1268. 

  1268. <p class="- topic/p ">在 <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 方法中，文本字段对象的 <codeph class="+ topic/ph pr-d/codeph ">getLineIndexAtPoint()</codeph> 方法返回用户选择的行的索引。通过使用行索引，<codeph class="+ topic/ph pr-d/codeph ">getLineText()</codeph> 方法可获取文本的内容。if 语句检查用户是否已选择播放歌曲或将歌曲添加到播放列表中。如果用户选择了播放并已选择了歌曲，则会删除鼠标单击的事件侦听器，然后调用 <codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> 方法以开始播放歌曲。如果用户已选择歌曲名称，则会将该行的内容添加到 <codeph class="+ topic/ph pr-d/codeph ">songList</codeph> 数组中，并将行的格式设置为斜体。</p>
    1269. 

  1269.  
    1270. 

  1270.  <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> 方法循环访问数组列表以加载并播放每首歌曲。还会将歌曲分配给声道。添加了一个声道事件侦听器，以便在播放完歌曲时做出响应，然后调度 <codeph class="+ topic/ph pr-d/codeph ">Event.SOUND_COMPLETE</codeph> 事件。<codeph class="+ topic/ph pr-d/codeph ">soundCompleteHandler()</codeph> 方法随后调用 <codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> 方法以播放下一首歌曲。此过程继续进行，直至播放完数组中列出的所有歌曲。</p>
    1271. 

  1271. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1272. 

  1272. package {
    1273. 

  1273.     import flash.display.Sprite;
    1274. 

  1274.     import flash.media.Sound;
    1275. 

  1275.     import flash.media.SoundChannel;
    1276. 

  1276.     import flash.text.TextField;
    1277. 

  1277.     import flash.text.TextFieldAutoSize;
    1278. 

  1278.     import flash.events.MouseEvent;
    1279. 

  1279.     import flash.text.TextFormat;
    1280. 

  1280.     import flash.net.URLRequest;
    1281. 

  1281.     import flash.events.Event;
    1282. 

  1282.     import flash.events.IOErrorEvent;
    1283. 

  1283. 

  1284.     public class SoundChannel_event_soundCompleteExample extends Sprite {
    1285. 

  1285.         private var channel:SoundChannel = new SoundChannel();
    1286. 

  1286.         private var songList:Array = new Array();
    1287. 

  1287.         private var listTextField:TextField = new TextField();
    1288. 

  1288.         private var songFormat:TextFormat = new TextFormat();
    1289. 

  1289.         private var arrayIndex:int = 0;
    1290. 

  1290.         private var songSelected:Boolean = false;
    1291. 

  1291.         
    1292. 

  1292.         public function SoundChannel_event_soundCompleteExample() {
    1293. 

  1293.             
    1294. 

  1294.             listTextField.autoSize = TextFieldAutoSize.LEFT;
    1295. 

  1295.             listTextField.border = true
    1296. 

  1296.             listTextField.background = true;
    1297. 

  1297.             listTextField.text = "Song1.mp3\n" + "Song2.mp3\n" 
    1298. 

  1298.                                 + "Song3.mp3\n" + "Song4.mp3\n" + "PLAY";
    1299. 

  1299.         
    1300. 

  1300.             songFormat.italic = true;
    1301. 

  1301.  
    1302. 

  1302.             listTextField.addEventListener(MouseEvent.CLICK, clickHandler);
    1303. 

  1303.                         
    1304. 

  1304.             addChild(listTextField);
    1305. 

  1305.         }
    1306. 

  1306.         
    1307. 

  1307.         private function clickHandler(e:MouseEvent):void {
    1308. 

  1308.             var index:int = listTextField.getLineIndexAtPoint(e.localX, e.localY);
    1309. 

  1309.             var line:String = listTextField.getLineText(index);
    1310. 

  1310.             var firstIndex:uint = listTextField.getLineOffset(index);
    1311. 

  1311.             var playLine:uint = listTextField.numLines - 1;
    1312. 

  1312. 

  1313.                 if((index == playLine) &amp;&amp; (songSelected == true)) {
    1314. 

  1314.                     listTextField.removeEventListener(MouseEvent.CLICK, clickHandler);
    1315. 

  1315.                     playNext();       
    1316. 

  1316. 

  1317.                 } else if (index != playLine) {
    1318. 

  1318.                      songList.push(line.substr(0, (line.length - 1)));
    1319. 

  1319.                      listTextField.setTextFormat(songFormat, firstIndex, 
    1320. 

  1320.                                 (firstIndex + listTextField.getLineLength(index)));     
    1321. 

  1321.                     songSelected = true;
    1322. 

  1322.                  }
    1323. 

  1323.         }
    1324. 

  1324. 

  1325.         private function playNext():void {
    1326. 

  1326.  
    1327. 

  1327.              if(arrayIndex &lt; songList.length) {
    1328. 

  1328.                 var snd:Sound = new Sound();
    1329. 

  1329.                 snd.load(new URLRequest(songList[arrayIndex]));
    1330. 

  1330.                 channel = snd.play();
    1331. 

  1331.                 
    1332. 

  1332.                 channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler);
    1333. 

  1333.                 arrayIndex++;
    1334. 

  1334.  
    1335. 

  1335.             } else {
    1336. 

  1336.                 songSelected = false;
    1337. 

  1337.                     
    1338. 

  1338.                 while(arrayIndex > 0) {
    1339. 

  1339.                     songList.pop();
    1340. 

  1340.                     arrayIndex--;
    1341. 

  1341.                 }
    1342. 

  1342.             }
    1343. 

  1343.         }    
    1344. 

  1344. 

  1345.         private function soundCompleteHandler(e:Event):void {
    1346. 

  1346.             playNext();
    1347. 

  1347.         }
    1348. 

  1348. 

  1349.         private function errorHandler(errorEvent:IOErrorEvent):void {
    1350. 

  1350.             trace(errorEvent.text);
    1351. 

  1351.         }
    1352. 

  1352.     }
    1353. 

  1353. }
    1354. 

  1354. </codeblock></example></adobeApiEventDetail></adobeApiEvent><apiOperation id="flash.media:SoundChannel:stop" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">stop</apiName><shortdesc class="- topic/shortdesc "> 
    1355. 

  1355. 	 停止在该声道中播放声音。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1356. 

  1356. 	 
    1357. 

  1357. 	 </refpath></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1358. 

  1358. 	 停止在该声道中播放声音。
    1359. 

  1359. 	 
    1360. 

  1360. 	 </apiDesc><example conref="examples\SoundChannel_stopExample.as" class="- topic/example "> 在以下示例中，用户可暂停并重放声音文件。
    1361. 

  1361.  
    1362. 

  1362.  <p class="- topic/p ">在构造函数中，加载了该声音文件。（本示例假定该文件位于与 SWF 文件相同的目录中。）将一个文本字段用作按钮，供用户播放或暂停声音时使用。当用户选择 <codeph class="+ topic/ph pr-d/codeph ">button</codeph> 文本字段时，将调用 <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 方法。</p>
    1363. 

  1363.  
    1364. 

  1364.  <p class="- topic/p ">在 <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> 方法中，当用户第一次选择文本字段时，会将声音设置为播放并将声音分配给声道。接下来，当此用户选择暂停文本字段时，声音将停止播放。声道的 <codeph class="+ topic/ph pr-d/codeph ">position</codeph> 属性记录声音停止时的位置。此属性用于在用户选择该文本字段以重新开始播放后从该位置开始恢复播放声音。每次调用 <codeph class="+ topic/ph pr-d/codeph ">Sound.play()</codeph> 方法时，将创建一个新的 SoundChannel 对象并将其分配给 <codeph class="+ topic/ph pr-d/codeph ">channel</codeph> 变量。要使用声道的 <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> 方法暂停声音，必须将 Sound 对象分配给 SoundChannel 对象。</p>
    1365. 

  1365.  
    1366. 

  1366. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1367. 

  1367. 

  1368. package {
    1369. 

  1369.     import flash.display.Sprite;
    1370. 

  1370.     import flash.media.Sound;
    1371. 

  1371.     import flash.media.SoundChannel;
    1372. 

  1372.     import flash.net.URLLoader;
    1373. 

  1373.     import flash.net.URLRequest;
    1374. 

  1374.     import flash.text.TextField;
    1375. 

  1375.     import flash.events.MouseEvent;
    1376. 

  1376.     import flash.text.TextFieldAutoSize;
    1377. 

  1377.             
    1378. 

  1378.     public class SoundChannel_stopExample extends Sprite {
    1379. 

  1379.         private var snd:Sound = new Sound();
    1380. 

  1380.         private var channel:SoundChannel = new SoundChannel();
    1381. 

  1381.         private var button:TextField = new TextField();
    1382. 

  1382. 

  1383.         public function SoundChannel_stopExample() {
    1384. 

  1384.             var req:URLRequest = new URLRequest("MySound.mp3");
    1385. 

  1385.             snd.load(req);
    1386. 

  1386.             
    1387. 

  1387.             button.x = 10;
    1388. 

  1388.             button.y = 10;
    1389. 

  1389.             button.text = "PLAY";
    1390. 

  1390.             button.border = true;
    1391. 

  1391.             button.background = true;
    1392. 

  1392.             button.selectable = false;
    1393. 

  1393.             button.autoSize = TextFieldAutoSize.CENTER;
    1394. 

  1394. 

  1395.             button.addEventListener(MouseEvent.CLICK, clickHandler);
    1396. 

  1396. 

  1397.             this.addChild(button);
    1398. 

  1398.         }
    1399. 

  1399. 

  1400.         private function clickHandler(e:MouseEvent):void {
    1401. 

  1401.             var pausePosition:int = channel.position;
    1402. 

  1402. 

  1403.             if(button.text == "PLAY") {
    1404. 

  1404.                 channel = snd.play(pausePosition);
    1405. 

  1405.                 button.text = "PAUSE";
    1406. 

  1406.             } 
    1407. 

  1407.             else {
    1408. 

  1408.                 channel.stop();
    1409. 

  1409.                 button.text = "PLAY";
    1410. 

  1410.             }
    1411. 

  1411.         }
    1412. 

  1412.     }
    1413. 

  1413. }
    1414. 

  1414. </codeblock></example></apiOperationDetail></apiOperation><apiValue id="flash.media:SoundChannel:leftPeak:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">leftPeak</apiName><shortdesc class="- topic/shortdesc "> 
    1415. 

  1415. 	 左声道的当前幅度（音量），范围从 0（静音）至 1（最大幅度）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1416. 

  1416. 	  
    1417. 

  1417. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1418. 

  1418. 	 左声道的当前幅度（音量），范围从 0（静音）至 1（最大幅度）。
    1419. 

  1419. 	 
    1420. 

  1420. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundChannel:position:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">position</apiName><shortdesc class="- topic/shortdesc ">
    1421. 

  1421. 	 当播放声音时，position 属性表示声音文件中当前播放的位置（以毫秒为单位）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1422. 

  1422. 	 当播放声音时，<codeph class="+ topic/ph pr-d/codeph ">position</codeph> 属性表示声音文件中当前播放的位置（以毫秒为单位）。当停止或暂停播放声音时，<codeph class="+ topic/ph pr-d/codeph ">position</codeph> 属性表示声音文件中上次播放的位置。
    1423. 

  1423. 	 
    1424. 

  1424. 	 <p class="- topic/p ">一种常见使用情形是，在停止播放声音时保存 <codeph class="+ topic/ph pr-d/codeph ">position</codeph> 属性的值。以后，您可以从保存的位置重新开始以恢复播放声音。
    1425. 

  1425. 	 </p>
    1426. 

  1426. 	 
    1427. 

  1427. 	 <p class="- topic/p ">如果循环播放声音，则在每次循环开始时，将 <codeph class="+ topic/ph pr-d/codeph ">position</codeph> 重置为 0。</p>
    1428. 

  1428. 	 
    1429. 

  1429. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundChannel:rightPeak:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rightPeak</apiName><shortdesc class="- topic/shortdesc "> 
    1430. 

  1430. 	 右声道的当前幅度（音量），范围从 0（静音）至 1（最大幅度）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1431. 

  1431. 	  
    1432. 

  1432. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1433. 

  1433. 	 右声道的当前幅度（音量），范围从 0（静音）至 1（最大幅度）。
    1434. 

  1434. 	 
    1435. 

  1435. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundChannel:soundTransform:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">soundTransform</apiName><shortdesc class="- topic/shortdesc "> 
    1436. 

  1436. 	 分配给该声道的 SoundTransform 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1437. 

  1437. 	  
    1438. 

  1438. 	  </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.media:SoundTransform</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1439. 

  1439. 	 分配给该声道的 SoundTransform 对象。SoundTransform 对象包含用于设置音量、平移、左扬声器指定和右扬声器指定的属性。
    1440. 

  1440. 	 
    1441. 

  1441. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#SoundTransform" class="- topic/link "><linktext class="- topic/linktext ">SoundTransform</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:SoundMixer" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SoundMixer</apiName><shortdesc class="- topic/shortdesc ">
    1442. 

  1442. SoundMixer 类包含用于在应用程序中进行全局声音控制的静态属性和方法。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1443. 

  1443. SoundMixer 类包含用于在应用程序中进行全局声音控制的静态属性和方法。SoundMixer 类在应用程序中控制嵌入的声音流。它不控制动态创建的声音（即响应调度 <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> 事件的 Sound 对象而生成的声音）。
    1444. 

  1444. 

  1445. </apiDesc></apiClassifierDetail><apiOperation id="flash.media:SoundMixer:areSoundsInaccessible" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">areSoundsInaccessible</apiName><shortdesc class="- topic/shortdesc "> 
    1446. 

  1446.      确定是否因安全限制而无法访问任何声音。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1447. 

  1447.      
    1448. 

  1448.      </refpath></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">布尔值的字符串表示形式。
    1449. 

  1449.      </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1450. 

  1450.      确定是否因安全限制而无法访问任何声音。例如，如果声音所在的服务器没有用于授予对所在域的访问权限的 URL 策略文件，则无法访问从调用此方法的内容所在域之外的其他域加载的声音。仍然可以加载和播放声音，但无法对不可访问的声音执行低级操作，如获取声音的 ID3 元数据。
    1451. 

  1451.      
    1452. 

  1452.      <p class="- topic/p ">对于应用程序安全沙箱中的 AIR 应用程序内容，调用此方法始终返回 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。应用程序安全沙箱中的内容可以访问所有声音（包括从其他域加载的声音）。</p>
    1453. 

  1453.      
    1454. 

  1454.      </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#SoundMixer/computeSpectrum()" class="- topic/link "><linktext class="- topic/linktext ">computeSpectrum()</linktext></link></related-links></apiOperation><apiOperation id="flash.media:SoundMixer:computeSpectrum" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">computeSpectrum</apiName><shortdesc class="- topic/shortdesc ">
    1455. 

  1455.      获取当前声音波形的快照，并将其放在指定的 ByteArray 对象中。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>Should confirm if the floating point numbers are single- or double-precision.
    1456. 

  1456.      
    1457. 

  1457.      </internal></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">outputArray</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.utils:ByteArray</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">用于保存与声音关联的值的 ByteArray 对象。如果由于安全性限制 (<codeph class="+ topic/ph pr-d/codeph ">areSoundsInaccessible == true</codeph>) 而导致任何声音不可用，则 <codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> 对象将保持不变。如果停止了所有声音，则用零填充 <codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> 对象。
    1458. 

  1458.      
    1459. 

  1459.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">FFTMode</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个用于表示是否首先对声音数据执行 Fourier 转换的布尔值。将此参数设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 会导致方法返回的是频谱而不是原始声音波形。在频谱中，左侧表示的是低频，右侧表示的是高频。
    1460. 

  1460.      
    1461. 

  1461.      </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">stretchFactor</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">声音采样的分辨率。如果将 <codeph class="+ topic/ph pr-d/codeph ">stretchFactor</codeph> 值设置为 0，则会按 44.1 KHz 对数据进行采样；如果值为 1，则按 22.05 KHz 对数据进行采样；如果值为 2，则按 11.025 KHz 对数据进行采样；依此类推。
    1462. 

  1462.      
    1463. 

  1463.      </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1464. 

  1464.      获取当前声音波形的快照，并将其放在指定的 ByteArray 对象中。这些值已设置为标准浮点值（范围为 -1.0 到 1.0）格式。新值覆盖了传递到 <codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> 参数的 ByteArray 对象。创建的 ByteArray 对象的大小固定为 512 个浮点值，其中前 256 个值表示左声道，后 256 个值表示右声道。
    1465. 

  1465.      
    1466. 

  1466.      <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>此方法受本地文件安全性限制和跨域加载限制的约束。如果正在使用本地文件或从服务器（该服务器与执行调用的内容在不同的域中）中加载的声音，则可能需要通过跨域策略文件来解决沙箱限制问题。有关详细信息，请参阅 Sound 类说明。此外，此方法无法用于从 RTMP 流中提取数据，即使与 RTMP 服务器位于相同域中的内容调用此方法时也是如此。</p>
    1467. 

  1467.      
    1468. 

  1468.      
    1469. 

  1469.      <p class="- topic/p ">在 Flash Player 9.0.115.0 及更高版本和 Adobe AIR 中，通过 RTMP 支持此方法。在 Flash Media Server 上，可以在服务器端脚本中控制对流的访问。有关详细信息，请参阅 <xref href="http://www.adobe.com/go/documentation_cn" scope="external" class="- topic/xref "><i class="+ topic/ph hi-d/i "> Server-Side ActionScript Language Reference for Adobe Flash Media Server</i></xref>（《Adobe Flash Media Server 服务器端 ActionScript 语言参考》）中的 <codeph class="+ topic/ph pr-d/codeph ">Client.audioSampleAccess</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">Client.videoSampleAccess</codeph> 属性。</p>
    1470. 

  1470.      
    1471. 

  1471.      </apiDesc><example conref="examples\SoundMixer_computeSpectrumExample.as" class="- topic/example "> 在下面的示例中，使用 <codeph class="+ topic/ph pr-d/codeph ">computeSpectrum()</codeph> 方法生成声音波形数据的图形表示形式。 
    1472. 

  1472.  
    1473. 

  1473.  <p class="- topic/p ">在构造函数中，加载了一个声音文件，并将其设置为播放。（此示例中没有任何错误处理代码，并假定该声音文件位于与 SWF 文件相同的目录中。）该示例在播放声音时侦听 <codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> 事件，从而反复触发 <codeph class="+ topic/ph pr-d/codeph ">onEnterFrame()</codeph> 方法以绘制声音数据值的图表。在播放完声音后，<codeph class="+ topic/ph pr-d/codeph ">onPlaybackComplete()</codeph> 方法可通过删除 <codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> 事件的侦听器以停止绘制过程。</p>
    1474. 

  1474.  
    1475. 

  1475.  <p class="- topic/p ">在 <codeph class="+ topic/ph pr-d/codeph ">onEnterFrame()</codeph> 方法中，<codeph class="+ topic/ph pr-d/codeph ">computeSpectrum()</codeph> 方法在 <codeph class="+ topic/ph pr-d/codeph ">bytes</codeph> 字节数组对象中存储原始声音。数据是按 44.1 KHz 进行采样的。包含 512 字节数据的字节数组，每个数组包含一个介于 -1 和 1 之间的浮点值。第一组 256 字节值表示左声道，而第二组 256 字节值表示右声道。第一个 for 循环读取第一组 256 字节数据值（表示左立体声道），然后使用 <codeph class="+ topic/ph pr-d/codeph ">Graphics.lineTo()</codeph> 方法绘制一条从每个点到下一个点的直线。（声音波形的矢量图形显示内容直接写入到类的 Sprite 对象中。）声音字节是作为 32 位浮点数从字节流中读取的，并乘以绘制高度以使其位于图表垂直范围内。宽度被设置为声道长度的两倍。第二个 for 循环读取下一批 256 字节值（右立体声道），并按相反的顺序绘制直线。<codeph class="+ topic/ph pr-d/codeph ">g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">g.lineTo(0, PLOT_HEIGHT);</codeph> 方法绘制波形的基线。生成的波形图会产生镜像效果。</p>  
    1476. 

  1476. 

  1477. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1478. 

  1478. package {
    1479. 

  1479.     import flash.display.Sprite;
    1480. 

  1480.     import flash.display.Graphics;
    1481. 

  1481.     import flash.events.Event;
    1482. 

  1482.     import flash.media.Sound;
    1483. 

  1483.     import flash.media.SoundChannel;
    1484. 

  1484.     import flash.media.SoundMixer;
    1485. 

  1485.     import flash.net.URLRequest;
    1486. 

  1486.     import flash.utils.ByteArray;
    1487. 

  1487.     import flash.text.TextField;
    1488. 

  1488. 

  1489.     public class SoundMixer_computeSpectrumExample extends Sprite {
    1490. 

  1490. 

  1491.         public function SoundMixer_computeSpectrumExample() {
    1492. 

  1492.             var snd:Sound = new Sound();
    1493. 

  1493.             var req:URLRequest = new URLRequest("Song1.mp3");
    1494. 

  1494.             snd.load(req);
    1495. 

  1495.             
    1496. 

  1496.             var channel:SoundChannel;
    1497. 

  1497.             channel = snd.play();
    1498. 

  1498.             addEventListener(Event.ENTER_FRAME, onEnterFrame);
    1499. 

  1499.             channel.addEventListener(Event.SOUND_COMPLETE, onPlaybackComplete);
    1500. 

  1500.         }
    1501. 

  1501. 

  1502.         private function onEnterFrame(event:Event):void {
    1503. 

  1503.             var bytes:ByteArray = new ByteArray();
    1504. 

  1504.             const PLOT_HEIGHT:int = 200;
    1505. 

  1505.             const CHANNEL_LENGTH:int = 256;
    1506. 

  1506. 

  1507.             SoundMixer.computeSpectrum(bytes, false, 0);
    1508. 

  1508.             
    1509. 

  1509.             var g:Graphics = this.graphics;
    1510. 

  1510.             
    1511. 

  1511.             g.clear();
    1512. 

  1512.        
    1513. 

  1513.             g.lineStyle(0, 0x6600CC);
    1514. 

  1514.             g.beginFill(0x6600CC);
    1515. 

  1515.             g.moveTo(0, PLOT_HEIGHT);
    1516. 

  1516.             
    1517. 

  1517.             var n:Number = 0;
    1518. 

  1518.             
    1519. 

  1519.             for (var i:int = 0; i &lt; CHANNEL_LENGTH; i++) {
    1520. 

  1520.                 n = (bytes.readFloat() * PLOT_HEIGHT);
    1521. 

  1521.                 g.lineTo(i * 2, PLOT_HEIGHT - n);
    1522. 

  1522.             }
    1523. 

  1523. 

  1524.             g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);
    1525. 

  1525.             g.endFill();
    1526. 

  1526.  
    1527. 

  1527.             g.lineStyle(0, 0xCC0066);
    1528. 

  1528.             g.beginFill(0xCC0066, 0.5);
    1529. 

  1529.             g.moveTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);
    1530. 

  1530.             
    1531. 

  1531.             for (i = CHANNEL_LENGTH; i > 0; i--) {
    1532. 

  1532.                 n = (bytes.readFloat() * PLOT_HEIGHT);
    1533. 

  1533.                 g.lineTo(i * 2, PLOT_HEIGHT - n);
    1534. 

  1534.             }
    1535. 

  1535.   
    1536. 

  1536.             g.lineTo(0, PLOT_HEIGHT);
    1537. 

  1537.             g.endFill();
    1538. 

  1538.         }
    1539. 

  1539.         
    1540. 

  1540.         private function onPlaybackComplete(event:Event):void {
    1541. 

  1541.             removeEventListener(Event.ENTER_FRAME, onEnterFrame);
    1542. 

  1542.         }
    1543. 

  1543.     }
    1544. 

  1544. }
    1545. 

  1545. 

  1546. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#SoundMixer/areSoundsInaccessible()" class="- topic/link "><linktext class="- topic/linktext ">areSoundsInaccessible()</linktext></link><link href="flash.utils.xml#ByteArray" class="- topic/link "><linktext class="- topic/linktext ">flash.utils.ByteArray</linktext></link><link href="flash.media.xml#Sound" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Sound</linktext></link><link href="flash.media.xml#SoundLoaderContext/checkPolicyFile" class="- topic/link "><linktext class="- topic/linktext ">flash.media.SoundLoaderContext.checkPolicyFile</linktext></link></related-links></apiOperation><apiOperation id="flash.media:SoundMixer:stopAll" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">stopAll</apiName><shortdesc class="- topic/shortdesc ">
    1547. 

  1547.      停止当前正在播放的所有声音。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1548. 

  1548.      停止当前正在播放的所有声音。 
    1549. 

  1549.      
    1550. 

  1550.      <p class="- topic/p ">> 在 Flash Professional 中，此方法不会停止播放头。设置到流的声音在播放头移过它们所在的帧时将恢复播放。</p>
    1551. 

  1551.      
    1552. 

  1552.      <p class="- topic/p ">在使用此属性时，请考虑以下安全模型：</p>
    1553. 

  1553.      
    1554. 

  1554.      <ul class="- topic/ul "><li class="- topic/li "> 默认情况下，调用 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> 方法只会停止与调用此方法的对象在相同安全沙箱中的声音。任何声音播放如果不是从与调用对象相同的沙箱中启动的，则不会停止这样的声音。</li><li class="- topic/li ">使用 Sound 类的 <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 方法加载声音时，可指定 <codeph class="+ topic/ph pr-d/codeph ">context</codeph> 参数，该参数为一个 SoundLoaderContext 对象。如果将 SoundLoaderContext 对象的 <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> 属性设为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，则 <ph class="- topic/ph ">Flash Player 或 </ph>Adobe AIR 将在从其中加载该声音的服务器上检查跨域策略文件是否存在。如果该服务器具有跨域策略文件，且该文件允许访问执行调用的内容域，则该文件可使用 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> 方法停止加载的声音；否则就不可以。</li></ul>
    1555. 

  1555.      
    1556. 

  1556.      <p class="- topic/p ">但在 Adobe AIR 中，<codeph class="+ topic/ph pr-d/codeph ">application</codeph> 安全沙箱中的内容（使用 AIR 应用程序安装的内容）不受这些安全限制的约束。</p>
    1557. 

  1557.      
    1558. 

  1558.      <p class="- topic/p ">有关安全性的详细信息，请参阅 Flash Player 开发人员中心主题：<xref href="http://www.adobe.com/go/devnet_security_cn" scope="external" class="- topic/xref ">安全性</xref>。</p>
    1559. 

  1559.      
    1560. 

  1560.      </apiDesc><example conref="examples\SoundMixer_stopAllExample.as" class="- topic/example "> 在下面的示例中，使用 <codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> 方法将同时播放的两种声音静音。 
    1561. 

  1561.  
    1562. 

  1562.  <p class="- topic/p ">在构造函数中，加载了两个不同的声音文件，并将其设置为播放。第一种声音是本地加载的，并将其分配给一个声道。（假定该文件位于与 SWF 文件相同的目录中。）第二个文件是从 Adobe 站点加载并流式传输的。要使用 <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> 方法，必须能够访问所有声音。（可以使用 SoundLoaderContext 对象来检查跨域策略文件。）每种声音还包含一个事件侦听器，如果在加载声音文件时发生 IO 错误，则会调用该事件侦听器。还创建了一个 <codeph class="+ topic/ph pr-d/codeph ">muteButton</codeph> 文本字段。它侦听 click 事件，这将调用 <codeph class="+ topic/ph pr-d/codeph ">muteButtonClickHandler()</codeph> 方法。</p>
    1563. 

  1563.  
    1564. 

  1564.  <p class="- topic/p ">在 <codeph class="+ topic/ph pr-d/codeph ">muteButtonClickHandler()</codeph> 方法中，如果文本字段的内容为“MUTE”，<codeph class="+ topic/ph pr-d/codeph ">areSoundsInaccessible()</codeph> 方法将检查混音器是否具有文件的访问权限。如果可以访问文件，<codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> 方法将停止播放声音。通过再次选择文本字段，第一个声音开始播放并且文本字段的内容再次更改为“MUTE”。此时，<codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> 方法将正在播放的那种声音静音。请注意，也可以使用声道的 <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> 方法停止播放为声道分配的特定声音。（为了使用声道功能，每次调用 <codeph class="+ topic/ph pr-d/codeph ">play()</codeph> 方法时，都需要为声道重新分配声音。）</p>
    1565. 

  1565.  
    1566. 

  1566. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1567. 

  1567. package {
    1568. 

  1568.     import flash.display.Sprite;
    1569. 

  1569.     import flash.net.URLRequest;
    1570. 

  1570.     import flash.media.Sound;
    1571. 

  1571.     import flash.media.SoundLoaderContext;
    1572. 

  1572.     import flash.media.SoundChannel;
    1573. 

  1573.     import flash.media.SoundMixer;
    1574. 

  1574.     import flash.text.TextField;
    1575. 

  1575.     import flash.text.TextFieldAutoSize;
    1576. 

  1576.     import flash.events.MouseEvent;
    1577. 

  1577.     import flash.events.IOErrorEvent;
    1578. 

  1578. 

  1579.     public class SoundMixer_stopAllExample extends Sprite  {
    1580. 

  1580.         private var firstSound:Sound = new Sound();
    1581. 

  1581.         private var secondSound:Sound = new Sound();
    1582. 

  1582.         private var muteButton:TextField = new TextField();
    1583. 

  1583.         private var channel1:SoundChannel = new SoundChannel();
    1584. 

  1584.         
    1585. 

  1585.         public function SoundMixer_stopAllExample() {
    1586. 

  1586.             firstSound.load(new URLRequest("mySound.mp3"));
    1587. 

  1587.             secondSound.load(new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"));
    1588. 

  1588. 

  1589.             firstSound.addEventListener(IOErrorEvent.IO_ERROR, firstSoundErrorHandler);
    1590. 

  1590.             secondSound.addEventListener(IOErrorEvent.IO_ERROR, secondSoundErrorHandler);
    1591. 

  1591.             
    1592. 

  1592.             channel1 = firstSound.play();
    1593. 

  1593.             secondSound.play();
    1594. 

  1594.             
    1595. 

  1595.             muteButton.autoSize = TextFieldAutoSize.LEFT;
    1596. 

  1596.             muteButton.border = true;
    1597. 

  1597.             muteButton.background = true;
    1598. 

  1598.             muteButton.text = "MUTE";
    1599. 

  1599.         
    1600. 

  1600.             muteButton.addEventListener(MouseEvent.CLICK, muteButtonClickHandler);         
    1601. 

  1601.         
    1602. 

  1602.             this.addChild(muteButton);
    1603. 

  1603.         }
    1604. 

  1604. 

  1605.         private function muteButtonClickHandler(event:MouseEvent):void {
    1606. 

  1606. 

  1607.             if(muteButton.text == "MUTE") {        
    1608. 

  1608.   
    1609. 

  1609.                 if(SoundMixer.areSoundsInaccessible() == false) {
    1610. 

  1610.                     SoundMixer.stopAll();
    1611. 

  1611.                     muteButton.text = "click to play only one of sound.";
    1612. 

  1612.                 }
    1613. 

  1613.                 else {
    1614. 

  1614.                     muteButton.text = "The sounds are not accessible.";
    1615. 

  1615.                 }
    1616. 

  1616.             }
    1617. 

  1617.            else {
    1618. 

  1618.                 firstSound.play();        
    1619. 

  1619.                 muteButton.text = "MUTE";
    1620. 

  1620.            }
    1621. 

  1621.         } 
    1622. 

  1622. 

  1623.         private function firstSoundErrorHandler(errorEvent:IOErrorEvent):void {
    1624. 

  1624.             trace(errorEvent.text);
    1625. 

  1625.         }
    1626. 

  1626. 

  1627.         private function secondSoundErrorHandler(errorEvent:IOErrorEvent):void {
    1628. 

  1628.             trace(errorEvent.text);
    1629. 

  1629.         }
    1630. 

  1630.     }
    1631. 

  1631. }
    1632. 

  1632. </codeblock></example></apiOperationDetail></apiOperation><apiValue id="flash.media:SoundMixer:bufferTime:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">bufferTime</apiName><shortdesc class="- topic/shortdesc ">
    1633. 

  1633.      在开始传输嵌入的声音流之前，将其预加载到缓冲区中所用的秒数。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1634. 

  1634.       
    1635. 

  1635.       </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1636. 

  1636.      在开始传输嵌入的声音流之前，将其预加载到缓冲区中所用的秒数。除非实现了一个跨域策略文件，否则已加载声音中的数据（包括其缓冲时间）无法被位于其他域的 SWF 文件访问。有关安全性和声音的详细信息，请参阅 Sound 类说明。<ph class="- topic/ph ">除非实现了一个跨域策略文件，否则位于其他域的文件中的代码将无法访问已加载声音中的数据（包括其缓冲时间）。但是，在 AIR 应用程序中应用程序安全沙箱中，代码可以访问来自任何源的声音文件中的数据。有关安全性和声音的详细信息，请参阅 Sound 类说明。</ph> 
    1637. 

  1637.      
    1638. 

  1638.      <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> 属性只会影响 SWF 中嵌入声音流的缓冲时间，该属性与动态创建的 Sound 对象（即在 ActionScript 中创建的 Sound 对象）无关。<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> 的值无法覆盖或设置传递到 <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> 方法的 SoundLoaderContext 对象中指定的缓冲时间默认值。</p>
    1639. 

  1639.      
    1640. 

  1640.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound" class="- topic/link "><linktext class="- topic/linktext ">Sound</linktext></link></related-links></apiValue><apiValue id="flash.media:SoundMixer:soundTransform:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">soundTransform</apiName><shortdesc class="- topic/shortdesc "> 
    1641. 

  1641.      控制全局声音属性的 SoundTransform 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>
    1642. 

  1642.       
    1643. 

  1643.       </refpath></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.media:SoundTransform</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1644. 

  1644.      控制全局声音属性的 SoundTransform 对象。SoundTransform 对象包含用于设置音量、平移、左扬声器指定和右扬声器指定的属性。在此属性中使用的 SoundTransform 对象提供最终声音设置，这些设置将在应用了任何个别声音设置之后应用于所有声音。
    1645. 

  1645.      
    1646. 

  1646.      </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#SoundTransform" class="- topic/link "><linktext class="- topic/linktext ">SoundTransform</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:CameraUI" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">CameraUI</apiName><shortdesc class="- topic/shortdesc ">
    1647. 

  1647. 	 CameraUI 类允许您使用设备上的默认摄像头应用程序捕获静态图像或视频。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1648. 

  1648. 	 CameraUI 类允许您使用设备上的默认摄像头应用程序捕获静态图像或视频。 	 
    1649. 

  1649. 	 
    1650. 

  1650. 	 <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> 方法请求设备打开默认摄像头应用程序。捕获的图像或视频在为 complete 事件调度的 MediaEvent 对象中是可用的。由于默认摄像头应用程序可以各种格式保存图像或视频，无法保证返回的媒体对象能够由 AIR 运行时加载并显示。 </p>
    1651. 

  1651. 	 
    1652. 

  1652. 	 <p class="- topic/p ">在某些平台上，摄像头返回的 media 对象作为基于文件的媒体承诺是可访问的。在其他平台上，媒体承诺不是基于文件的，MediaPromise 对象的 <codeph class="+ topic/ph pr-d/codeph ">file</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">relativePath</codeph> 属性为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。不要在多个平台上使用的代码中使用这些属性。</p>
    1653. 

  1653. 	 
    1654. 

  1654. 	 <p class="- topic/p ">在某些平台上，media 对象自动存储在设备媒体库中。在图像和视频不通过默认摄像机应用程序自动存储的那些平台上，您可以使用 CameraRoll <codeph class="+ topic/ph pr-d/codeph ">addBitmapData()</codeph> 函数存储 media 对象。</p>
    1655. 

  1655. 	 
    1656. 

  1656. 	 <p class="- topic/p ">在 Android 上，如果外部存储卡不可用（例如，用户将卡作为 USB 大容量存储器设备载入），则默认摄像机应用程序不打开。此外，启动摄像头的 AIR 应用程序会丢失焦点。如果设备在运行时资源不足，可以在媒体捕获完成之前由操作系统终止 AIR 应用程序。</p>
    1657. 

  1657. 	 
    1658. 

  1658. 	 <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>移动设备支持此功能，但桌面操作系统或用于电视的 AIR 设备不支持此功能。您可以使用 <codeph class="+ topic/ph pr-d/codeph ">CameraUI.isSupported</codeph> 属性在运行时测试是否受支持。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。</p>
    1659. 

  1659. 	 
    1660. 

  1660. 	 </apiDesc><example conref="examples\CameraUIExample.Still.1.as" class="- topic/example "> 下面的示例使用 CameraUI 类启动设备上的默认摄像头应用程序。用户拍照时，该示例将图像置于显示列表中。 
    1661. 

  1661. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1662. 

  1662. package  {
    1663. 

  1663.  import flash.desktop.NativeApplication;
    1664. 

  1664.  import flash.display.Loader;
    1665. 

  1665.  import flash.display.MovieClip;
    1666. 

  1666.  import flash.display.StageAlign;
    1667. 

  1667.  import flash.display.StageScaleMode;
    1668. 

  1668.  import flash.events.ErrorEvent;
    1669. 

  1669.  import flash.events.Event;
    1670. 

  1670.  import flash.events.IOErrorEvent;
    1671. 

  1671.  import flash.events.MediaEvent;
    1672. 

  1672.  import flash.media.CameraUI;
    1673. 

  1673.  import flash.media.MediaPromise;
    1674. 

  1674.  import flash.media.MediaType;
    1675. 

  1675.  
    1676. 

  1676.      public class CameraUIStillImage extends MovieClip{
    1677. 

  1677. 

  1678.           private var deviceCameraApp:CameraUI = new CameraUI();
    1679. 

  1679.           private var imageLoader:Loader; 
    1680. 

  1680.     
    1681. 

  1681.           public function CameraUIStillImage() {
    1682. 

  1682.                this.stage.align = StageAlign.TOP_LEFT;
    1683. 

  1683.                this.stage.scaleMode = StageScaleMode.NO_SCALE;
    1684. 

  1684.        
    1685. 

  1685.                if( CameraUI.isSupported )
    1686. 

  1686.                {
    1687. 

  1687.                 trace( "Initializing camera..." );
    1688. 

  1688.     
    1689. 

  1689.                 deviceCameraApp.addEventListener( MediaEvent.COMPLETE, imageCaptured );
    1690. 

  1690.                 deviceCameraApp.addEventListener( Event.CANCEL, captureCanceled );
    1691. 

  1691.                 deviceCameraApp.addEventListener( ErrorEvent.ERROR, cameraError );
    1692. 

  1692.                 deviceCameraApp.launch( MediaType.IMAGE );
    1693. 

  1693.                }
    1694. 

  1694.                else
    1695. 

  1695.                {
    1696. 

  1696.                 trace( "Camera interface is not supported.");
    1697. 

  1697.                }
    1698. 

  1698.           }
    1699. 

  1699.     
    1700. 

  1700.           private function imageCaptured( event:MediaEvent ):void
    1701. 

  1701.           {
    1702. 

  1702.                trace( "Media captured..." );
    1703. 

  1703.        
    1704. 

  1704.                var imagePromise:MediaPromise = event.data;
    1705. 

  1705.        
    1706. 

  1706.                if( imagePromise.isAsync )
    1707. 

  1707.                {
    1708. 

  1708.                 trace( "Asynchronous media promise." );
    1709. 

  1709.                 imageLoader = new Loader();
    1710. 

  1710.                 imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, asyncImageLoaded );
    1711. 

  1711.                 imageLoader.addEventListener( IOErrorEvent.IO_ERROR, cameraError );
    1712. 

  1712.                 
    1713. 

  1713.                 imageLoader.loadFilePromise( imagePromise );
    1714. 

  1714.                }
    1715. 

  1715.                else
    1716. 

  1716.                {
    1717. 

  1717.                 trace( "Synchronous media promise." );
    1718. 

  1718.                 imageLoader.loadFilePromise( imagePromise );
    1719. 

  1719.                 showMedia( imageLoader );
    1720. 

  1720.                }
    1721. 

  1721.           }
    1722. 

  1722.     
    1723. 

  1723.           private function captureCanceled( event:Event ):void
    1724. 

  1724.           {
    1725. 

  1725.                trace( "Media capture canceled." );
    1726. 

  1726.                NativeApplication.nativeApplication.exit();
    1727. 

  1727.           }
    1728. 

  1728.     
    1729. 

  1729.           private function asyncImageLoaded( event:Event ):void
    1730. 

  1730.           {
    1731. 

  1731.                trace( "Media loaded in memory." );
    1732. 

  1732.                showMedia( imageLoader );    
    1733. 

  1733.           }
    1734. 

  1734.     
    1735. 

  1735.           private function showMedia( loader:Loader ):void
    1736. 

  1736.           {
    1737. 

  1737.                this.addChild( loader );
    1738. 

  1738.           }
    1739. 

  1739.       
    1740. 

  1740.           private function cameraError( error:ErrorEvent ):void
    1741. 

  1741.           {
    1742. 

  1742.                trace( "Error:" + error.text );
    1743. 

  1743.                NativeApplication.nativeApplication.exit();
    1744. 

  1744.           }
    1745. 

  1745.      }
    1746. 

  1746. }
    1747. 

  1747. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="http://www.riagora.com/2010/07/android-air-and-the-camera/" class="- topic/link "><linktext class="- topic/linktext ">Michael Chaize：Android、AIR 和摄像头</linktext></link></related-links><adobeApiEvent id="flash.media:CameraUI_flash.events.Event.CANCEL_cancel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cancel</apiName><shortdesc class="- topic/shortdesc ">
    1748. 

  1748. 	 当用户关闭 Camera UI 而不保存图片或视频时，会调度 cancel 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CANCEL</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1749. 

  1749. 	 当用户关闭摄像头 UI 而不保存照片或视频时，会调度 <codeph class="+ topic/ph pr-d/codeph ">cancel</codeph> 事件。
    1750. 

  1750. 	 
    1751. 

  1751. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI_flash.events.ErrorEvent.ERROR_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><shortdesc class="- topic/shortdesc ">
    1752. 

  1752.  	当默认摄像头无法打开时，将调度 error 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ErrorEvent.ERROR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1753. 

  1753.  	当默认摄像头无法打开时，将调度 <codeph class="+ topic/ph pr-d/codeph ">error</codeph> 事件。
    1754. 

  1754. 	
    1755. 

  1755.  	</apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI_flash.events.MediaEvent.COMPLETE_complete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">complete</apiName><shortdesc class="- topic/shortdesc ">
    1756. 

  1756.  	当用户在摄像头 UI 中捕获静态图片或视频时，将调度 complete 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MediaEvent.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MediaEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1757. 

  1757.  	当用户在摄像头 UI 中捕获静态图片或视频时，将调度 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件。
    1758. 

  1758. 	
    1759. 

  1759.  	</apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="flash.media:CameraUI:CameraUI" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">CameraUI</apiName><shortdesc class="- topic/shortdesc ">
    1760. 

  1760. 		 创建 CameraUI 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1761. 

  1761. 		 创建 CameraUI 对象。
    1762. 

  1762. 		 
    1763. 

  1763. 		 </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.media:CameraUI:launch" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">launch</apiName><shortdesc class="- topic/shortdesc ">
    1764. 

  1764. 		 启动设备上的默认摄像头应用程序。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">requestedMediaType</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要捕获的媒体对象的类型。在 MediaType 类中定义此参数的有效值：
    1765. 

  1765. 		 <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">MediaType.IMAGE</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">MediaType.VIDEO</codeph></li></ul> 
    1766. 

  1766. 		  
    1767. 

  1767. 		 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1768. 

  1768. 		 启动设备上的默认摄像头应用程序。 
    1769. 

  1769. 		 
    1770. 

  1770. 		 <p class="- topic/p ">您可以使用此类捕获静态图像或视频。视频捕获使用设备上的“低品质”可携式摄像机配置文件。</p>
    1771. 

  1771. 		 
    1772. 

  1772. 		 <p class="- topic/p ">调用 <codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> 方法时，会调用设备上的默认摄像头应用程序。AIR 应用程序丢失焦点并等待用户捕获静态图像或完成捕获视频。一旦用户捕获了所需的媒体，AIR 应用程序会重新获得焦点，此 CameraUI 对象调度 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件。如果用户取消操作，则此 CameraUI 对象调度 <codeph class="+ topic/ph pr-d/codeph ">cancel</codeph> 事件。</p>
    1773. 

  1773. 		 
    1774. 

  1774. 		 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>AIR 应用程序在后台等待用户捕获图像或视频时，可能会被 Android 操作系统关闭。如果发生这种情况，用户必须重新启动应用程序。AIR 应用程序不对上一个图像捕获调度 media 事件。</p>
    1775. 

  1775. 		 
    1776. 

  1776. 		 <p class="- topic/p ">您可以使用为 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> 事件调度的 MediaEvent 对象的 <codeph class="+ topic/ph pr-d/codeph ">data</codeph> 属性访问捕获的媒体文件。此属性是 MediaPromise 类的实例，您可以使用 Loader 类的 <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> 方法将其加载到您的应用程序。请注意，设备摄像头可以用各种格式保存捕获的媒体。因此，视频很容易出问题。在 AIR 中可能无法显示捕获的媒体。</p>
    1777. 

  1777. 		 
    1778. 

  1778. 		 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#MediaType" class="- topic/link "><linktext class="- topic/linktext ">MediaType</linktext></link><link href="flash.media.xml#MediaPromise" class="- topic/link "><linktext class="- topic/linktext ">MediaPromise</linktext></link><link href="flash.display.xml#Loader/loadFilePromise()" class="- topic/link "><linktext class="- topic/linktext ">Loader.loadFilePromise()</linktext></link></related-links><adobeApiEvent id="flash.media:CameraUI:launch_complete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">complete</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:MediaEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当捕获媒体对象时进行调度。
    1779. 

  1779. 		 </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当捕获媒体对象时进行调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI:launch_cancel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cancel</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当用户从本机摄像头退出而不捕获媒体对象时进行调度。
    1780. 

  1780. 	 	 </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当用户从本机摄像头退出而不捕获媒体对象时进行调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI:launch_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当默认摄像头应用程序已在使用中时进行调度。
    1781. 

  1781. 		 </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当默认摄像头应用程序已在使用中时进行调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI:launch_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当 AIR 应用程序在后台运行且它调用此函数时进行调度。
    1782. 

  1782. 		 
    1783. 

  1783. 		 </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当 AIR 应用程序在后台运行且它调用此函数时进行调度。</shortdesc></adobeApiEvent></apiOperation><apiValue id="flash.media:CameraUI:isSupported:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isSupported</apiName><shortdesc class="- topic/shortdesc ">
    1784. 

  1784. 		 报告当前设备是否支持 CameraUI 类。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1785. 

  1785. 		 报告当前设备是否支持 CameraUI 类。
    1786. 

  1786. 		 
    1787. 

  1787. 		 </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:SoundCodec" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SoundCodec</apiName><shortdesc class="- topic/shortdesc ">
    1788. 

  1788. SoundCodec 类是在设置 Microphone 类的 codec 属性时使用的常量值的枚举。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1789. 

  1789. SoundCodec 类是在设置 <codeph class="+ topic/ph pr-d/codeph ">Microphone</codeph> 类的 <codeph class="+ topic/ph pr-d/codeph ">codec</codeph> 属性时使用的常量值的枚举。
    1790. 

  1790. 

  1791. </apiDesc></apiClassifierDetail><apiValue id="flash.media:SoundCodec:NELLYMOSER" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">NELLYMOSER</apiName><shortdesc class="- topic/shortdesc "> 
    1792. 

  1792. 	指定将使用 Nellymoser 编解码器进行音频压缩。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">NellyMoser</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1793. 

  1793. 	指定将使用 Nellymoser 编解码器进行音频压缩。此常量为 <codeph class="+ topic/ph pr-d/codeph ">Microphone.codec</codeph> 属性的默认值。
    1794. 

  1794. 	
    1795. 

  1795. 	</apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:SoundCodec:SPEEX" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">SPEEX</apiName><shortdesc class="- topic/shortdesc "> 
    1796. 

  1796. 	指定将使用 Speex 编解码器进行音频压缩。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">Speex</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 
    1797. 

  1797. 	指定将使用 Speex 编解码器进行音频压缩。
    1798. 

  1798. 	
    1799. 

  1799. 	</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:CameraRoll" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">CameraRoll</apiName><shortdesc class="- topic/shortdesc ">
    1800. 

  1800. CameraRoll 类允许您访问系统媒体库或“相机卷”中的图像数据。AIR 配置文件支持：移动设备支持此功能，但桌面操作系统或用于电视的 AIR 设备不支持此功能。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1801. 

  1801. CameraRoll 类允许您访问系统媒体库或“相机卷”中的图像数据。 
    1802. 

  1802. 

  1803. <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>移动设备支持此功能，但桌面操作系统或用于电视的 AIR 设备不支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。</p>
    1804. 

  1804. 

  1805. <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> 方法将图像添加到设备的专用媒体库。要在运行时检查应用程序是否支持 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> 方法，请检查 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsAddBitmapData</codeph> 属性。</p>
    1806. 

  1806. 

  1807. <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> 方法打开一个图像选择对话框，以便用户在媒体库中选择图像。当用户选择图像时，CameraRoll 对象调度 <codeph class="+ topic/ph pr-d/codeph ">select</codeph> 事件。使用为此事件调度的 MediaEvent 对象访问所选的图像。要在运行时检查您的应用程序是否支持 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> 方法，请检查 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsBrowseForImage</codeph> 属性。</p>
    1808. 

  1808. 

  1809. </apiDesc></apiClassifierDetail><adobeApiEvent id="flash.media:CameraRoll_flash.events.Event.CANCEL_cancel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cancel</apiName><shortdesc class="- topic/shortdesc ">
    1810. 

  1810.  当用户取消浏览图像操作而不选择图像时进行调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CANCEL</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1811. 

  1811.  当用户取消浏览图像操作而不选择图像时进行调度。
    1812. 

  1812.  
    1813. 

  1813.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll_flash.events.MediaEvent.SELECT_select" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">select</apiName><shortdesc class="- topic/shortdesc ">
    1814. 

  1814.  当用户从设备媒体库选择图像时进行调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MediaEvent.SELECT</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MediaEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1815. 

  1815.  当用户从设备媒体库选择图像时进行调度。
    1816. 

  1816.  
    1817. 

  1817.  <p class="- topic/p ">为此事件调度的 MediaEvent 对象提供对所选媒体的访问权限。</p>
    1818. 

  1818.  
    1819. 

  1819.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll_flash.events.ErrorEvent.ERROR_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><shortdesc class="- topic/shortdesc ">
    1820. 

  1820.  当出错时调度 error 事件。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ErrorEvent.ERROR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1821. 

  1821.  当出错时调度 <codeph class="+ topic/ph pr-d/codeph ">error</codeph> 事件。
    1822. 

  1822.  
    1823. 

  1823.  <p class="- topic/p ">错误源包括：</p> 
    1824. 

  1824.  <ul class="- topic/ul "><li class="- topic/li ">图像浏览器无法打开。</li><li class="- topic/li ">图像浏览器已在使用中。</li><li class="- topic/li ">AIR 应用程序尝试在后台浏览图像。</li><li class="- topic/li ">图像无法添加到媒体库。</li><li class="- topic/li ">设备不支持调用的方法。</li></ul>
    1825. 

  1825.  
    1826. 

  1826.  </apiDesc></adobeApiEventDetail></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll_flash.events.Event.COMPLETE_complete" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">complete</apiName><shortdesc class="- topic/shortdesc ">
    1827. 

  1827.  表示 addBitmapData() 操作成功完成。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1828. 

  1828.  表示 addBitmapData() 操作成功完成。
    1829. 

  1829.  
    1830. 

  1830.  </apiDesc></adobeApiEventDetail></adobeApiEvent><apiConstructor id="flash.media:CameraRoll:CameraRoll" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">CameraRoll</apiName><shortdesc class="- topic/shortdesc ">
    1831. 

  1831. 	 创建一个 CameraRoll 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1832. 

  1832. 	 创建一个 CameraRoll 对象。
    1833. 

  1833. 	 
    1834. 

  1834. 	 <p class="- topic/p ">ActionScript 仅支持一个媒体库。所有 CameraRoll 对象都保存到相同的图像储备库。</p>
    1835. 

  1835. 	 
    1836. 

  1836. 	 </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.media:CameraRoll:addBitmapData" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">addBitmapData</apiName><shortdesc class="- topic/shortdesc ">
    1837. 

  1837. 	将图像添加到设备相机卷。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bitmapData</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:BitmapData</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个 BitmapData 对象，其中包含要发送到相机卷的图像。 
    1838. 

  1838. 	
    1839. 

  1839. 	</apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1840. 

  1840. 	将图像添加到设备摄像头卷。 
    1841. 

  1841. 	
    1842. 

  1842. 	
    1843. 

  1843. 	<p class="- topic/p ">要在运行时检查应用程序是否支持 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> 方法，请检查 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsAddBitmapData</codeph> 属性。</p>
    1844. 

  1844. 	
    1845. 

  1845. 	</apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:CameraRoll:browseForImage" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">browseForImage</apiName><shortdesc class="- topic/shortdesc ">
    1846. 

  1846. 	打开图像浏览器对话框以允许用户从设备相机卷选择现有的图像。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1847. 

  1847. 	打开图像浏览器对话框以允许用户从设备摄像头卷选择现有的图像。 
    1848. 

  1848. 	
    1849. 

  1849. 	<p class="- topic/p ">当用户选择图像时，此 CameraRoll 实例调度一个包含 MediaEvent 对象的 <codeph class="+ topic/ph pr-d/codeph ">select</codeph> 事件。使用 MediaEvent 对象的 <codeph class="+ topic/ph pr-d/codeph ">data</codeph> 属性加载图像。<codeph class="+ topic/ph pr-d/codeph ">data</codeph> 属性是一个 MediaPromise 对象，您可以使用 Loader 类的 <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> 方法加载它。</p>
    1850. 

  1850. 	
    1851. 

  1851. 	<p class="- topic/p ">要在运行时检查您的应用程序是否支持 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> 方法，请检查 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsBrowseForImage</codeph> 属性。</p>
    1852. 

  1852. 	
    1853. 

  1853. 	</apiDesc><example conref="examples\CameraRoll_browseForImage_1.as" class="- topic/example "><codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">package flash.media.examples
    1854. 

  1854. {
    1855. 

  1855.         import flash.media.CameraRoll;
    1856. 

  1856.         import flash.media.MediaPromise;
    1857. 

  1857.         import flash.media.MediaType;
    1858. 

  1858.         import flash.events.MediaEvent;
    1859. 

  1859.         import flash.events.Event;
    1860. 

  1860.         import flash.display.Loader;
    1861. 

  1861.         import flash.display.Sprite;
    1862. 

  1862.         import flash.events.IOErrorEvent;
    1863. 

  1863.         import flash.display.StageAlign;
    1864. 

  1864.         import flash.display.StageScaleMode;
    1865. 

  1865.         
    1866. 

  1866.         public class CameraRollTest extends Sprite{
    1867. 

  1867.             private var mediaSource:CameraRoll = new CameraRoll();
    1868. 

  1868.             
    1869. 

  1869.             public function CameraRollTest() {
    1870. 

  1870.                 this.stage.align = StageAlign.TOP_LEFT;
    1871. 

  1871.                 this.stage.scaleMode = StageScaleMode.NO_SCALE;
    1872. 

  1872.                 
    1873. 

  1873.                 if( CameraRoll.supportsBrowseForImage )
    1874. 

  1874.                 {
    1875. 

  1875.                     log( "Browsing for image..." );
    1876. 

  1876.                     mediaSource.addEventListener( MediaEvent.SELECT, imageSelected );
    1877. 

  1877.                     mediaSource.addEventListener( Event.CANCEL, browseCanceled );
    1878. 

  1878.                     
    1879. 

  1879.                     mediaSource.browseForImage();
    1880. 

  1880.                 }
    1881. 

  1881.                 else
    1882. 

  1882.                 {
    1883. 

  1883.                     log( "Browsing in camera roll is not supported.");
    1884. 

  1884.                 }
    1885. 

  1885.             }
    1886. 

  1886.             
    1887. 

  1887.             private var imageLoader:Loader; 
    1888. 

  1888.             private function imageSelected( event:MediaEvent ):void
    1889. 

  1889.             {
    1890. 

  1890.                 log( "Image selected..." );
    1891. 

  1891.                 
    1892. 

  1892.                 var imagePromise:MediaPromise = event.data;
    1893. 

  1893.                 
    1894. 

  1894.                 imageLoader = new Loader();
    1895. 

  1895.                 if( imagePromise.isAsync )
    1896. 

  1896.                 {
    1897. 

  1897.                     log( "Asynchronous media promise." );
    1898. 

  1898.                     imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, imageLoaded );
    1899. 

  1899.                     imageLoader.contentLoaderInfo.addEventListener( IOErrorEvent.IO_ERROR, imageLoadFailed );
    1900. 

  1900.                     imageLoader.loadFilePromise( imagePromise );
    1901. 

  1901.                 }
    1902. 

  1902.                 else
    1903. 

  1903.                 {
    1904. 

  1904.                     log( "Synchronous media promise." );
    1905. 

  1905.                     imageLoader.loadFilePromise( imagePromise );
    1906. 

  1906.                     this.addChild( imageLoader );
    1907. 

  1907.                 }
    1908. 

  1908.             }
    1909. 

  1909.             
    1910. 

  1910.             private function browseCanceled( event:Event ):void
    1911. 

  1911.             {
    1912. 

  1912.                 log( "Image browse canceled." );
    1913. 

  1913.             }
    1914. 

  1914.             
    1915. 

  1915.             private function imageLoaded( event:Event ):void
    1916. 

  1916.             {
    1917. 

  1917.                 log( "Image loaded asynchronously." );
    1918. 

  1918.                 this.addChild( imageLoader );
    1919. 

  1919.             }
    1920. 

  1920.             
    1921. 

  1921.             private function imageLoadFailed( event:Event ):void
    1922. 

  1922.             {
    1923. 

  1923.                 log( "Image load failed." );
    1924. 

  1924.             }
    1925. 

  1925.             
    1926. 

  1926.             private function log( text:String ):void
    1927. 

  1927.             {
    1928. 

  1928.                 trace( text );
    1929. 

  1929.             }
    1930. 

  1930.             
    1931. 

  1931.         }
    1932. 

  1932.         
    1933. 

  1933.     }
    1934. 

  1934. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.events.xml#MediaEvent" class="- topic/link "><linktext class="- topic/linktext ">MediaEvent</linktext></link><link href="flash.media.xml#MediaPromise" class="- topic/link "><linktext class="- topic/linktext ">MediaPromise</linktext></link><link href="flash.display.xml#Loader/loadFilePromise()" class="- topic/link "><linktext class="- topic/linktext ">Loader.loadFilePromise()</linktext></link></related-links><adobeApiEvent id="flash.media:CameraRoll:browseForImage_select" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">select</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:MediaEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当用户选择图像时进行调度。
    1935. 

  1935. 	</apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当用户选择图像时进行调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll:browseForImage_cancel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cancel</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当用户取消浏览操作时进行调度。
    1936. 

  1936. 	</apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当用户取消浏览操作时进行调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll:browseForImage_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当默认图像浏览器应用程序已在使用中时进行调度。
    1937. 

  1937. 	</apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当默认图像浏览器应用程序已在使用中时进行调度。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll:browseForImage_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">当 AIR 应用程序在后台运行且它调用此函数时进行调度。
    1938. 

  1938. 	 
    1939. 

  1939. 	</apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">当 AIR 应用程序在后台运行且它调用此函数时进行调度。</shortdesc></adobeApiEvent></apiOperation><apiValue id="flash.media:CameraRoll:supportsAddBitmapData:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">supportsAddBitmapData</apiName><shortdesc class="- topic/shortdesc ">
    1940. 

  1940. 	是否支持 CameraRoll.addBitmapData() 方法。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1941. 

  1941. 	是否支持 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> 方法。当前，仅移动设备中的 AIR 应用程序支持此功能。
    1942. 

  1942. 	
    1943. 

  1943. 	</apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:CameraRoll:supportsBrowseForImage:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">supportsBrowseForImage</apiName><shortdesc class="- topic/shortdesc ">
    1944. 

  1944. 	报告是否支持 CameraRoll.browseForImage() 方法。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">报告是否支持 CameraRoll browseForImage() 方法。
    1945. 

  1945. 	</apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1946. 

  1946. 	报告是否支持 <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> 方法。当前，仅移动设备中的 AIR 应用程序支持此功能。
    1947. 

  1947. 	
    1948. 

  1948. 	</apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:Microphone" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Microphone</apiName><shortdesc class="- topic/shortdesc ">
    1949. 

  1949.  使用 Microphone 类监视音频或从麦克风捕获音频。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound
    1950. 

  1950.  </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    1951. 

  1951.  使用 Microphone 类监视音频或从麦克风捕获音频。
    1952. 

  1952.  
    1953. 

  1953.  <p class="- topic/p ">
    1954. 

  1954.  要获得对 Microphone 实例的引用，请使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> 方法或 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> 方法。增强的麦克风实例可执行回音消除。使用回音消除功能可创建不需要耳机的实时音频/视频应用程序。 
    1955. 

  1955.  </p>
    1956. 

  1956.  
    1957. 

  1957.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">创建实时聊天应用程序</b></p>
    1958. 

  1958.  <p class="- topic/p ">若要创建实时聊天应用程序，请捕获音频并将其发送到 Flash Media Server。使用 NetConnection 和 NetStream 类可将音频流发送到 Flash Media Server。Flash Media Server 可将音频广播到其他客户端。若要创建不需要耳机的聊天应用程序，请使用回音消除功能。回音消除功能可防止反馈回路 — 当音频进入麦克风，离开扬声器，并再次进入麦克风时，将产生反馈回路。若要使用回音消除功能，请调用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> 方法以获得对 Microphone 实例的引用。将 <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> 设置为 <codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> 类的实例可配置设置。</p>
    1959. 

  1959.  
    1960. 

  1960.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">在本地播放麦克风音频</b></p>
    1961. 

  1961.  <p class="- topic/p ">调用 Microphone <codeph class="+ topic/ph pr-d/codeph ">setLoopback()</codeph> 方法将麦克风音频直接传送到本地计算机或设备音频输出。未控制的音频反馈始终是个问题，每当音频输出可以由麦克风输入拾取时都可能发生。<codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> 方法可以减少（但无法消除）反馈放大的风险。</p>
    1962. 

  1962.  
    1963. 

  1963.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">捕获麦克风音频以便进行本地录制或处理</b></p>
    1964. 

  1964.  <p class="- topic/p ">要捕获麦克风音频，请侦听由 Microphone 实例调度的 <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> 事件。为此事件调度的 SampleDataEvent 对象包含音频数据。</p>
    1965. 

  1965.  
    1966. 

  1966.  <p class="- topic/p ">有关捕获视频的信息，请参阅 Camera 类。</p>
    1967. 

  1967.  
    1968. 

  1968.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">运行时麦克风支持</b></p>
    1969. 

  1969.  <p class="- topic/p ">在移动浏览器中运行的 Flash Player 不支持 Microphone 类。</p>
    1970. 

  1970.  
    1971. 

  1971.  <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>桌面操作系统支持 Microphone 类，但并非所有移动设备均支持此功能。用于电视的 AIR 设备不支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。</p>
    1972. 

  1972.  
    1973. 

  1973.  <p class="- topic/p ">您可以使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.isSupported</codeph> 属性在运行时测试是否受支持。注意，在用于电视的 AIR 设备上，<codeph class="+ topic/ph pr-d/codeph ">Microphone.isSupported</codeph> 为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，但是 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> 始终返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。</p>
    1974. 

  1974.  
    1975. 

  1975.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">隐私控制</b></p>
    1976. 

  1976.  <p class="- topic/p ">
    1977. 

  1977.  Flash Player 显示一个“隐私”对话框，让用户选择是允许还是拒绝访问麦克风。您的应用程序窗口大小必须至少是 215 x 138 像素，这是显示对话框要求的最小大小，否则自动拒绝访问。
    1978. 

  1978.  </p>
    1979. 

  1979.  <p class="- topic/p ">在 AIR 应用程序沙箱中运行的内容不需要访问麦克风的权限，并且不显示对话框。在应用程序沙箱外运行的 AIR 内容要求权限，并显示“隐私”对话框。</p>
    1980. 

  1980.  
    1981. 

  1981.  </apiDesc><example conref="examples\MicrophoneExample.as" class="- topic/example "> 以下示例在用户允许访问其计算机的麦克风后通过使用麦克风的回音抑制捕获声音。<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> 方法显示 Flash Player 对话框，请求提供对用户的麦克风的访问权限。对 <codeph class="+ topic/ph pr-d/codeph ">setLoopBack(true)</codeph> 的调用会将输入重新发送到本地扬声器，以便在运行示例时可以听到声音。
    1982. 

  1982.  
    1983. 

  1983.  <p class="- topic/p ">有两个侦听器用于侦听 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件。<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件在会话开始和结束（如果有）时被调度，并由 <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> 方法捕获（此方法跟踪有关该事件的信息）。<codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件在附加的 Microphone 对象报告任何状态信息时被调度；将使用 <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph> 方法捕获并跟踪此信息。</p>
    1984. 

  1984.  
    1985. 

  1985.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>必须将麦克风与计算机连接，此示例才能正常运行。</p>
    1986. 

  1986. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    1987. 

  1987. 

  1988. package {
    1989. 

  1989.     import flash.display.Sprite;
    1990. 

  1990.     import flash.events.*;
    1991. 

  1991.     import flash.media.Microphone;
    1992. 

  1992.     import flash.system.Security;
    1993. 

  1993. 

  1994.     public class MicrophoneExample extends Sprite {
    1995. 

  1995.         public function MicrophoneExample() {
    1996. 

  1996.             var mic:Microphone = Microphone.getMicrophone();
    1997. 

  1997.             Security.showSettings("2");
    1998. 

  1998.             mic.setLoopBack(true);
    1999. 

  1999.                     
    2000. 

  2000.             if (mic != null) {
    2001. 

  2001.                 mic.setUseEchoSuppression(true);
    2002. 

  2002.                 mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
    2003. 

  2003.                 mic.addEventListener(StatusEvent.STATUS, statusHandler);
    2004. 

  2004.             }
    2005. 

  2005.         }
    2006. 

  2006. 

  2007.         private function activityHandler(event:ActivityEvent):void {
    2008. 

  2008.             trace("activityHandler: " + event);
    2009. 

  2009.         }
    2010. 

  2010. 

  2011.         private function statusHandler(event:StatusEvent):void {
    2012. 

  2012.             trace("statusHandler: " + event);
    2013. 

  2013.         }
    2014. 

  2014.     }
    2015. 

  2015. }
    2016. 

  2016. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Camera</linktext></link><link href="flash.media.xml#MicrophoneEnhancedMode" class="- topic/link "><linktext class="- topic/linktext ">flash.media.MicrophoneEnhancedMode</linktext></link><link href="flash.media.xml#MicrophoneEnhancedOptions" class="- topic/link "><linktext class="- topic/linktext ">flash.media.MicrophoneEnhancedOptions</linktext></link><link href="http://mrbinitie.blogspot.com/2011/03/implementing-acoustic-echo-suppression.html" class="- topic/link "><linktext class="- topic/linktext ">aYo Binitie：在 Flash/Flex 应用程序中实现回音抑制</linktext></link><link href="http://coenraets.org/blog/air-for-android-samples/voice-notes-for-android/" class="- topic/link "><linktext class="- topic/linktext ">Cristophe Coenraets：Android 语音注意事项</linktext></link><link href="http://www.riagora.com/2010/08/air-android-and-the-microphone/" class="- topic/link "><linktext class="- topic/linktext ">Michael Chaize：AIR、Android 和麦克风</linktext></link></related-links><adobeApiEvent id="flash.media:Microphone_flash.events.StatusEvent.STATUS_status" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">status</apiName><shortdesc class="- topic/shortdesc ">
    2017. 

  2017.  在麦克风报告其状态时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.StatusEvent.STATUS</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.StatusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2018. 

  2018.  在麦克风报告其状态时调度。如果 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为“<codeph class="+ topic/ph pr-d/codeph ">Microphone.Muted</codeph>”，则表示用户拒绝 SWF 文件访问麦克风。如果 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为“<codeph class="+ topic/ph pr-d/codeph ">Microphone.Unmuted</codeph>”，则表示用户允许 SWF 文件访问麦克风。
    2019. 

  2019.  
    2020. 

  2020.  <p class="- topic/p ">在 Adobe AIR 应用程序中不调度 Status 事件；无法动态更改对麦克风的访问权限。在大多数平台上，AIR 应用程序始终可以访问麦克风。在 Android 上，应用程序必须在应用程序描述符中指定 Android RECORD_AUDIO 权限。否则，Android 会同时拒绝对麦克风的访问。</p>
    2021. 

  2021.  
    2022. 

  2022.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">Microphone.getMicrophone()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Microphone_flash.events.SampleDataEvent.SAMPLE_DATA_sampleData" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">sampleData</apiName><shortdesc class="- topic/shortdesc ">
    2023. 

  2023.   当麦克风在缓冲区中包含声音数据时调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.SampleDataEvent.SAMPLE_DATA</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.SampleDataEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2024. 

  2024.   当麦克风在缓冲区中包含声音数据时调度。 
    2025. 

  2025.  <p class="- topic/p ">
    2026. 

  2026.  <codeph class="+ topic/ph pr-d/codeph ">Microphone.rate</codeph> 属性确定每秒生成的采样数。每个事件的样本数是每秒样本数和事件调用之间延迟的一个系数。
    2027. 

  2027.  </p>
    2028. 

  2028.  
    2029. 

  2029.  </apiDesc><example conref="examples\Microphone.sampleDataEvent.1.as" class="- topic/example "> 以下示例从默认麦克风捕获 4 秒钟的音频采样，然后回放该音频。确保麦克风已连接。<codeph class="+ topic/ph pr-d/codeph ">micSampleDataHandler()</codeph> 是 Microphone 对象的 <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> 事件的事件侦听器。<codeph class="+ topic/ph pr-d/codeph ">micSampleDataHandler()</codeph> 方法获取可用采样并将它们的值附加到 ByteArray 对象。Timer 对象设置为 4 秒。Timer 删除 Microphone 对象事件侦听器的 <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> 事件，创建 Sound 对象，并为 Sound 对象添加 <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> 事件侦听器。Sound 对象的 <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> 事件侦听器，即 <codeph class="+ topic/ph pr-d/codeph ">playbackSampleHandler()</codeph> 方法，为要播放的 Sound 对象提供了音频采样。这些音频采样是从存储 Microphone 采样的 ByteArray 对象中检索出的。由于 Microphone 采样使用单声道声音记录而 Sound 对象请求立体声对采样，所以采样被写入 Sound 对象两次。Microphone 对象的 <codeph class="+ topic/ph pr-d/codeph ">rate</codeph> 属性设置为 44，以匹配 Sound 对象使用的 44 kHz 采样率。
    2030. 

  2030.  
    2031. 

  2031.  
    2032. 

  2032. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> 
    2033. 

  2033. const DELAY_LENGTH:int = 4000;
    2034. 

  2034. 

  2035. var mic:Microphone = Microphone.getMicrophone();
    2036. 

  2036. mic.setSilenceLevel(0, DELAY_LENGTH);
    2037. 

  2037. mic.gain = 100;
    2038. 

  2038. mic.rate = 44;
    2039. 

  2039. mic.addEventListener(SampleDataEvent.SAMPLE_DATA, micSampleDataHandler);
    2040. 

  2040. 

  2041. var timer:Timer = new Timer(DELAY_LENGTH);
    2042. 

  2042. timer.addEventListener(TimerEvent.TIMER, timerHandler);
    2043. 

  2043. timer.start();
    2044. 

  2044. 

  2045. var soundBytes:ByteArray = new ByteArray();
    2046. 

  2046. 

  2047. function micSampleDataHandler(event:SampleDataEvent):void
    2048. 

  2048. {
    2049. 

  2049.     while(event.data.bytesAvailable)
    2050. 

  2050.     {
    2051. 

  2051.         var sample:Number = event.data.readFloat();
    2052. 

  2052.         soundBytes.writeFloat(sample);
    2053. 

  2053.     }
    2054. 

  2054. }
    2055. 

  2055. 

  2056. function timerHandler(event:TimerEvent):void
    2057. 

  2057. {        
    2058. 

  2058.     mic.removeEventListener(SampleDataEvent.SAMPLE_DATA, micSampleDataHandler);
    2059. 

  2059.     timer.stop();
    2060. 

  2060.     soundBytes.position = 0;
    2061. 

  2061.     var sound:Sound = new Sound();
    2062. 

  2062.     sound.addEventListener(SampleDataEvent.SAMPLE_DATA, playbackSampleHandler);
    2063. 

  2063.     sound.play();
    2064. 

  2064. }
    2065. 

  2065. 

  2066. function playbackSampleHandler(event:SampleDataEvent):void
    2067. 

  2067. {
    2068. 

  2068.     for (var i:int = 0; i &lt; 8192 &amp;&amp; soundBytes.bytesAvailable > 0; i++) 
    2069. 

  2069.     {
    2070. 

  2070.         var sample:Number = soundBytes.readFloat();
    2071. 

  2071.         event.data.writeFloat(sample);
    2072. 

  2072.         event.data.writeFloat(sample);
    2073. 

  2073.     }
    2074. 

  2074. }
    2075. 

  2075. </codeblock></example><example conref="examples\MicrophoneExample.as" class="- topic/example "> 以下示例在用户允许访问其计算机的麦克风后通过使用麦克风的回音抑制捕获声音。<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> 方法显示 Flash Player 对话框，请求提供对用户的麦克风的访问权限。对 <codeph class="+ topic/ph pr-d/codeph ">setLoopBack(true)</codeph> 的调用会将输入重新发送到本地扬声器，以便在运行示例时可以听到声音。
    2076. 

  2076.  
    2077. 

  2077.  <p class="- topic/p ">有两个侦听器用于侦听 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件。<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件在会话开始和结束（如果有）时被调度，并由 <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> 方法捕获（此方法跟踪有关该事件的信息）。<codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件在附加的 Microphone 对象报告任何状态信息时被调度；将使用 <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph> 方法捕获并跟踪此信息。</p>
    2078. 

  2078.  
    2079. 

  2079.  <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>必须将麦克风与计算机连接，此示例才能正常运行。</p>
    2080. 

  2080. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2081. 

  2081. 

  2082. package {
    2083. 

  2083.     import flash.display.Sprite;
    2084. 

  2084.     import flash.events.*;
    2085. 

  2085.     import flash.media.Microphone;
    2086. 

  2086.     import flash.system.Security;
    2087. 

  2087. 

  2088.     public class MicrophoneExample extends Sprite {
    2089. 

  2089.         public function MicrophoneExample() {
    2090. 

  2090.             var mic:Microphone = Microphone.getMicrophone();
    2091. 

  2091.             Security.showSettings("2");
    2092. 

  2092.             mic.setLoopBack(true);
    2093. 

  2093.                     
    2094. 

  2094.             if (mic != null) {
    2095. 

  2095.                 mic.setUseEchoSuppression(true);
    2096. 

  2096.                 mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
    2097. 

  2097.                 mic.addEventListener(StatusEvent.STATUS, statusHandler);
    2098. 

  2098.             }
    2099. 

  2099.         }
    2100. 

  2100. 

  2101.         private function activityHandler(event:ActivityEvent):void {
    2102. 

  2102.             trace("activityHandler: " + event);
    2103. 

  2103.         }
    2104. 

  2104. 

  2105.         private function statusHandler(event:StatusEvent):void {
    2106. 

  2106.             trace("statusHandler: " + event);
    2107. 

  2107.         }
    2108. 

  2108.     }
    2109. 

  2109. }
    2110. 

  2110. </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.events.xml#SampleDataEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.SampleDataEvent</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Microphone_flash.events.ActivityEvent.ACTIVITY_activity" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">activity</apiName><shortdesc class="- topic/shortdesc ">
    2111. 

  2111.  当麦克风开始或由于检测到静默而终止录制时进行调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ActivityEvent.ACTIVITY</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ActivityEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2112. 

  2112.  当麦克风开始或由于检测到静默而终止录制时进行调度。 
    2113. 

  2113.  
    2114. 

  2114.  <p class="- topic/p ">
    2115. 

  2115.  要指定触发 <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 属性值为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph> 的此事件所需的音量，或者指定在没有声音的情况下经过多长时间才会触发 <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 属性值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph> 的此事件，请使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph>。
    2116. 

  2116.  </p>
    2117. 

  2117.  <p class="- topic/p ">要使 Microphone 对象调度 activity 事件，应用程序必须通过调用 <codeph class="+ topic/ph pr-d/codeph ">setLoopback( true )</codeph> 或侦听 sampleData 事件或者将麦克风附加到 NetStream 对象来监视输入。</p>
    2118. 

  2118.  
    2119. 

  2119.  </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/setSilenceLevel()" class="- topic/link "><linktext class="- topic/linktext ">setSilenceLevel()</linktext></link></related-links></adobeApiEvent><apiOperation id="flash.media:Microphone:getEnhancedMicrophone" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getEnhancedMicrophone</apiName><shortdesc class="- topic/shortdesc ">
    2120. 

  2120. 	 返回对可以执行回音消除功能的增强的 Microphone 对象的引用。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.3" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.7" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">对用于捕获音频的 Microphone 对象的引用。如果增强的音频初始化失败，则返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。
    2121. 

  2121. 	 </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:Microphone</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">index</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">-1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">麦克风的索引值。
    2122. 

  2122. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2123. 

  2123. 	 返回对可以执行回音消除功能的增强的 Microphone 对象的引用。使用回音消除功能可创建不需要耳机的音频/视频聊天应用程序。
    2124. 

  2124. 	 
    2125. 

  2125. 	 <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> 方法和 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> 方法的 <codeph class="+ topic/ph pr-d/codeph ">index</codeph> 参数的工作方式相同。</p>
    2126. 

  2126. 	 
    2127. 

  2127. 	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">重要说明：</b>在任何给定时间，您只能具有单个增强麦克风设备实例。所有其他 Microphone 实例都将停止提供音频数据，并且将收到 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性为 <codeph class="+ topic/ph pr-d/codeph ">Microphone.Unavailable</codeph> 的 <codeph class="+ topic/ph pr-d/codeph ">StatusEvent</codeph>。当增强的音频初始化失败时，调用此方法将返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，为 <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> 设置值没有效果，并且所有现有 Microphone 实例的工作方式保持不变。</p>
    2128. 

  2128. 	 
    2129. 

  2129. 	 <p class="- topic/p ">若要配置增强的 Microphone 对象，请设置 <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> 属性。下面的代码在本地测试中使用增强的 Microphone 对象和全双工回音消除功能：</p>
    2130. 

  2130. 	 
    2131. 

  2131. 	 <pre xml:space="preserve" class="- topic/pre ">
    2132. 

  2132. 	     var mic:Microphone = Microphone.getEnhancedMicrophone();
    2133. 

  2133. 	     var options:MicrophoneEnhancedOptions = new MicrophoneEnhancedOptions();
    2134. 

  2134. 	     options.mode = MicrophoneEnhancedMode.FULL_DUPLEX;
    2135. 

  2135. 	     mic.enhancedOptions = options;
    2136. 

  2136. 	     mic.setLoopBack(true);
    2137. 

  2137. 	 </pre>
    2138. 

  2138. 	 
    2139. 

  2139. 	 <p class="- topic/p ">在使用回音消除功能时，将忽略 <codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> 方法。
    2140. 

  2140. 	 </p>
    2141. 

  2141. 	 
    2142. 

  2142. 	 <p class="- topic/p ">
    2143. 

  2143. 	 当 SWF 文件尝试访问 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> 返回的对象时（例如，在调用 <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph> 时），Flash Player 将显示“隐私”对话框，用户可从中选择是允许还是拒绝访问麦克风。（确保舞台大小至少为 215 x 138 个像素；这是 Flash Player 显示该对话框所需的最小大小。）
    2144. 

  2144. 	 </p>
    2145. 

  2145. 	 
    2146. 

  2146. 	 
    2147. 

  2147. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">Microphone.getMicrophone()</linktext></link><link href="flash.media.xml#Microphone/enhancedOptions" class="- topic/link "><linktext class="- topic/linktext ">Microphone.enhancedOptions</linktext></link><link href="flash.media.xml#Microphone/event:status" class="- topic/link "><linktext class="- topic/linktext ">Microphone.status</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Microphone:getMicrophone" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getMicrophone</apiName><shortdesc class="- topic/shortdesc ">
    2148. 

  2148. 	 
    2149. 

  2149. 	 返回对用于捕获音频的 Microphone 对象的引用。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, Microphone.getMicropone, getMicrophone
    2150. 

  2150. 	 
    2151. 

  2151. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">对用于捕获音频的 Microphone 对象的引用。
    2152. 

  2152. 	 
    2153. 

  2153.  	 </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:Microphone</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">index</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">-1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">麦克风的索引值。
    2154. 

  2154. 	 
    2155. 

  2155. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2156. 

  2156. 	 
    2157. 

  2157. 	 返回对用于捕获音频的 Microphone 对象的引用。要开始捕获音频，您必须将 Microphone 对象附加到 NetStream 对象（请参阅 <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph>）。
    2158. 

  2158. 	 
    2159. 

  2159. 	 <p class="- topic/p ">
    2160. 

  2160. 	 多个对 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> 的调用引用相同的麦克风。因此，如果您的代码包含 <codeph class="+ topic/ph pr-d/codeph ">mic1 = Microphone.getMicrophone()</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">mic2 = Microphone.getMicrophone()</codeph> 行，那么 <codeph class="+ topic/ph pr-d/codeph ">mic1</codeph> 和 <codeph class="+ topic/ph pr-d/codeph ">mic2</codeph> 都会引用相同的（默认）麦克风。</p>
    2161. 

  2161. 	 
    2162. 

  2162. 	 <p class="- topic/p ">
    2163. 

  2163. 	 通常，不应传递 <codeph class="+ topic/ph pr-d/codeph ">index</codeph> 的值。只需调用 <codeph class="+ topic/ph pr-d/codeph ">air.Microphone.getMicrophone()</codeph> 即可返回对默认麦克风的引用。使用 Flash Player 设置面板的“麦克风设置”部分，用户可以指定应用程序应该使用的默认麦克风。（用户通过右键单击在 Web 浏览器中运行的 Flash Player 内容来访问 Flash Player 设置面板。）如果您为 <codeph class="+ topic/ph pr-d/codeph ">index</codeph> 传递一个值，您可以引用与用户选择的麦克风不同的麦克风。在极少数情况下（例如，应用程序同时从两个麦克风捕获音频），您可能会使用 <codeph class="+ topic/ph pr-d/codeph ">index</codeph>。在 Adobe AIR 中运行的内容也使用默认麦克风的 Flash Player 设置。</p>
    2164. 

  2164. 	 
    2165. 

  2165. 	 <p class="- topic/p ">
    2166. 

  2166. 	 使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.index</codeph> 属性可以获取当前 Microphone 对象的索引值。然后，可以将该值传递给 Microphone 类的其他方法。
    2167. 

  2167. 	 </p>
    2168. 

  2168. 	 
    2169. 

  2169. 	 <p class="- topic/p ">
    2170. 

  2170. 	 当 SWF 文件尝试访问 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> 返回的对象时（例如，在调用 <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph> 时），Flash Player 将显示“隐私”对话框，用户可从中选择是允许还是拒绝访问麦克风。（确保舞台大小至少为 215 x 138 个像素；这是 Flash Player 显示该对话框所需的最小大小。）
    2171. 

  2171. 	 </p>
    2172. 

  2172. 	 
    2173. 

  2173. 	 <p class="- topic/p ">
    2174. 

  2174.          当用户对此对话框做出响应时，将调度 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件以表示用户的响应。还可以检查 <codeph class="+ topic/ph pr-d/codeph ">Microphone.muted</codeph> 属性以确定用户是允许还是拒绝访问麦克风。 
    2175. 

  2175. 	 </p>
    2176. 

  2176. 	 
    2177. 

  2177. 	 <p class="- topic/p ">
    2178. 

  2178. 	 如果 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> 返回 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，则表明麦克风正由其它应用程序使用，或者系统上没有安装任何麦克风。要确定是否安装了任何麦克风，请使用 <codeph class="+ topic/ph pr-d/codeph ">Microphones.names.length</codeph>。要显示 Flash Player 的“麦克风设置”面板（用户可从中选择 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone</codeph> 所引用的麦克风），请使用 <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph>。 
    2179. 

  2179. 	 
    2180. 

  2180. 	 </p>
    2181. 

  2181. 	 
    2182. 

  2182. 	 </apiDesc><example conref="examples\Microphone_getMicrophone.as" class="- topic/example "> 以下示例显示如何通过使用静态 Microphone.getMicrophone() 方法并侦听状态事件来请求对用户麦克风的访问权限。<xref href="http://actionscriptexamples.com/2008/12/04/detecting-the-microphone-in-flash-using-actionscript-30/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref> 提供的示例。 
    2183. 

  2183. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
    2184. 

  2184. var mic:Microphone = Microphone.getMicrophone();
    2185. 

  2185. mic.setLoopBack();
    2186. 

  2186. mic.addEventListener(StatusEvent.STATUS, mic_status);
    2187. 

  2187.  
    2188. 

  2188. var tf:TextField = new TextField();
    2189. 

  2189. tf.autoSize = TextFieldAutoSize.LEFT;
    2190. 

  2190. tf.text = "Detecting microphone...";
    2191. 

  2191. addChild(tf);
    2192. 

  2192.  
    2193. 

  2193. function mic_status(evt:StatusEvent):void {
    2194. 

  2194.     tf.text = "Microphone is muted?: " + mic.muted;
    2195. 

  2195.     switch (evt.code) {
    2196. 

  2196.         case "Microphone.Unmuted":
    2197. 

  2197.             tf.appendText("\n" + "Microphone access was allowed.");
    2198. 

  2198.             break;
    2199. 

  2199.         case "Microphone.Muted":
    2200. 

  2200.             tf.appendText("\n" + "Microphone access was denied.");
    2201. 

  2201.             break;
    2202. 

  2202.     }
    2203. 

  2203. }
    2204. 

  2204. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/event:status" class="- topic/link "><linktext class="- topic/linktext ">Microphone.status</linktext></link><link href="flash.net.xml#NetStream/attachAudio()" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.attachAudio()</linktext></link><link href="flash.system.xml#Security/showSettings()" class="- topic/link "><linktext class="- topic/linktext ">flash.system.Security.showSettings()</linktext></link></related-links><adobeApiEvent id="flash.media:Microphone:getMicrophone_status" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">status</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:StatusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">在麦克风报告其状态时调度。如果 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为 <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Muted"</codeph>，则表示用户拒绝 SWF 文件访问其麦克风。如果 <codeph class="+ topic/ph pr-d/codeph ">code</codeph> 属性的值为 <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Unmuted"</codeph>，则表示用户允许 SWF 文件访问其麦克风。
    2205. 

  2205. 	 
    2206. 

  2206. 	 </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">在麦克风报告其状态时调度。</shortdesc></adobeApiEvent></apiOperation><apiOperation id="flash.media:Microphone:setLoopBack" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setLoopBack</apiName><shortdesc class="- topic/shortdesc ">
    2207. 

  2207. 	 将麦克风捕获的音频传送到本地扬声器。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>Document this better with examples.
    2208. 

  2208. 	 </internal></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">state</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">true</apiData></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2209. 

  2209. 	 将麦克风捕获的音频传送到本地扬声器。
    2210. 

  2210. 	 
    2211. 

  2211. 	 </apiDesc></apiOperationDetail></apiOperation><apiOperation id="flash.media:Microphone:setSilenceLevel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setSilenceLevel</apiName><shortdesc class="- topic/shortdesc ">
    2212. 

  2212. 	 设置可认定为有声的最低音量输入水平，以及实际静音前需经历的无声时间长度（可选）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.setSilenceLevel, setSilenceLevel
    2213. 

  2213. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">silenceLevel</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">激活麦克风并调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件所需的音量。可接受值的范围为 0 到 100。 
    2214. 

  2214. 	 
    2215. 

  2215. 	 </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">timeout</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">-1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">在没有活动的情况下经过的毫秒数，必须经过这么长的时间，Flash Player 或 Adobe AIR 才会认为声音已停止并调度 <codeph class="+ topic/ph pr-d/codeph ">dispatch</codeph> 事件。默认值为 2000（2 秒）。(<b class="+ topic/ph hi-d/b ">注意：</b>在签名中显示的默认值 -1 是一个内部值，用于表示 Flash Player 或 Adobe AIR 使用 2000。）
    2216. 

  2216. 	 
    2217. 

  2217. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2218. 

  2218. 	 设置可认定为有声的最低音量输入水平，以及实际静音前需经历的无声时间长度（可选）。
    2219. 

  2219. 	 <ul class="- topic/ul "><li class="- topic/li ">要完全禁止麦克风检测声音，请为 <codeph class="+ topic/ph pr-d/codeph ">silenceLevel</codeph> 传递值 100；这样就决不会再调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件了。 </li><li class="- topic/li ">要确定麦克风当前所检测的音量，请使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.activityLevel</codeph>。 </li></ul>
    2220. 

  2220. 	 
    2221. 

  2221. 	 <p class="- topic/p ">Speex 具有语音活动检测功能 (VAD)，在未检测到语音时将自动减小带宽。使用 Speex 编解码器时，Adobe 建议将静音级别设置为 0。</p>
    2222. 

  2222. 	 
    2223. 

  2223. 	 <p class="- topic/p ">活动检测是检测声音级别在何时表示某人正在谈话的功能。当某人没有谈话时，由于不需要发送关联的音频流，因此可以节约带宽。此信息也可用于视频反馈，以便让用户知道他们（或其它人）没有谈话。</p>
    2224. 

  2224. 	 
    2225. 

  2225. 	 <p class="- topic/p ">静音值与活动值直接对应。完全静音对应于活动值 0。持续噪音（根据当前增益设置可以检测到的噪音）对应于活动值 100。当增益得到适当调整之后，在您没有说话时，活动值将小于静音值；在您说话时，活动值将大于静音值。</p>
    2226. 

  2226. 	 
    2227. 

  2227. 	 <p class="- topic/p ">此方法与 <codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> 类似；这两种方法都用于指定何时调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件。不过，这两种方法在对发布流的影响上具有显著的差异：</p>
    2228. 

  2228. 	 
    2229. 

  2229. 	 <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> 设计用于检测运动，并且不影响带宽用量。即使视频流未检测到运动，仍将发送视频。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> 设计用于优化带宽。在认为音频流被静音时，不发送任何音频数据。而改为发送一条表示静音已启动的消息。 </li></ul>
    2230. 

  2230. 	 
    2231. 

  2231. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/setMotionLevel()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Camera.setMotionLevel()</linktext></link><link href="flash.media.xml#Microphone/activityLevel" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.activityLevel</linktext></link><link href="flash.media.xml#Microphone/event:activity" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.activity</linktext></link><link href="flash.media.xml#Microphone/gain" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.gain</linktext></link><link href="flash.media.xml#Microphone/silenceLevel" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.silenceLevel</linktext></link><link href="flash.media.xml#Microphone/silenceTimeout" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.silenceTimeout</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Microphone:setUseEchoSuppression" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUseEchoSuppression</apiName><shortdesc class="- topic/shortdesc ">
    2232. 

  2232. 	 指定是否使用音频编解码器的回音抑制功能。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.setUseEchoSuppression, setUseEchoSuppression
    2233. 

  2233. 	 </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">useEchoSuppression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个 Boolean 值，表示是使用回音抑制 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) 还是不使用该功能 (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>)。 	 
    2234. 

  2234. 	 
    2235. 

  2235. 	 </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2236. 

  2236. 	 指定是否使用音频编解码器的回音抑制功能。除非用户已经在 Flash Player 的“麦克风设置”面板中选择了“降低回音”，否则默认值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。
    2237. 

  2237. 	 
    2238. 

  2238. 	 <p class="- topic/p ">回音抑制是指降低音频回馈效果，当扬声器发出的声音由同一系统上的麦克风拾取时，将导致音频回馈。（这不同于回音消除，后者会完全移除反馈。在调用 <codeph class="+ topic/ph pr-d/codeph ">getEnhancedMicrophone()</codeph> 方法以使用回音消除功能时，将忽略 <codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> 方法。）</p>
    2239. 

  2239. 	 
    2240. 

  2240. 	 <p class="- topic/p ">通常情况下，当通过扬声器（而不是耳机）播放所捕获的声音时，建议使用回音抑制。如果您的 SWF 文件允许用户指定声音输出设备，则当他们指定使用扬声器并且还将使用麦克风时，您可能需要调用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.setUseEchoSuppression(true)</codeph>。 </p>
    2241. 

  2241. 	 
    2242. 

  2242. 	 <p class="- topic/p ">用户也可以在 Flash Player 的“麦克风设置”面板中调整这些设置。</p>
    2243. 

  2243. 	 
    2244. 

  2244. 	 </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/setUseEchoSuppression()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.setUseEchoSuppression()</linktext></link><link href="flash.media.xml#Microphone/useEchoSuppression" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.useEchoSuppression</linktext></link></related-links></apiOperation><apiValue id="flash.media:Microphone:activityLevel:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">activityLevel</apiName><shortdesc class="- topic/shortdesc ">
    2245. 

  2245. 	 麦克风正在检测的音量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.activityLevel, activityLevel
    2246. 

  2246. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2247. 

  2247. 	 麦克风正在检测的音量。值的范围为 0（未检测到声音）到 100（检测到非常大的声音）。此属性的值有助于确定向 <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> 方法传递的适当值。
    2248. 

  2248. 	 
    2249. 

  2249. 	 <p class="- topic/p ">如果麦克风 <codeph class="+ topic/ph pr-d/codeph ">muted</codeph> 属性为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，此属性的值始终为 -1。</p>
    2250. 

  2250. 	 
    2251. 

  2251. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.getMicrophone()</linktext></link><link href="flash.media.xml#Microphone/setSilenceLevel()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.setSilenceLevel()</linktext></link><link href="flash.media.xml#Microphone/gain" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.gain</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:codec:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">codec</apiName><shortdesc class="- topic/shortdesc ">
    2252. 

  2252. 	 用于压缩音频的编解码器。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.getCodec, getCodec
    2253. 

  2253. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2254. 

  2254. 	 用于压缩音频的编解码器。可用编解码器为 Nellymoser（默认值）和 Speex。枚举类 <codeph class="+ topic/ph pr-d/codeph ">SoundCodec</codeph> 包含各种对 <codeph class="+ topic/ph pr-d/codeph ">codec</codeph> 属性有效的值。
    2255. 

  2255. 	 
    2256. 

  2256. 	 <p class="- topic/p ">如果使用 Nellymoser 编解码器，可使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.rate()</codeph> 设置采样率。如果使用 Speex 编解码器，则采样率会设置为 16 kHz。</p>
    2257. 

  2257. 	 
    2258. 

  2258. 	 <p class="- topic/p ">Speex 具有语音活动检测功能 (VAD)，在未检测到语音时将自动减小带宽。使用 Speex 编解码器时，Adobe 建议将静音级别设置为 0。要设置静音级别，请使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> 方法。</p>
    2259. 

  2259. 	 
    2260. 

  2260. 	 
    2261. 

  2261. 	 
    2262. 

  2262. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/setSilenceLevel()" class="- topic/link "><linktext class="- topic/linktext ">setSilenceLevel()</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:enableVAD:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">enableVAD</apiName><shortdesc class="- topic/shortdesc ">
    2263. 

  2263. 	 启用 Speex 语音活动检测。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound,
    2264. 

  2264. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2265. 

  2265. 	 启用 Speex 语音活动检测。 
    2266. 

  2266. 	 
    2267. 

  2267. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Microphone:encodeQuality:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">encodeQuality</apiName><shortdesc class="- topic/shortdesc ">
    2268. 

  2268. 	 使用 Speex 编解码器时的编码语音品质。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound,
    2269. 

  2269. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2270. 

  2270. 	 使用 Speex 编解码器时的编码语音品质。可能值为从 0 到 10 的值。默认值为 6。数字越大，表示品质越高，但需要更多的带宽，如下表所示。列出的比特率值表示净比特率，并不包括信息分包开销。
    2271. 

  2271. 	 <p class="- topic/p ">
    2272. 

  2272. 	  <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">品质值</entry><entry class="- topic/entry ">所需的比特率（KB/秒）</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">0</entry><entry class="- topic/entry "> 3.95</entry></row><row class="- topic/row "><entry class="- topic/entry ">1</entry><entry class="- topic/entry ">5.75</entry></row><row class="- topic/row "><entry class="- topic/entry ">2</entry><entry class="- topic/entry ">7.75</entry></row><row class="- topic/row "><entry class="- topic/entry ">3</entry><entry class="- topic/entry ">9.80</entry></row><row class="- topic/row "><entry class="- topic/entry ">4</entry><entry class="- topic/entry ">12.8</entry></row><row class="- topic/row "><entry class="- topic/entry ">5</entry><entry class="- topic/entry ">16.8</entry></row><row class="- topic/row "><entry class="- topic/entry ">6</entry><entry class="- topic/entry ">20.6</entry></row><row class="- topic/row "><entry class="- topic/entry ">7</entry><entry class="- topic/entry ">23.8</entry></row><row class="- topic/row "><entry class="- topic/entry ">8</entry><entry class="- topic/entry ">27.8</entry></row><row class="- topic/row "><entry class="- topic/entry ">9</entry><entry class="- topic/entry ">34.2</entry></row><row class="- topic/row "><entry class="- topic/entry ">10</entry><entry class="- topic/entry ">42.2</entry></row></tbody></tgroup></adobetable>
    2273. 

  2273. 	 </p>
    2274. 

  2274. 	 
    2275. 

  2275. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/codec" class="- topic/link "><linktext class="- topic/linktext ">codec</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:enhancedOptions:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">enhancedOptions</apiName><shortdesc class="- topic/shortdesc ">	
    2276. 

  2276. 	 控制增强的麦克风选项。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.3" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.7" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.media:MicrophoneEnhancedOptions</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">	
    2277. 

  2277. 	 控制增强的麦克风选项。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> 类。对于非增强的 Microphone 实例，此属性被忽略。
    2278. 

  2278. 	 
    2279. 

  2279. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#MicrophoneEnhancedOptions" class="- topic/link "><linktext class="- topic/linktext ">flash.media.MicrophoneEnhancedOptions</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:framesPerPacket:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">framesPerPacket</apiName><shortdesc class="- topic/shortdesc ">
    2280. 

  2280. 	 在一个包（消息）中传输的 Speex 语音帧的数目。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound,
    2281. 

  2281. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2282. 

  2282. 	 在一个包（消息）中传输的 Speex 语音帧的数目。每帧长 20 ms。默认值为每个包两帧。
    2283. 

  2283. 	 
    2284. 

  2284. 	 <p class="- topic/p ">消息中包含的 Speex 帧越多，需要的带宽就越小，但发送消息延迟的时间就越长。Speex 帧越少，需要的带宽就越大，而延迟的时间就会越短。</p>
    2285. 

  2285. 	 
    2286. 

  2286. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Microphone:gain:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">gain</apiName><shortdesc class="- topic/shortdesc ">
    2287. 

  2287. 	 麦克风放大信号的程度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.gain, gain
    2288. 

  2288. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2289. 

  2289. 	 麦克风放大信号的程度。有效值为 0 到 100。默认值为 50。
    2290. 

  2290. 	 
    2291. 

  2291. 	 
    2292. 

  2292. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/gain" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.gain</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:index:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">index</apiName><shortdesc class="- topic/shortdesc ">
    2293. 

  2293. 	 麦克风的索引，它反映在 Microphone.names 返回的数组中。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.index, index
    2294. 

  2294. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2295. 

  2295. 	 麦克风的索引，它反映在 <codeph class="+ topic/ph pr-d/codeph ">Microphone.names</codeph> 返回的数组中。
    2296. 

  2296. 	 
    2297. 

  2297. 	 
    2298. 

  2298. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.getMicrophone()</linktext></link><link href="flash.media.xml#Microphone/names" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.names</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:isSupported:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isSupported</apiName><shortdesc class="- topic/shortdesc ">
    2299. 

  2299.     如果当前平台支持 Microphone 类，则 isSupported 属性设置为 true，否则设置为 false。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2300. 

  2300.     如果当前平台支持 Microphone 类，则 <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> 属性设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>，否则，设置为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。 
    2301. 

  2301.     
    2302. 

  2302.     </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Microphone:muted:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">muted</apiName><shortdesc class="- topic/shortdesc ">
    2303. 

  2303. 	 指定用户是已经拒绝对麦克风的访问 (true) 还是已经允许对麦克风的访问 (false)。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.muted, muted
    2304. 

  2304. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2305. 

  2305. 	 指定用户是已经拒绝对麦克风的访问 (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) 还是已经允许对麦克风的访问 (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>)。当该值发生变化时，将调度 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> 事件。有关详细信息，请参阅 <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph>。 
    2306. 

  2306. 	 
    2307. 

  2307. 	 
    2308. 

  2308. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.getMicrophone()</linktext></link><link href="flash.media.xml#Microphone/event:status" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.status</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:name:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">name</apiName><shortdesc class="- topic/shortdesc ">
    2309. 

  2309. 	 当前声音捕获设备的名称，它由声音捕获硬件返回。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.name, name
    2310. 

  2310. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2311. 

  2311. 	 当前声音捕获设备的名称，它由声音捕获硬件返回。
    2312. 

  2312. 	 
    2313. 

  2313. 	 
    2314. 

  2314. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.getMicrophone()</linktext></link><link href="flash.media.xml#Microphone/names" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.names</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:names:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">names</apiName><shortdesc class="- topic/shortdesc ">
    2315. 

  2315. 	 包含所有可用声音捕获设备名称的字符串数组。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.names, names
    2316. 

  2316. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Array</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2317. 

  2317. 	 包含所有可用声音捕获设备名称的字符串数组。返回名称，但不必向用户显示 Flash Player 的“专用设置”面板。此数组通过 <codeph class="+ topic/ph pr-d/codeph ">Microphone.names.length</codeph> 属性提供每个声音捕获设备的从零开始的索引和系统上声音捕获设备的数量。有关详细信息，请参阅 Array 类条目。
    2318. 

  2318. 	 
    2319. 

  2319. 	 <p class="- topic/p ">调用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.names</codeph> 要求全面检查硬件，并可能需要几秒钟时间才能生成数组。大多数情况下，使用默认麦克风即可。</p>
    2320. 

  2320. 	 
    2321. 

  2321. 	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>要确定当前麦克风的名称，请使用 <codeph class="+ topic/ph pr-d/codeph ">name</codeph> 属性。</p>
    2322. 

  2322. 	 
    2323. 

  2323. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Array" class="- topic/link "><linktext class="- topic/linktext ">Array</linktext></link><link href="flash.media.xml#Microphone/name" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.name</linktext></link><link href="flash.media.xml#Microphone/getMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.getMicrophone()</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:noiseSuppressionLevel:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">noiseSuppressionLevel</apiName><shortdesc class="- topic/shortdesc ">
    2324. 

  2324. 	 Speex 编码器使用的最大噪音衰减分贝数（负数）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound,
    2325. 

  2325. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2326. 

  2326. 	 Speex 编码器使用的最大噪音衰减分贝数（负数）。如果启用，则在从 Microphone 捕获的声音进行 Speex 压缩之前应用噪音抑制。设置为 0 以禁用噪音抑制。默认启用噪音抑制，最大衰减为 -30 dB。选择 Nellymoser 编解码器时被忽略。
    2327. 

  2327. 	 
    2328. 

  2328. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Microphone:rate:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">rate</apiName><shortdesc class="- topic/shortdesc ">
    2329. 

  2329. 	 麦克风捕获声音时使用的速率，单位是 kHz。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.rate, rate
    2330. 

  2330. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2331. 

  2331. 	 麦克风捕获声音时使用的速率，单位是 kHz。可接受的值为 5、8、11、22 和 44。如果您的声音捕获设备支持 8 kHz，则默认值为 8 kHz。否则，默认值是您的声音捕获设备支持的高于 8 kHz 的下一个可用捕获级别，通常为 11 kHz。
    2332. 

  2332. 	 
    2333. 

  2333. 	 <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>实际速率与下表中注明的 <codeph class="+ topic/ph pr-d/codeph ">rate</codeph> 值稍有不同：</p>
    2334. 

  2334. 	 
    2335. 

  2335. 	 <adobetable class="+ topic/table adobe-d/adobetable "><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">rate</codeph> 值</entry><entry class="- topic/entry ">实际频率</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">44</entry><entry class="- topic/entry ">44,100 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">22</entry><entry class="- topic/entry ">22,050 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">11</entry><entry class="- topic/entry ">11,025 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">8</entry><entry class="- topic/entry ">8,000 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">5</entry><entry class="- topic/entry ">5,512 Hz</entry></row></tbody></tgroup></adobetable>
    2336. 

  2336. 	 
    2337. 

  2337. 	 
    2338. 

  2338. 	 
    2339. 

  2339. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/rate" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.rate</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:silenceLevel:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">silenceLevel</apiName><shortdesc class="- topic/shortdesc ">
    2340. 

  2340. 	 激活麦克风并调度 activity 事件所需的音量。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.silenceLevel, silenceLevel
    2341. 

  2341. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2342. 

  2342. 	 激活麦克风并调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件所需的音量。默认值为 10。
    2343. 

  2343. 	 
    2344. 

  2344. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/gain" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.gain</linktext></link><link href="flash.media.xml#Microphone/setSilenceLevel()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.setSilenceLevel()</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:silenceTimeout:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">silenceTimeout</apiName><shortdesc class="- topic/shortdesc ">
    2345. 

  2345. 	 麦克风停止检测声音的时间和调度 activity 事件的时间之间相差的毫秒数。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.silenceTimeout, silenceTimeout
    2346. 

  2346. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2347. 

  2347. 	 麦克风停止检测声音的时间和调度 <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> 事件的时间之间相差的毫秒数。默认值为 2000（2 秒）。
    2348. 

  2348. 	 
    2349. 

  2349. 	 <p class="- topic/p ">要设置此值，请使用 <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> 方法。</p>
    2350. 

  2350. 	 
    2351. 

  2351. 	 
    2352. 

  2352. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/setSilenceLevel()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.setSilenceLevel()</linktext></link></related-links></apiValue><apiValue id="flash.media:Microphone:soundTransform:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">soundTransform</apiName><shortdesc class="- topic/shortdesc ">
    2353. 

  2353. 	 在此麦克风对象处于环回模式时，控制它的声音。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>Document this better with examples.
    2354. 

  2354. 	 </internal></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.media:SoundTransform</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2355. 

  2355. 	 在此麦克风对象处于环回模式时，控制它的声音。
    2356. 

  2356. 	 
    2357. 

  2357. 	 </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Microphone:useEchoSuppression:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">useEchoSuppression</apiName><shortdesc class="- topic/shortdesc ">
    2358. 

  2358. 	 如果启用了回音抑制，则设置为 true；否则，设置为 false。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.useEchoSuppression, useEchoSuppression
    2359. 

  2359. 	 </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2360. 

  2360. 	 如果启用了回音抑制，则设置为 <codeph class="+ topic/ph pr-d/codeph ">true</codeph>；否则，设置为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。除非用户已经在 Flash Player 的“麦克风设置”面板中选择了“降低回音”，否则默认值为 <codeph class="+ topic/ph pr-d/codeph ">false</codeph>。
    2361. 

  2361. 	 
    2362. 

  2362. 	 
    2363. 

  2363. 	 </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/setUseEchoSuppression()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.setUseEchoSuppression()</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:StageVideo" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">StageVideo</apiName><shortdesc class="- topic/shortdesc ">
    2364. 

  2364.     StageVideo 对象使用设备的硬件加速功能（如果可用）以显示应用程序中的直播视频或录制视频。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2365. 

  2365.     StageVideo 对象使用设备的硬件加速功能（如果可用）以显示应用程序中的直播视频或录制视频。大部分设备上都有硬件加速功能。StageVideo 对象支持的视频格式与 Video 对象相同。有关这些格式的详细信息，请参阅 flash.net.NetStream 类。
    2366. 

  2366.     
    2367. 

  2367.     <p class="- topic/p "><i class="+ topic/ph hi-d/i ">AIR 配置文件支持：</i>在 AIR 2.5 中，仅在运行用于电视的 AIR 的设备上支持此功能。有关在多个配置文件之间支持 API 的详细信息，请参阅 <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR 配置文件支持</xref>。   
    2368. 

  2368.     </p>
    2369. 

  2369.        
    2370. 

  2370.     <p class="- topic/p ">StageVideo 对象显示的视频始终显示在舞台的矩形区域中，在所有 Flash 显示列表对象后面。因此，StageVideo 对象利用硬件加速，同时支持显示视频的大部分情形：覆盖有视频控件的矩形显示区域。</p>   
    2371. 

  2371.     
    2372. 

  2372.     
    2373. 

  2373.     <p class="- topic/p ">使用 StageVideo 对象比使用 Video 对象更好的方面是：</p>
    2374. 

  2374.     
    2375. 

  2375.     <p class="- topic/p "><ul class="- topic/ul "><li class="- topic/li ">由于使用了硬件加速，因此优化了视频播放性能。</li><li class="- topic/li ">减少了处理器和电量的使用。</li><li class="- topic/li ">开发内容的灵活性和创造性，如视频控件，显示在 StageVideo 对象前面。</li></ul></p>
    2376. 

  2376.       
    2377. 

  2377.     <p class="- topic/p ">由于 StageVideo 对象使用设备硬件功能，因此 StageVideo 对象与 Video 对象相比受到以下约束：</p>
    2378. 

  2378.     
    2379. 

  2379.     <p class="- topic/p "><ul class="- topic/ul "><li class="- topic/li ">视频显示区域只能是矩形。您无法使用更先进的显示区域，如椭圆形或不规则形状。</li><li class="- topic/li ">不能旋转 StageVideo 对象。</li><li class="- topic/li ">不能以位图形式缓存 StageVideo 对象，</li><li class="- topic/li ">不能使用 BitmapData 访问视频数据。</li><li class="- topic/li ">不能将视频嵌入 SWF 文件。只能将 StageVideo 对象与 NetStream 对象一起使用。</li><li class="- topic/li ">不能对 StageVideo 对象应用滤镜、混合模式或 alpha 值。</li><li class="- topic/li ">不能对 StageVideo 对象应用颜色转换、3D 转换或矩阵转换。</li><li class="- topic/li ">不能对 StageVideo 对象应用遮罩或 scale9Grid。</li><li class="- topic/li ">应用于 StageVideo 对象之前的 display 对象的混合模式不会应用于 StageVideo 对象。</li><li class="- topic/li ">只能将 StageVideo 对象放置在全像素边界上。</li><li class="- topic/li ">对于每个 SWF 文件，Flash Player 将可同时显示视频的 StageVideo 对象数限制为四个。但是，根据设备硬件资源，实际的限制可能更低。在用于电视的 AIR 设备上，一次只有一个 StageVideo 对象可以显示视频。</li><li class="- topic/li ">视频计时与运行时显示的 Flash 内容的计时不同步。</li><li class="- topic/li ">尽管视频演示是给定硬件设备的最佳可用模式，但不同设备并不能实现 100%“像素相同”。像素会因驱动程序和硬件的不同而略有差异。</li><li class="- topic/li ">有几种设备不支持所有必需的颜色空间。例如，有些设备不支持 BT.709，H.264 标准。在这样的情况下，您可以使用 BT.601 进行快速显示。</li><li class="- topic/li ">您不能将舞台视频与 WMODE 设置一起使用，如 <codeph class="+ topic/ph pr-d/codeph ">normal</codeph>、<codeph class="+ topic/ph pr-d/codeph ">opaque</codeph> 或 <codeph class="+ topic/ph pr-d/codeph ">transparent</codeph>。当不处于全屏模式时，舞台视频只支持 <codeph class="+ topic/ph pr-d/codeph ">WMODE=direct</codeph>。WMODE 在 Safari 4 或更高版本、IE 9 或更高版本或用于电视的 AIR 中无效。</li></ul></p>
    2380. 

  2380.     
    2381. 

  2381.     <p class="- topic/p ">下列步骤总结了如何使用 StageVideo 对象来播放视频：</p>
    2382. 

  2382.     
    2383. 

  2383.     <p class="- topic/p "><ol class="- topic/ol "><li class="- topic/li ">侦听 StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY 事件以了解 Stage.stageVideos 矢量何时更改。（不支持 AIR 2.5 for TV。） </li><li class="- topic/li ">如果 StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY 事件报告舞台视频可用，则在事件处理函数中使用 <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> 矢量对象来访问 StageVideo 对象。在 AIR 2.5 for TV 中，呈现第一个 SWF 帧后，访问 <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph>。<b class="+ topic/ph hi-d/b ">注意：</b>您无法创建 StageVideo 对象。</li><li class="- topic/li ">使用 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.attachNetStream()</codeph> 连接 NetStream 对象。</li><li class="- topic/li ">使用 <codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> 播放视频。</li><li class="- topic/li ">侦听 StageVideo 对象上的 <codeph class="+ topic/ph pr-d/codeph ">StageVideoEvent.RENDER_STATE</codeph> 事件，以确定播放视频的状态。收到此事件还说明，视频的宽度和高度属性已初始化或更改。 </li><li class="- topic/li ">侦听 Video 对象上的 <codeph class="+ topic/ph pr-d/codeph ">VideoEvent.RENDER_STATE</codeph> 事件。此事件提供与 StageVideoEvent.RENDER_STATE 相同的状态，因此您也可以使用它来确定 GPU 加速是否可用。收到此事件还说明，视频的宽度和高度属性已初始化或更改。（不支持 AIR 2.5 for TV。）</li></ol></p>
    2384. 

  2384.     
    2385. 

  2385.     
    2386. 

  2386.     <p class="- topic/p ">如果 <codeph class="+ topic/ph pr-d/codeph ">StageVideoEvent.RENDER_STATE</codeph> 事件表明视频无法显示，您可以恢复为使用 Video 对象，而不使用 StageVideo 对象。视频附加到 NetStream 对象并播放后调度此事件。此外，根据不同的平台，播放状态中的任何更改可能导致调度此事件。处理 <codeph class="+ topic/ph pr-d/codeph ">StageVideoEvent.RENDER_STATE</codeph> 事件以确保应用程序播放视频或不播放视频。
    2387. 

  2387.     </p>
    2388. 

  2388.     
    2389. 

  2389.     <p class="- topic/p ">如果运行的视频从不支持舞台视频的 WMODE 进入全屏模式，舞台视频可以变为可用。同样，如果用户退出全屏模式，舞台视频可以变为不可用。在这些情况下，Stage.stageVideos 矢量发生更改。要收到此更改的通知，请侦听 StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABITY 事件。<b class="+ topic/ph hi-d/b ">注意：</b>在 AIR 2.5 for TV 中不提供此通知。</p>
    2390. 

  2390.     </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.events.xml#StageVideoEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.StageVideoEvent</linktext></link><link href="flash.events.xml#StageVideoAvailabilityEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.StageVideoAvailabilityEvent</linktext></link><link href="flash.events.xml#VideoEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.VideoEvent</linktext></link><link href="flash.display.xml#Stage/stageVideos" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Stage.stageVideos</linktext></link><link href="flash.media.xml#Video" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Video</linktext></link><link href="flash.net.xml#NetStream" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream</linktext></link><link href="http://www.adobe.com/go/learn_as3_stageVideo_en" class="- topic/link "><linktext class="- topic/linktext ">将 StageVideo 类用于硬件加速呈现</linktext></link></related-links><adobeApiEvent id="flash.media:StageVideo_flash.events.StageVideoEvent.RENDER_STATE_renderState" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">renderState</apiName><shortdesc class="- topic/shortdesc ">
    2391. 

  2391. 	 StageVideo 对象的呈现状态变化后，被 StageVideo 对象调度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.StageVideoEvent.RENDER_STATE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.StageVideoEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2392. 

  2392. 	 StageVideo 对象的呈现状态变化后，被 StageVideo 对象调度。
    2393. 

  2393. 	 
    2394. 

  2394. 	 </apiDesc></adobeApiEventDetail></adobeApiEvent><apiOperation id="flash.media:StageVideo:attachNetStream" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attachNetStream</apiName><shortdesc class="- topic/shortdesc ">
    2395. 

  2395.         指定要在应用程序中 StageVideo 对象的边界内显示的视频流。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">netStream</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.net:NetStream</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一个 NetStream 对象。要切断与该 StageVideo 对象的连接，请传递 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。
    2396. 

  2396.         </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2397. 

  2397.         指定要在应用程序中 StageVideo 对象的边界内显示的视频流。视频流或者是通过 NetStream.play() 播放的视频文件，或者为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>。视频文件可以存储在本地文件系统或 Flash Media Server 上。如果 <codeph class="+ topic/ph pr-d/codeph ">netStream</codeph> 参数的值为 <codeph class="+ topic/ph pr-d/codeph ">null</codeph>，则视频不会再在 StageVideo 对象中播放。
    2398. 

  2398.         
    2399. 

  2399.         
    2400. 

  2400.         <p class="- topic/p ">再次调用 <codeph class="+ topic/ph pr-d/codeph ">attachNetStream()</codeph> 之前，调用当前连接的 NetStream 对象的 <codeph class="+ topic/ph pr-d/codeph ">close()</codeph> 方法。 调用 <codeph class="+ topic/ph pr-d/codeph ">close()</codeph> 会释放所有资源，包括硬件解码器，有关播放视频方面。然后，可以调用带有另一个 NetStream 对象或 <codeph class="+ topic/ph pr-d/codeph ">null</codeph> 的 <codeph class="+ topic/ph pr-d/codeph ">attachNetStream()</codeph>。</p>
    2401. 

  2401.         
    2402. 

  2402.         <p class="- topic/p ">
    2403. 

  2403.         如果视频文件仅包含音频，您无需使用此方法；当您调用 <codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> 时，视频文件的音频部分会自动播放。 要控制与视频文件相关联的音频，请使用用于播放视频文件的 NetStream 对象的 <codeph class="+ topic/ph pr-d/codeph ">soundTransform</codeph> 属性。
    2404. 

  2404.         </p>        
    2405. 

  2405.         
    2406. 

  2406.         </apiDesc></apiOperationDetail></apiOperation><apiValue id="flash.media:StageVideo:colorSpaces:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">colorSpaces</apiName><shortdesc class="- topic/shortdesc ">
    2407. 

  2407.         返回此视频表面可用色彩空间的名称。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiType value="Vector$String" name="type" class="- topic/state reference/state apiRef/apiType "/></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2408. 

  2408.         返回此视频表面可用色彩空间的名称。通常，此列表包括“BT.601”和“BT.709”。有些配置中仅支持“BT.601”，这表示视频可能没有呈现在正确的色彩空间中。
    2409. 

  2409. 		
    2410. 

  2410. 		<p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>在用于电视的 AIR 设备上，“BT.601”值表示软件播放，“BT.709”值表示硬件播放。 </p>
    2411. 

  2411. 		
    2412. 

  2412.         </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideo:depth:set" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">depth</apiName><shortdesc class="- topic/shortdesc ">
    2413. 

  2413.         StageVideo 对象的深度级别与其他 StageVideo 对象相关。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">StageVideo 对象的深度与其他 StageVideo 对象相关。
    2414. 

  2414. 		</apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2415. 

  2415.         StageVideo 对象的深度级别与其他 StageVideo 对象相关。
    2416. 

  2416. 		
    2417. 

  2417. 		<p class="- topic/p ">StageVideo 对象始终显示在舞台上其他对象后面。如果平台支持多个 StageVideo 对象，<codeph class="+ topic/ph pr-d/codeph ">depth</codeph> 属性表示 StageVideo 对象的深度级别。底部 StageVideo 对象的 <codeph class="+ topic/ph pr-d/codeph ">depth</codeph> 属性具有最小值。如果多个 StageVideo 对象具有相同的深度设置，它们显示在 <codeph class="+ topic/ph pr-d/codeph ">stage,stageVideos</codeph> 矢量中的顺序决定了它们的相对深度。</p>	
    2418. 

  2418. 		
    2419. 

  2419.         <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b> AIR for TV 设备仅支持一个 StageVideo 对象。因此，此属性不适用于这些设备。它是将来支持其他设备的占位符。</p> 
    2420. 

  2420. 		
    2421. 

  2421.         </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Stage/stageVideos" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Stage.stageVideos</linktext></link></related-links></apiValue><apiValue id="flash.media:StageVideo:pan:set" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">pan</apiName><shortdesc class="- topic/shortdesc ">
    2422. 

  2422.         显示视频的平移设置，指定为 Point 对象。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Point</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Point 值无效。
    2423. 

  2423. 		
    2424. 

  2424. 		</apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">确定显示缩放视频的哪个矩形。
    2425. 

  2425. 		</apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2426. 

  2426.         显示视频的平移设置，指定为 Point 对象。 
    2427. 

  2427.         
    2428. 

  2428.         <p class="- topic/p ">默认情况下，<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值为 <codeph class="+ topic/ph pr-d/codeph ">(0,0)</codeph>。此默认值将视频置于 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 指定的矩形的中心。</p>
    2429. 

  2429. 		
    2430. 

  2430. 		<p class="- topic/p ">仅当 <codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> 属性值为非默认值 <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> 时，<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值很大。当视频以默认 <codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> 值显示在 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形中时，平台会调整视频大小，使其适合矩形尺寸。因此，整个视频都是可见的。然后，如果指定了缩放系数，整个视频不一定可见。在此情况下，您可以设置 <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值来指定哪个视频的子矩形显示在 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形中。</p>
    2431. 

  2431. 		
    2432. 

  2432. 		<p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 属性的有效值范围是从 <codeph class="+ topic/ph pr-d/codeph ">(-1.0, -1.0)</codeph> 到 <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph>。具体是：</p>
    2433. 

  2433. 		
    2434. 

  2434. 		<p class="- topic/p "><ul class="- topic/ul "><li class="- topic/li ">
    2435. 

  2435. 		<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值 <codeph class="+ topic/ph pr-d/codeph ">(-1.0, -1.0)</codeph> 将视频的左上角像素放置到 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形的左上角位置。
    2436. 

  2436. 		</li><li class="- topic/li ">
    2437. 

  2437. 		<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值 <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> 将视频的右下角位置放置到 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形的右下角位置。
    2438. 

  2438. 		</li><li class="- topic/li ">
    2439. 

  2439. 		<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值 <codeph class="+ topic/ph pr-d/codeph ">(1.0, -1.0)</codeph> 将视频的右上角像素放置到 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形的右上角位置。
    2440. 

  2440. 		</li><li class="- topic/li ">
    2441. 

  2441. 		<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 值 <codeph class="+ topic/ph pr-d/codeph ">(-1.0, 1.0)</codeph> 将视频的左下角像素放置到 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形的左下角位置。
    2442. 

  2442. 		</li></ul>
    2443. 

  2443. 		</p>
    2444. 

  2444. 		
    2445. 

  2445. 		<p class="- topic/p ">值 -1.0 到 1.0 之间根据比例平移。</p>
    2446. 

  2446.         
    2447. 

  2447.         <p class="- topic/p ">如果将 <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 属性设置为有效范围之外的值，将引发 <codeph class="+ topic/ph pr-d/codeph ">RangeError</codeph> 意外。运行时将值重置为上一个有效值。</p>
    2448. 

  2448.         
    2449. 

  2449.         <p class="- topic/p ">另外，考虑到要使用 StageVideo 对象，将 <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> 矢量对象的元素调度给 StageVideo 变量。设置 StageVideo 变量的 <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 属性时，底层 <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> 矢量元素也会更改。如果后来将该元素调度给另一个 StageVideo 变量以播放另一段视频，则会重置 <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 属性。</p>
    2450. 

  2450.         
    2451. 

  2451.         </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#StageVideo/zoom" class="- topic/link "><linktext class="- topic/linktext ">缩放</linktext></link></related-links></apiValue><apiValue id="flash.media:StageVideo:videoHeight:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">videoHeight</apiName><shortdesc class="- topic/shortdesc ">
    2452. 

  2452. 		一个整数，以像素为单位指定视频流的高度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
    2453. 

  2453. 		一个整数，以像素为单位指定视频流的高度。
    2454. 

  2454. 		
    2455. 

  2455. 		<p class="- topic/p ">您可能需要使用此属性，例如，为了确保用户以捕获时的相同高度观看视频，而无论 <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 矩形的大小如何。</p>		
    2456. 

  2456. 		
    2457. 

  2457.         </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideo:videoWidth:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d)                              (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">videoWidth</apiName><shortdesc class="- topic/shortdesc ">
    2458. 

  2458. 		一个整数，以像素为单位指定视频流的宽度。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueA
    2459.