PageRenderTime 65ms CodeModel.GetById 24ms RepoModel.GetById 1ms app.codeStats 1ms

/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

Large files files are truncated, but you can click here to view the full file

    

  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…
    266.

Large files files are truncated, but you can click here to view the full file