PageRenderTime 121ms CodeModel.GetById 22ms RepoModel.GetById 1ms app.codeStats 1ms

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

https://github.com/adufilie/flex-sdk
XML | 2353 lines | 1754 code | 581 blank | 18 comment | 0 complexity | 4fd751000895fc48ca3bfc828940fb5c MD5 | raw file
Possible License(s): Apache-2.0
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!--
  3. Licensed to the Apache Software Foundation (ASF) under one or more
  4. contributor license agreements. See the NOTICE file distributed with
  5. this work for additional information regarding copyright ownership.
  6. The ASF licenses this file to You under the Apache License, Version 2.0
  7. (the "License"); you may not use this file except in compliance with
  8. the License. You may obtain a copy of the License at
  9. http://www.apache.org/licenses/LICENSE-2.0
  10. Unless required by applicable law or agreed to in writing, software
  11. distributed under the License is distributed on an "AS IS" BASIS,
  12. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. See the License for the specific language governing permissions and
  14. limitations under the License.
  15. -->
  16. <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 ">
  17. La classe ID3Info contient des propriétés qui reflètent les métadonnées 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 ">
  18. La classe ID3Info contient des propriétés qui reflètent les métadonnées ID3. Vous pouvez obtenir des métadonnées supplémentaires pour les fichiers MP3 en accédant à la propriété <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> de la classe Sound, par exemple <codeph class="+ topic/ph pr-d/codeph ">mySound.id3.TIME</codeph>. Pour plus dinformations, voir lentrée <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> et les définitions des balises ID3 à ladresse <xref href="http://www.id3.org" class="- topic/xref ">http://www.id3.org</xref>.
  19. </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 ">
  20. Titre de lalbum qui correspond à la balise 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 ">
  21. Titre de lalbum qui correspond à la balise ID3 2.0 TALB.
  22. </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 ">
  23. Nom de linterprète qui correspond à la balise 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 ">
  24. Nom de linterprète qui correspond à la balise ID3 2.0 TPE1.
  25. </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 ">
  26. Commentaire sur lenregistrement qui correspond à la balise 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 ">
  27. Commentaire sur lenregistrement qui correspond à la balise ID3 2.0 COMM.
  28. </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 ">
  29. Genre du morceau qui correspond à la balise 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 ">
  30. Genre du morceau qui correspond à la balise ID3 2.0 TCON.
  31. </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 ">
  32. Titre du morceau qui correspond à la balise 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 ">
  33. Titre du morceau qui correspond à la balise ID3 2.0 TIT2.
  34. </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 ">
  35. Numéro de la piste qui correspond à la balise 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 ">
  36. Numéro de la piste qui correspond à la balise ID3 2.0 TRCK.
  37. </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 ">
  38. Année denregistrement qui correspond à la balise 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 ">
  39. Année denregistrement qui correspond à la balise ID3 2.0 TYER.
  40. </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 ">
  41. La classe MediaType énumère les types généraux déléments multimédias pouvant être renvoyés par une caméra.</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 ">
  42. La classe MediaType énumère les types généraux déléments multimédias pouvant être renvoyés par une caméra.
  43. <p class="- topic/p ">Utilisez les constantes définies dans cette classe en tant quentrée pour la méthode <codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> de la classe CameraUI. Les valeurs MediaType sont également utilisées dans la propriété <codeph class="+ topic/ph pr-d/codeph ">mediaType</codeph> de la classe MediaPromise.</p>
  44. </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 ">
  45. Une image unique.</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 ">
  46. Une image unique.
  47. </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 ">
  48. Une vidéo.</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 ">
  49. Une vidéo.
  50. </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 ">
  51. Impose un rebalayage des microphones et des caméras sur le système.</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 ">
  52. Impose un rebalayage des microphones et des caméras sur le système.
  53. </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 ">
  54. Utilisez la classe Camera pour capturer une vidéo depuis la caméra du système client.</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
  55. </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 ">
  56. Utilisez la classe Camera pour capturer une vidéo depuis la caméra du système client. Servez-vous de la classe Video pour contrôler la vidéo localement. Utilisez les classes NetConnection et NetStream pour transmettre la vidéo au Flash Media Server. Flash Media Server peut envoyer le flux vidéo à dautres serveurs et le diffuser à dautres clients exécutant Flash Player.
  57. <p class="- topic/p ">Une occurrence de Camera permet ce capturer de la vidéo au format paysage. Sur les périphériques prenant en charge le changement dorientation de lécran, tels que les téléphones portables, un objet Video joint à la caméra affiche uniquement la vidéo filmée verticalement en orientation paysage. Par conséquent, les applications mobiles doivent utiliser lorientation paysage lors de laffichage vidéo et ne doivent pivoter automatiquement.</p>
  58. <p class="- topic/p ">A partir dAIR 2.6, lautofocus est automatiquement activé sur les périphériques mobiles munis dun appareil photo à autofocus. Si lappareil photo ne prend pas en charge lautofocus continu (ce qui est le cas pour de nombreux périphériques mobiles), lappareil photo est mis au point lorsque lobjet Camera est associé à un flux vidéo et chaque fois que la méthode <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> est appelée. Sur les ordinateurs de bureau, le comportement de lautofocus dépend du pilote et des paramètres de la caméra.</p>
  59. <p class="- topic/p ">Dans le cas dune application AIR sur Android et iOS, la caméra ne capture pas les vidéos si lapplication AIR nest pas lapplication active au premier plan. Il est en outre possible que les connexions de flux soient perdues lorsque lapplication se trouve dans larrière-plan. Sur iOS, il est impossible dafficher la caméra vidéo lorsquune application utilise le mode de rendu sur GPU. Il est toutefois possible de diffuser en continu la caméra vidéo sur un serveur.</p>
  60. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Prise en charge du navigateur mobile :</b> cette classe nest pas prise en charge sur les navigateurs mobiles.</p>
  61. <p class="- topic/p "><i class="+ topic/ph hi-d/i ">Prise en charge du profil AIR :</i> cette fonctionnalité est prise en charge sur les systèmes dexploitation de bureau, mais ne lest pas sur tous les périphériques mobiles. Elle nest pas prise en charge sur les périphériques AIR pour TV. Voir <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">Prise en charge du profil AIR</xref> pour plus dinformations sur la prise en charge de lAPI dans plusieurs profils.</p>
  62. <p class="- topic/p ">Vous pouvez tester la prise en charge lors de lexécution à laide de la propriété <codeph class="+ topic/ph pr-d/codeph ">Camera.isSupported</codeph>. Notez que pour les périphériques AIR pour TV, <codeph class="+ topic/ph pr-d/codeph ">Camera.isSupported</codeph> est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, mais <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> renvoie toujours <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.</p>
  63. <p class="- topic/p ">
  64. Pour plus dinformations sur la capture audio, voir la classe Microphone.
  65. </p>
  66. <p class="- topic/p ">
  67. <b class="+ topic/ph hi-d/b ">Important : </b> Flash Player affiche une boîte de dialogue Confidentialité qui permet à lutilisateur dautoriser ou de refuser laccès à la caméra. Assurez-vous que la taille de la fenêtre de votre application soit dau moins 215 x 138 pixels, taille minimale requise par Flash pour afficher cette boîte de dialogue.
  68. </p>
  69. <p class="- topic/p ">Pour créer ou référencer un objet Camera, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph>.</p>
  70. </apiDesc><example conref="examples\CameraExample.as" class="- topic/example "> Lexemple suivant montre limage provenant dune caméra après avoir pris connaissance de lavertissement de sécurité. La scène est définie de telle sorte quil est impossible de la redimensionner, elle est alignée sur le coin supérieur gauche de la fenêtre du lecteur. Lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> est distribué au début et à la fin (si elle existe) de la session, et elle est capturée par la méthode <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> qui imprime les informations concernant lévénement.
  71. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> une caméra doit être reliée à votre ordinateur pour le bon déroulement de cet exemple.</p>
  72. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  73. package {
  74. import flash.display.Sprite;
  75. import flash.display.StageAlign;
  76. import flash.display.StageScaleMode;
  77. import flash.events.*;
  78. import flash.media.Camera;
  79. import flash.media.Video;
  80. public class CameraExample extends Sprite {
  81. private var video:Video;
  82. public function CameraExample() {
  83. stage.scaleMode = StageScaleMode.NO_SCALE;
  84. stage.align = StageAlign.TOP_LEFT;
  85. var camera:Camera = Camera.getCamera();
  86. if (camera != null) {
  87. camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
  88. video = new Video(camera.width * 2, camera.height * 2);
  89. video.attachCamera(camera);
  90. addChild(video);
  91. } else {
  92. trace("You need a camera.");
  93. }
  94. }
  95. private function activityHandler(event:ActivityEvent):void {
  96. trace("activityHandler: " + event);
  97. }
  98. }
  99. }
  100. </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 : Conversation vidéo pour Android en 30 lignes de code</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 et la caméra</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 ">
  101. Distribué lorsquune caméra publie son état.</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 ">
  102. Distribué lorsquune caméra publie son état. Avant daccéder à une caméra, Flash Player affiche une boîte de dialogue de confidentialité pour permettre aux utilisateurs dautoriser ou de refuser laccès à leur caméra. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">"Camera.Muted"</codeph>, lutilisateur a interdit au fichier SWF daccéder à sa caméra. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">"Camera.unmuted"</codeph>, lutilisateur a autorisé le fichier SWF à accéder à sa caméra.
  103. </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 ">
  104. Distribué lorsquune caméra commence ou termine une session.</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 ">
  105. Distribué lorsquune caméra commence ou termine une session. Appelez <codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> pour spécifier la quantité de mouvement requise pour déclencher un événement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> avec une valeur <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> de <codeph class="+ topic/ph pr-d/codeph ">true</codeph> ou le délai devant sécouler sans activité avant le déclenchement dun événement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> avec une valeur <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> de <codeph class="+ topic/ph pr-d/codeph ">false</codeph>.
  106. </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 ">
  107. Renvoie une référence à un objet Camera pour capturer de la vidéo.</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
  108. </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 ">Si le paramètre <codeph class="+ topic/ph pr-d/codeph ">name</codeph> nest pas spécifié, cette méthode renvoie une référence à la caméra par défaut ou, si elle est utilisée par une autre application, à la première caméra disponible (si plusieurs caméras sont installées, lutilisateur peut spécifier la caméra par défaut dans le panneau Paramètres de la caméra de Flash Player). Si aucune caméra nest disponible ou installée, la méthode renvoie <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.
  109. </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 ">Spécifie la caméra à sélectionner, telle quelle est désignée à partir du tableau renvoyé par la propriété <codeph class="+ topic/ph pr-d/codeph ">names</codeph>. Dans la plupart des cas, omettez ce paramètre pour sélectionner la caméra par défaut. Pour spécifier une valeur pour ce paramètre, utilisez la représentation de chaîne de la position dindex de base zéro dans le tableau Camera.names. Par exemple, pour désigner la troisième caméra du tableau, utilisez <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera("2")</codeph>.
  110. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  111. Renvoie une référence à un objet Camera pour capturer de la vidéo. Pour commencer la capture de la vidéo, vous devez relier lobjet Camera à un objet vidéo (voir <codeph class="+ topic/ph pr-d/codeph ">Video.attachCamera() </codeph>). Pour transmettre la vidéo à Flash Media Server, appelez <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachCamera()</codeph> pour relier lobjet Camera à un objet NetStream.
  112. <p class="- topic/p ">Plusieurs appels de la méthode <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> référencent le même pilote de caméra. Ainsi, si votre script contient du code comme <codeph class="+ topic/ph pr-d/codeph ">firstCam:Camera = getCamera()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">secondCam:Camera = getCamera()</codeph>, alors <codeph class="+ topic/ph pr-d/codeph ">firstCam</codeph> et <codeph class="+ topic/ph pr-d/codeph ">secondCam</codeph> font référence à une même caméra, qui est la caméra par défaut de lutilisateur.</p>
  113. <p class="- topic/p ">Sur les périphériques iOS munis dune caméra arrière et frontale, il est uniquement possible de capturer des vidéos à partir dune seule caméra à la fois. Sur les périphériques Android, vous pouvez accéder uniquement à la caméra arrière.</p>
  114. <p class="- topic/p ">En général, évitez de transmettre la valeur du paramètre <codeph class="+ topic/ph pr-d/codeph ">name</codeph> ; contentez-vous dutiliser <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> pour renvoyer une référence à la caméra par défaut. Lutilisateur peut spécifier la caméra par défaut devant être utilisée via le panneau Paramètres de la caméra (comme indiqué plus bas dans cette section). </p>
  115. <p class="- topic/p ">Vous ne pouvez pas utiliser ActionScript pour définir un paramètre dautorisation ou de refus pour laccès à la caméra, mais vous pouvez afficher la boîte de dialogue de configuration de la caméra des paramètres dAdobe Flash Player dans laquelle lutilisateur peut définir lautorisation de la caméra. Lorsquun fichier SWF utilisant la méthode <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> tente dassocier la caméra renvoyée par la méthode <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> à un objet Video ou NetStream, Flash Player affiche une boîte de dialogue qui permet à lutilisateur dautoriser ou de refuser laccès à la caméra (vérifiez la taille de la fenêtre de votre application qui doit être au moins de 215 x 138 pixels, taille minimale requise par Flash Player pour afficher la boîte de dialogue). Lorsque lutilisateur répond à la boîte de dialogue de configuration de la caméra, Flash Player renvoie un objet information dans lévénement <codeph class="+ topic/ph pr-d/codeph ">status</codeph> qui précise la réponse de lutilisateur : <codeph class="+ topic/ph pr-d/codeph ">Camera.muted</codeph> indique que lutilisateur a refusé laccès à une caméra ; <codeph class="+ topic/ph pr-d/codeph ">Camera.unmuted</codeph> quil en a autorisé laccès. Pour déterminer si lutilisateur a refusé ou autorisé laccès à la caméra sans traiter lévénement <codeph class="+ topic/ph pr-d/codeph ">status</codeph>, utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">muted</codeph>.</p>
  116. <p class="- topic/p ">Dans Flash Player, lutilisateur peut spécifier des paramètres de confidentialité permanents pour un domaine spécifique. Pour ce faire, il lui suffit de cliquer sur le bouton droit de la souris (Windows et Linux) ou de cliquer sur le bouton droit de la souris tout en maintenant la touche Contrôle enfoncée (Macintosh) sur un fichier SWF en cours de lecture, de sélectionner Paramètres, douvrir la boîte de dialogue Confidentialité, puis de sélectionner Mémoriser. Si lutilisateur sélectionne Mémoriser, Flash Player ne linvite plus à autoriser ou refuser laccès à votre caméra des fichiers SWF de ce domaine.</p>
  117. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> la méthode <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> ninvoque pas la boîte de dialogue permettant dautoriser ou de refuser laccès à la caméra si lutilisateur a refusé laccès en sélectionnant Mémoriser dans la boîte de dialogue Paramètres de Flash Player. Dans ce cas, vous pouvez demander à lutilisateur de modifier le paramètre dautorisation ou de refus en affichant le panneau de confidentialité de Flash Player pour lutilisateur à laide de <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings(SecurityPanel.PRIVACY)</codeph>.</p>
  118. <p class="- topic/p ">Si <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> renvoie la valeur <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, cela signifie que la caméra est utilisée par une autre application ou quaucune caméra nest installée sur le système. Pour déterminer si une caméra est installée, utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">names.length</codeph>. Pour afficher le panneau Paramètres de la caméra de Flash Player qui permet à lutilisateur de choisir la caméra à référencer par <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph>, utilisez <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings(SecurityPanel.CAMERA)</codeph>. </p>
  119. <p class="- topic/p ">Lanalyse du matériel à la recherche de caméras exige un certain temps. Lorsque le moteur dexécution détecte au moins une caméra, le matériel nest plus analysé pendant la durée de vie de loccurrence du lecteur. Cependant, si le moteur dexécution ne détecte pas de caméra, il effectue une analyse à chaque appel de <codeph class="+ topic/ph pr-d/codeph ">getCamera</codeph>. Cela est particulièrement pratique si la caméra est désactivée. Si votre fichier SWF contient un bouton Réessayer qui appelle <codeph class="+ topic/ph pr-d/codeph ">getCamera</codeph>, Flash Player peut localiser la caméra sans que lutilisateur ne soit obligé de redémarrer le fichier SWF.</p>
  120. </apiDesc><example conref="examples\Camera_getCameraExample.as" class="- topic/example "> Dans lexemple suivant, une fois que lutilisateur a autorisé laccès la caméra, la caméra associée est utilisée pour capturer des images vidéo. Les informations concernant le flux vidéo, telles que les images en cours par seconde, sont affichées également.
  121. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> renvoie une référence à un objet camera, ou renvoie null si aucune caméra nest disponible ni installée. Linstruction if vérifie si la caméra a été trouvée et si lutilisateur a autorisé laccès à la caméra. Si lutilisateur a refusé laccès, la propriété <codeph class="+ topic/ph pr-d/codeph ">muted</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>.</p>
  122. <p class="- topic/p ">Généralement, lorsque la méthode <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> est appelée, une boîte de dialogue apparaît et invite lutilisateur à autoriser ou à refuser laccès Flash Player à la caméra. Néanmoins, si lutilisateur a refusé laccès et a sélectionné loption <codeph class="+ topic/ph pr-d/codeph ">Mémoriser</codeph>, la boîte de dialogue napparaît pas et rien ne saffiche. Pour vérifier que lutilisateur a la possibilité dautoriser laccès à la caméra, le champ de texte <codeph class="+ topic/ph pr-d/codeph ">myTextField</codeph> demande à lutilisateur de cliquer sur le champ de texte afin dappeler la boîte de dialogue Paramètres de Flash Player.</p>
  123. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> appelle la méthode <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph>, qui affiche le panneau <codeph class="+ topic/ph pr-d/codeph ">PRIVACY</codeph> de la boîte de dialogue Paramètres. Si lutilisateur autorise laccès, lévénement <codeph class="+ topic/ph pr-d/codeph ">StatusEvent.STATUS</codeph> est distribué et la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> de lévénement est définie sur <codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph> (la propriété <codeph class="+ topic/ph pr-d/codeph ">mute</codeph> de lobjet de la caméra est définie sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph> également).</p>
  124. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph>, ajoutée pour écouter le changement détat du paramètre de lutilisateur, appelle la méthode <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph>, si lutilisateur autorise laccès. La méthode <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> instancie un objet video avec la hauteur et la largeur du flux capturé. Pour afficher la vidéo capturée de la caméra, la référence au flux vidéo est associée à lobjet video, et ce dernier est ajouté à la liste daffichage.</p>
  125. <p class="- topic/p ">Un objet Timer est démarré également. Chaque seconde, un événement timer de lobjet Timer est distribué et la méthode <codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> est appelée. La méthode <codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> est affichée et met à jour plusieurs propriétés de lobjet Camera. </p>
  126. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> pour cet exemple, la seule propriété qui change est la propriété <codeph class="+ topic/ph pr-d/codeph ">currentFPS</codeph>.</p>
  127. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  128. package {
  129. import flash.display.Sprite;
  130. import flash.media.Camera;
  131. import flash.media.Video;
  132. import flash.text.TextField;
  133. import flash.text.TextFieldAutoSize;
  134. import flash.utils.Timer;
  135. import flash.events.TimerEvent;
  136. import flash.events.StatusEvent;
  137. import flash.events.MouseEvent;
  138. import flash.system.SecurityPanel;
  139. import flash.system.Security;
  140. public class Camera_getCameraExample extends Sprite {
  141. private var myTextField:TextField;
  142. private var cam:Camera;
  143. private var t:Timer = new Timer(1000);
  144. public function Camera_getCameraExample() {
  145. myTextField = new TextField();
  146. myTextField.x = 10;
  147. myTextField.y = 10;
  148. myTextField.background = true;
  149. myTextField.selectable = false;
  150. myTextField.autoSize = TextFieldAutoSize.LEFT;
  151. if (Camera.isSupported)
  152. {
  153. cam = Camera.getCamera();
  154. if (!cam) {
  155. myTextField.text = "No camera is installed.";
  156. } else if (cam.muted) {
  157. myTextField.text = "To enable the use of the camera,\n"
  158. + "please click on this text field.\n"
  159. + "When the Flash Player Settings dialog appears,\n"
  160. + "make sure to select the Allow radio button\n"
  161. + "to grant access to your camera.";
  162. myTextField.addEventListener(MouseEvent.CLICK, clickHandler);
  163. }else {
  164. myTextField.text = "Connecting";
  165. connectCamera();
  166. }
  167. addChild(myTextField);
  168. t.addEventListener(TimerEvent.TIMER, timerHandler);
  169. }else {
  170. myTextField.text = "The Camera class is not supported on this device.";
  171. }
  172. }
  173. private function clickHandler(e:MouseEvent):void {
  174. Security.showSettings(SecurityPanel.PRIVACY);
  175. cam.addEventListener(StatusEvent.STATUS, statusHandler);
  176. myTextField.removeEventListener(MouseEvent.CLICK, clickHandler);
  177. }
  178. private function statusHandler(event:StatusEvent):void {
  179. if (event.code == "Camera.Unmuted") {
  180. connectCamera();
  181. cam.removeEventListener(StatusEvent.STATUS, statusHandler);
  182. }
  183. }
  184. private function connectCamera():void {
  185. var vid:Video = new Video(cam.width, cam.height);
  186. vid.x = 10;
  187. vid.y = 10;
  188. vid.attachCamera(cam);
  189. addChild(vid);
  190. t.start();
  191. }
  192. private function timerHandler(event:TimerEvent):void {
  193. myTextField.y = cam.height + 20;
  194. myTextField.text = "";
  195. myTextField.appendText("bandwidth: " + cam.bandwidth + "\n");
  196. myTextField.appendText("currentFPS: " + Math.round(cam.currentFPS) + "\n");
  197. myTextField.appendText("fps: " + cam.fps + "\n");
  198. myTextField.appendText("keyFrameInterval: " + cam.keyFrameInterval + "\n");
  199. }
  200. }
  201. }
  202. </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 ">Distribué lorsquune caméra publie son état. Avant daccéder à une caméra, Flash Player affiche une boîte de dialogue de confidentialité pour permettre aux utilisateurs dautoriser ou de refuser laccès à leur caméra. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">"Camera.muted"</codeph>, lutilisateur a interdit au fichier SWF daccéder à sa caméra. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">"Camera.unmuted"</codeph>, lutilisateur a autorisé le fichier SWF à accéder à sa caméra.
  203. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué lorsquune caméra publie son état.</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 ">
  204. Spécifie les images qui sont transmises intégralement (images-clés) sans être interpolées par lalgorithme de compression vidéo.</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 ">Valeur spécifiant les images qui sont transmises intégralement (images-clés) sans être interpolées par lalgorithme de compression vidéo. La valeur 1 signifie que chaque image est une image-clé, 3 quune image sur trois est une image-clé, etc. Les valeurs gérées sont comprises entre 1 et 48.
  205. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  206. Spécifie les images qui sont transmises intégralement (<i class="+ topic/ph hi-d/i ">keyframes</i>) sans être interpolées par lalgorithme de compression vidéo. Cette méthode ne fonctionne que si vous transmettez la vidéo via Flash Media Server.
  207. <p class="- topic/p ">Lalgorithme de compression vidéo de Flash compresse la vidéo en transmettant uniquement les éléments modifiés à partir de la dernière image de la vidéo. Ces portions sont appelées images interpolées. Les images dune vidéo peuvent être interpolées en fonction du contenu de limage précédente. Une image-clé, en revanche, est une image vidéo complète. Elle nest pas interpolée sur la base des images précédentes.</p>
  208. <p class="- topic/p ">Pour déterminer la valeur du paramètre <codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph>, tenez compte de la bande passante et de laccessibilité de la lecture vidéo. Une valeur <codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> élevée (envoi moins fréquent des images-clés), par exemple, entraîne une consommation réduite de bande passante. En revanche, le temps nécessaire au positionnement de la tête de lecture à un point donné de la vidéo est susceptible daugmenter, car il sera peut-être nécessaire dinterpoler un plus grand nombre dimages précédentes avant que la vidéo puisse reprendre.</p>
  209. <p class="- topic/p ">Inversement, une valeur <codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> faible (envoi plus fréquent des images-clés) augmente la consommation de bande passante, car des images vidéo intégrales sont transmises plus souvent, mais elle peut réduire le temps nécessaire à la localisation dune image spécifique dans une vidéo enregistrée.</p>
  210. </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 ">
  211. Indique sil est nécessaire dutiliser un flux vidéo compressé pour un visionnage local des données reçues par la caméra.</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 ">Indique sil est nécessaire dutiliser un flux vidéo compressé (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) ou non (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>) pour un visionnage local des données reçues par la caméra.
  212. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  213. Indique sil est nécessaire dutiliser un flux vidéo compressé pour un visionnage local des données reçues par la caméra. Cette méthode nest applicable que si vous transmettez du contenu vidéo à laide de Flash Media Server. Le réglage de <codeph class="+ topic/ph pr-d/codeph ">compress</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> vous permet de déterminer plus précisément la façon dont la vidéo se présentera lorsque les utilisateurs la visionneront en temps réel.
  214. <p class="- topic/p ">Bien quun flux compressé soit utile à des fins de test, par exemple pour se faire une idée des paramètres de qualité vidéo, les coûts de traitement quil entraîne sont élevés car il implique plus quune simple compression. Le contenu vidéo est compressé, édité à des fins de transmission comme sur une connexion en direct, puis décompressé pour un visionnage local.</p>
  215. <p class="- topic/p ">Pour définir le taux de compression utilisé lorsque vous réglez <codeph class="+ topic/ph pr-d/codeph ">compress</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, servez-vous de <codeph class="+ topic/ph pr-d/codeph ">Camera.setQuality()</codeph>.</p>
  216. </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 ">
  217. Définit le mode de capture de la caméra sur le mode natif qui remplit le mieux les conditions requises.</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
  218. </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 ">Largeur de capture demandée, en pixels. La valeur par défaut est 160.
  219. </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 ">Hauteur de capture demandée, en pixels. La valeur par défaut est 120.
  220. </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 ">Cadence à laquelle la caméra doit capturer des données, en images par seconde. La valeur par défaut est 15.
  221. </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 ">Indique comment manipuler la largeur, la hauteur et la cadence si la caméra nest pas dotée dun mode natif qui remplit les conditions requises. La valeur par défaut est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, ce qui signifie que le maintien de la taille de capture est favorisé ; lutilisation de ce paramètre permet de sélectionner le mode qui correspond le mieux aux valeurs <codeph class="+ topic/ph pr-d/codeph ">width</codeph> et <codeph class="+ topic/ph pr-d/codeph ">height</codeph>, même si cela affecte les performances en réduisant la cadence. Pour optimiser la cadence au détriment de la hauteur et de la largeur de la caméra, définissez le paramètre <codeph class="+ topic/ph pr-d/codeph ">false</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">favorArea</codeph>.
  222. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  223. Définit le mode de capture de la caméra sur le mode natif qui remplit le mieux les conditions requises. Si la caméra ne dispose pas dun mode natif correspondant à tous les paramètres que vous transmettez, Flash Player sélectionne un mode de capture qui synthétise le mieux le mode demandé. Cette manipulation peut nécessiter le découpage de limage et lomission dimages.
  224. <p class="- topic/p ">Par défaut, Flash Player omet des images si nécessaire pour conserver la taille de limage. Pour réduire le nombre dimages omises, même si cela passe par une réduction de la taille de limage, définissez le paramètre <codeph class="+ topic/ph pr-d/codeph ">favorArea</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph>.</p>
  225. <p class="- topic/p ">Lorsquil choisit un mode natif, Flash Player tente de conserver le format demandé dans la mesure du possible. Par exemple, si vous publiez la commande <codeph class="+ topic/ph pr-d/codeph ">myCam.setMode(400, 400, 30)</codeph> et que les valeurs de largeur et de hauteur maximales disponibles sur la caméra sont 320 et 288, Flash Player définit la largeur et la hauteur sur 288. Ce faisant, Flash Player conserve le format 1/1 que vous avez demandé.</p>
  226. <p class="- topic/p ">Pour déterminer les valeurs affectées à ces propriétés une fois la sélection, par Flash Player, du mode qui correspond le mieux aux valeurs que vous avez demandées, utilisez les propriétés <codeph class="+ topic/ph pr-d/codeph ">width</codeph>, <codeph class="+ topic/ph pr-d/codeph ">height</codeph> et <codeph class="+ topic/ph pr-d/codeph ">fps</codeph>.</p>
  227. <p class="- topic/p ">
  228. Si vous utilisez Flash Media Server, vous pouvez également capturer des images uniques ou créer une séquence en accéléré. Pour plus dinformations, voir la méthode <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachCamera()</codeph>.
  229. </p>
  230. </apiDesc><example conref="examples\Camera_setModeExample.as" class="- topic/example "> Dans lexemple suivant, lorsquun utilisateur clique sur la Scène, la vidéo est redimensionnée et le taux de capture des images par seconde est défini sur une nouvelle valeur.
  231. <p class="- topic/p ">La Scène est définie de façon à ne pas être redimensionnée. La méthode <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> renvoie une référence à un objet camera, ou renvoie null si aucune caméra nest disponible ni installée. Si une caméra existe, la méthode <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> est appelée. La méthode <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> instancie un objet video. Pour afficher la vidéo capturée de la caméra, la référence au flux vidéo est associée à lobjet video, et ce dernier est ajouté à la liste daffichage. Un écouteur dévénement est défini également pour un événement <codeph class="+ topic/ph pr-d/codeph ">MouseEvent.CLICK</codeph>. Une fois que lutilisateur a cliqué sur la Scène, la méthode <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> est invoquée. La méthode vérifie la largeur de la vidéo capturée et définit la largeur, la hauteur, et le taux demandé dimages par seconde du mode de capture de la caméra. Lobjet video doit être supprimé et recréé pour que ces paramètres soient appliqués. La hauteur et la largeur de la vidéo doivent également être définies sur la hauteur et la largeur de lobjet de la caméra.</p>
  232. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  233. package {
  234. import flash.display.Sprite;
  235. import flash.media.Camera;
  236. import flash.media.Video;
  237. import flash.events.MouseEvent;
  238. import flash.display.StageScaleMode;
  239. public class Camera_setModeExample extends Sprite {
  240. private var cam:Camera;
  241. private var vid:Video;
  242. public function Camera_setModeExample() {
  243. stage.scaleMode = StageScaleMode.NO_SCALE;
  244. cam = Camera.getCamera();
  245. if (!cam) {
  246. trace("No camera is installed.");
  247. }else {
  248. connectCamera();
  249. }
  250. }
  251. private function connectCamera():void {
  252. vid = new Video();
  253. vid.width = cam.width;
  254. vid.height = cam.height;
  255. vid.attachCamera(cam);
  256. addChild(vid);
  257. stage.addEventListener(MouseEvent.CLICK, clickHandler);
  258. }
  259. private function clickHandler(e:MouseEvent):void {
  260. switch (cam.width) {
  261. case 160:
  262. cam.setMode(320, 240, 10);
  263. break;
  264. case 320:
  265. cam.setMode(640, 480, 5);
  266. break;
  267. default:
  268. cam.setMode(160, 120, 15);
  269. break;
  270. }
  271. removeChild(vid);
  272. connectCamera();
  273. }
  274. }
  275. }
  276. </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/fps" class="- topic/link "><linktext class="- topic/linktext ">i/s</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 ">largeur</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 ">
  277. Spécifie la quantité (intensité) de mouvement requise pour distribuer lévénement 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
  278. </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 ">Spécifie la quantité (intensité) de mouvement requise pour distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. Les valeurs gérées sont comprises entre 0 et 100. La valeur par défaut est 50.
  279. </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 ">Indique le nombre de millisecondes qui doit sécouler sans activité avant que Flash Player ne considère que lactivité a cessé et distribue lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. La valeur par défaut est 2 000 millisecondes (2 secondes).
  280. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  281. Spécifie la quantité de mouvement requise pour distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. Peut éventuellement définir le nombre de millisecondes qui doit sécouler sans activité avant que Flash Player ne considère que le mouvement a cessé et distribue lévénement.
  282. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque : </b>la vidéo peut être affichée quelle que soit la valeur du paramètre <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph>. Ce paramètre détermine uniquement à quel moment et dans quelles circonstances lévénement est distribué, pas si du contenu vidéo est capturé ou affiché.</p>
  283. <p class="- topic/p ">
  284. Pour empêcher la caméra de détecter le mouvement, attribuez la valeur 100 au paramètre <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph>. Dans ce cas, lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> nest jamais distribué (vous utiliserez probablement cette valeur à des fins de tests uniquement, par exemple pour désactiver temporairement des gestionnaires qui seraient normalement déclenchés par la distribution de lévénement).
  285. </p>
  286. <p class="- topic/p ">
  287. Pour déterminer la quantité de mouvement actuellement détectée par la caméra, utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">activityLevel</codeph>. Les valeurs de sensibilité de mouvement correspondent directement aux valeurs dactivité. La valeur dactivité 0 est associée à labsence totale de mouvement. La valeur dactivité 100 est associée au mouvement constant. Lorsque vous êtes immobile, votre valeur dactivité est inférieure à votre valeur de sensibilité de mouvement. Inversement, lorsque vous vous déplacez, vos valeurs dactivité sont fréquemment supérieures à votre valeur de sensibilité de mouvement.
  288. </p>
  289. <p class="- topic/p ">
  290. Lobjectif de cette méthode est similaire à celui de <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph>. Les deux méthodes sont utilisées pour spécifier à quel moment il convient de distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. Toutefois, leur impact sur la publication des flux diffère de manière significative :
  291. </p>
  292. <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> est conçu pour optimiser la bande passante. Lorsquun flux audio est considéré comme étant silencieux, aucune donnée audio nest envoyée. En revanche, un message unique indiquant le début du silence est envoyé. </li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> est conçu pour détecter le mouvement et na aucune incidence sur lutilisation de la bande passante. La vidéo est envoyée peu importe quun flux vidéo détecte du mouvement ou non.</li></ul>
  293. </apiDesc><example conref="examples\Camera_setMotionLevelExample.as" class="- topic/example "> Dans lexemple suivant, la caméra de lutilisateur est utilisée comme moniteur ou caméra de surveillance. La caméra détecte le mouvement et un champ de texte affiche le niveau dactivité (lexemple peut être étendu pour émettre une alarme ou envoyer un message via un service Web à dautres applications).
  294. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> renvoie une référence à un objet camera, ou renvoie null si aucune caméra nest disponible ni installée. Linstruction if vérifie si une caméra est disponible, et appelle la méthode <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> lorsquelle est disponible. La méthode <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> instancie un objet video avec la hauteur et la largeur du flux capturé. Pour afficher la vidéo capturée de la caméra, la référence au flux vidéo est associée à lobjet video, et ce dernier est ajouté à la liste daffichage. Généralement, lorsque la méthode <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> est appelée, une boîte de dialogue apparaît et invite lutilisateur à autoriser ou à refuser laccès Flash Player à la caméra. Néanmoins, si lutilisateur a refusé laccès et a sélectionné loption <codeph class="+ topic/ph pr-d/codeph ">Mémoriser</codeph>, la boîte de dialogue napparaît pas et rien nest affiché. Pour vérifier que lutilisateur a la possibilité dautoriser laccès à la caméra, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">system.Security.showSettings()</codeph> pour appeler la boîte de dialogue Paramètres de Flash Player.</p>
  295. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph> définit le niveau dactivité (quantité de mouvement) avant que lévénement activity soit appelé, sur cinq, pour un mouvement minimal. Le délai qui sécoule entre le moment la caméra arrête de détecter le mouvement et le moment lévénement activity est appelé, est défini sur 1 seconde (1 000 millisecondes). Après 1 seconde dinactivité ou si le niveau dactivité atteint cinq, lévénement <codeph class="+ topic/ph pr-d/codeph ">ActivityEvent.ACTIVITY</codeph> est distribué et la méthode <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> est invoquée. Si lévénement a été déclenché par le niveau dactivité, la propriété <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> et un objet Timer est démarré. Chaque seconde, un événement timer de lobjet Timer est distribué et la méthode <codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> est invoquée, ce qui affiche le niveau dactivité en cours (même si un niveau de cinq ou supérieur déclenche la minuterie, le niveau dactivité en cours affiché peut être une valeur inférieure).</p>
  296. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  297. package {
  298. import flash.display.Sprite;
  299. import flash.media.Camera;
  300. import flash.media.Video;
  301. import flash.text.TextField;
  302. import flash.text.TextFieldAutoSize;
  303. import flash.utils.Timer;
  304. import flash.events.TimerEvent;
  305. import flash.events.ActivityEvent;
  306. public class Camera_setMotionLevelExample extends Sprite {
  307. private var myTextField:TextField;
  308. private var cam:Camera;
  309. private var t:Timer = new Timer(1000);
  310. public function Camera_setMotionLevelExample() {
  311. myTextField = new TextField();
  312. myTextField.background = true;
  313. myTextField.selectable = false;
  314. myTextField.autoSize = TextFieldAutoSize.LEFT;
  315. cam = Camera.getCamera();
  316. if (!cam) {
  317. myTextField.text = "No camera is installed.";
  318. }else {
  319. myTextField.text = "Waiting to connect.";
  320. connectCamera();
  321. }
  322. addChild(myTextField);
  323. t.addEventListener(TimerEvent.TIMER, timerHandler);
  324. }
  325. private function connectCamera():void {
  326. var vid:Video = new Video(cam.width, cam.height);
  327. vid.x = 10;
  328. vid.y = 10;
  329. vid.attachCamera(cam);
  330. addChild(vid);
  331. cam.setMotionLevel(5, 1000);
  332. cam.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
  333. }
  334. private function activityHandler(e:ActivityEvent):void {
  335. if (e.activating == true) {
  336. t.start();
  337. } else {
  338. myTextField.text = "Everything is quiet.";
  339. t.stop();
  340. }
  341. }
  342. private function timerHandler(event:TimerEvent):void {
  343. myTextField.x = 10;
  344. myTextField.y = cam.height + 20;
  345. myTextField.text = "There is some activity. Level: " + cam.activityLevel;
  346. }
  347. }
  348. }
  349. </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 ">
  350. Définit la quantité maximale de bande passante par seconde ou la qualité dimage requise pour les données vidéo sortantes actuelles.</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
  351. </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 ">Spécifie la quantité maximale de bande passante pouvant être utilisée par la vidéo sortante actuelle, en octets par seconde. Pour spécifier que la vidéo Flash Player peut utiliser autant de bande passante que nécessaire pour conserver la valeur de <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>, attribuez la valeur 0 à <codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph>. La valeur par défaut est 16384.
  352. </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 ">Entier spécifiant le niveau de qualité dimage requis, tel que déterminé par le taux de compression appliqué à chaque image vidéo. Les valeurs acceptables sont comprises entre 1 (qualité la plus médiocre, compression maximale) et 100 (qualité optimale, pas de compression). Pour spécifier que la qualité dimage peut varier autant que nécessaire afin déviter un dépassement de la bande passante disponible, attribuez la valeur 0 à <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>.
  353. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  354. Définit la quantité maximale de bande passante par seconde ou la qualité dimage requise pour les données vidéo sortantes actuelles. Cette méthode ne peut généralement être appliquée que si vous transmettez la vidéo via Flash Media Server.
  355. <p class="- topic/p ">Utilisez-la pour spécifier lélément de la vidéo sortante le plus important pour votre application, la bande passante ou la qualité de limage.</p>
  356. <ul class="- topic/ul "><li class="- topic/li ">Pour indiquer que la bande passante est prioritaire, attribuez une valeur à <codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> et la valeur 0 à <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>. Flash Player transmet une vidéo de qualité optimale dans la bande passante spécifiée. Si nécessaire, Flash Player réduit la qualité de limage afin déviter de dépasser la bande passante spécifiée. En général, plus le mouvement augmente, plus la qualité diminue.</li><li class="- topic/li ">Pour indiquer que la qualité est prioritaire, transmettez la valeur 0 à <codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> et une valeur numérique à <codeph class="+ topic/ph pr-d/codeph ">quality</codeph>. Flash Player utilise autant de bande passante que nécessaire pour conserver la qualité spécifiée. Si nécessaire, Flash Player réduit la fréquence pour conserver la qualité de limage. En général, plus le mouvement augmente, plus la consommation de bande passante augmente également.</li><li class="- topic/li ">Pour spécifier que la bande passante et la qualité sont aussi importantes lune que lautre, transmettez des valeurs numériques aux deux paramètres. Flash Player transmet alors de la vidéo permettant de respecter la qualité requise et ne dépassant pas la bande passante spécifiée. Si nécessaire, Flash Player réduit la fréquence pour conserver la qualité de limage sans dépasser la bande passante spécifiée.</li></ul>
  357. </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 ">
  358. Quantité de mouvement détecté par la caméra.</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
  359. </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 ">
  360. Quantité de mouvement détecté par la caméra. Les valeurs gérées sont comprises entre 0 (aucun mouvement nest détecté) et 100 (une grande quantité de mouvement est détectée). La valeur de cette propriété peut vous aider à déterminer sil est nécessaire de transmettre un paramètre à la méthode <codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph>.
  361. <p class="- topic/p ">Si la caméra est disponible mais quelle nest pas encore utilisée parce que la méthode <codeph class="+ topic/ph pr-d/codeph ">Video.attachCamera()</codeph> na pas été appelée, cette propriété est définie sur -1.</p>
  362. <p class="- topic/p ">Si vous diffusez en continu de la vidéo non compressée en local seulement, cette propriété nest définie que si vous avez affecté une fonction au gestionnaire dévénement. Dans le cas contraire, elle nest pas définie.</p>
  363. </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 ">
  364. Quantité maximale de bande passante pouvant être utilisée par la source vidéo sortante actuelle, en octets.</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
  365. </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 ">
  366. Quantité maximale de bande passante pouvant être utilisée par la source vidéo sortante actuelle, en octets. Une valeur de 0 signifie que la source peut utiliser autant de bande passante que nécessaire pour conserver la qualité dimage voulue.
  367. <p class="- topic/p ">Pour définir cette propriété, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">setQuality()</codeph>.</p>
  368. </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 ">
  369. Cadence à laquelle la caméra capture des données, en images par seconde.</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
  370. </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 ">
  371. Cadence à laquelle la caméra capture des données, en images par seconde. Cette propriété ne peut pas être définie ; toutefois, vous pouvez utiliser la méthode <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> pour définir une propriété connexe, <codeph class="+ topic/ph pr-d/codeph ">fps</codeph>, qui spécifie la cadence maximale à laquelle vous souhaitez que la caméra capture les données.
  372. </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 ">
  373. Fréquence maximale à laquelle la caméra peut capturer des données, en images par seconde.</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
  374. </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 ">
  375. Fréquence maximale à laquelle la caméra peut capturer des données, en images par seconde. La fréquence maximale possible dépend des capacités de la caméra ; cette fréquence peut ne pas être atteinte.
  376. <ul class="- topic/ul "><li class="- topic/li ">Pour définir une valeur souhaitée pour cette propriété, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph>.</li><li class="- topic/li ">Pour déterminer la cadence à laquelle la caméra capture actuellement les données, utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">currentFPS</codeph>.</li></ul>
  377. </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 ">
  378. Hauteur de capture actuelle, en pixels.</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
  379. </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 ">
  380. Hauteur de capture actuelle, en pixels. Pour définir une valeur à cette propriété, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph>.
  381. </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/width" class="- topic/link "><linktext class="- topic/linktext ">largeur</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 ">
  382. Entier (commençant à zéro) qui spécifie lindex de la caméra, tel quindiqué dans le tableau renvoyé par la propriété 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
  383. </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 ">
  384. Entier (commençant à zéro) qui spécifie lindex de la caméra, tel quindiqué dans le tableau renvoyé par la propriété <codeph class="+ topic/ph pr-d/codeph ">names</codeph>.
  385. </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 ">
  386. La propriété isSupported est définie sur true si la classe Camera est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur 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 ">
  387. La propriété <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> si la classe Camera est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph>.
  388. </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 ">
  389. Nombre dimages (appelées images-clés) qui sont transmises intégralement sans être interpolées par lalgorithme de compression vidéo.</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 ">
  390. Nombre dimages vidéos (appelées <i class="+ topic/ph hi-d/i ">images-clés</i>) transmises intégralement sans être interpolées par lalgorithme de compression vidéo. La valeur par défaut, 15, indique que chaque quinzième image est une image-clé. Une valeur de 1 signifie que chaque image est une image-clé. Les valeurs autorisées vont de 1 à 48.
  391. </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 ">
  392. Indique si les données capturées par la caméra et visionnées localement sont compressées et décompressées (true), comme elles le seraient pour une transmission en directe par le biais de Flash Media Server, ou non compressées (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 ">
  393. Indique si les données capturées par la caméra et visionnées localement sont compressées et décompressées (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>), comme elles le seraient pour une transmission en directe par le biais de Flash Media Server, ou non compressées (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>). La valeur par défaut est <codeph class="+ topic/ph pr-d/codeph ">false</codeph>.
  394. <p class="- topic/p ">
  395. Le flux compressé est utile pour les tests, par exemple pour obtenir un aperçu des paramètres de qualité vidéo, mais son coût de traitement est important. Laffichage local est compressé, modifié pour être transmis comme il le serait sur une connexion directe, puis décompressé pour laffichage local.
  396. </p>
  397. <p class="- topic/p ">Pour définir cette valeur, utilisez <codeph class="+ topic/ph pr-d/codeph ">Camera.setLoopback()</codeph>. Pour définir le taux de compression utilisé lorsque vous réglez cette propriété sur true, utilisez <codeph class="+ topic/ph pr-d/codeph ">Camera.setQuality()</codeph>.</p>
  398. </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 ">
  399. Quantité de mouvement requis pour invoquer lévénement 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
  400. </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 ">
  401. Quantité de mouvement requis pour invoquer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. Les valeurs gérées sont comprises entre 0 et 100. La valeur par défaut est 50.
  402. <p class="- topic/p ">La vidéo peut être affichée quelle que soit la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph>. Pour plus dinformations, voir lentrée <codeph class="+ topic/ph pr-d/codeph "> setMotionLevel()</codeph>.</p>
  403. </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 ">
  404. Nombre de millisecondes qui sécoule entre le moment la caméra arrête la détection du mouvement et le moment lévénement activity est appelé.</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
  405. </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 ">
  406. Nombre de millisecondes qui sécoule entre le moment la caméra arrête la détection du mouvement et le moment lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> est appelé. La valeur par défaut est 2 000 (2 secondes).
  407. <p class="- topic/p ">Pour définir cette valeur, utilisez <codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph>. </p>
  408. </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 ">
  409. Valeur booléenne qui indique si lutilisateur a refusé (true) ou autorisé (false) laccès à la caméra dans la boîte de dialogue de confidentialité de 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.muted, muted
  410. </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 ">
  411. Valeur booléenne qui indique si lutilisateur a refusé (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) ou autorisé (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>) laccès à la caméra dans la boîte de dialogue de confidentialité de Flash Player. Lorsque cette valeur change, lévénement <codeph class="+ topic/ph pr-d/codeph ">status</codeph> est distribué.
  412. </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 ">
  413. Nom de la caméra en cours, tel que renvoyé par le matériel de la caméra.</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
  414. </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 ">
  415. Nom de la caméra en cours, tel que renvoyé par le matériel de la caméra.
  416. </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 ">
  417. Tableau de chaînes qui indique les noms de toutes les caméras disponibles sans afficher la boîte de dialogue de confidentialité de 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
  418. </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 ">
  419. Tableau de chaînes qui indique les noms de toutes les caméras disponibles sans afficher la boîte de dialogue de confidentialité de Flash Player. Ce tableau se comporte de la même manière que tout autre tableau ActionScript : il fournit de façon implicite lindex, commençant à zéro, de chaque caméra et le nombre de caméras présentes sur le système (via <codeph class="+ topic/ph pr-d/codeph ">names.length</codeph>). Pour plus dinformations, voir lentrée <codeph class="+ topic/ph pr-d/codeph ">names</codeph> dans la section consacrée à la classe Array.
  420. <p class="- topic/p ">Lappel de la propriété <codeph class="+ topic/ph pr-d/codeph ">names</codeph> implique un examen minutieux du matériel. Dans la plupart des cas, vous pouvez utiliser la caméra par défaut.</p>
  421. <p class="- topic/p ">Sur Android, seule un caméra est prise en charge, même si le périphérique en possède plusieurs. Le nom de la caméra est toujours "Default".</p>
  422. </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 ">
  423. Niveau de qualité dimage requis, tel que déterminé par le taux de compression appliqué à chaque image vidéo.</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
  424. </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 ">
  425. Niveau de qualité dimage requis, tel que déterminé par le taux de compression appliqué à chaque image vidéo. Les valeurs de qualité acceptables sont comprises entre 1 (qualité la plus médiocre, compression maximale) et 100 (qualité optimale, pas de compression). La valeur par défaut est 0, ce qui signifie que la qualité de limage peut varier si nécessaire pour éviter de dépasser la bande passante disponible.
  426. <p class="- topic/p ">Pour définir cette propriété, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">setQuality()</codeph>.</p>
  427. </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 ">
  428. Largeur de capture actuelle, en pixels.</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
  429. </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 ">
  430. Largeur de capture actuelle, en pixels. Pour définir une valeur souhaitée pour cette propriété, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph>.
  431. </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 ">
  432. La classe SoundTransform contient des propriétés relatives au volume et à la balance horizontale.</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>
  433. </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 ">
  434. La classe SoundTransform contient des propriétés relatives au volume et à la balance horizontale.
  435. </apiDesc><example conref="examples\SoundTransformExample.as" class="- topic/example "> Lexemple suivant charge et lit un fichier MP3. Pendant la lecture du fichier MP3, déplacez la souris ou un autre périphérique de saisie utilisateur ; le volume et la balance changent à mesure que vous déplacez le périphérique de saisie utilisateur sur la scène. Pour exécuter lexemple, placez un fichier intitulé MySound.mp3 dans le même répertoire que votre fichier SWF.
  436. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  437. package {
  438. import flash.display.Sprite;
  439. import flash.display.StageAlign;
  440. import flash.display.StageScaleMode;
  441. import flash.events.*;
  442. import flash.media.Sound;
  443. import flash.media.SoundChannel;
  444. import flash.media.SoundTransform;
  445. import flash.net.URLRequest;
  446. import flash.utils.Timer;
  447. public class SoundTransformExample extends Sprite {
  448. private var url:String = "MySound.mp3";
  449. private var soundFactory:Sound;
  450. private var channel:SoundChannel;
  451. private var positionTimer:Timer;
  452. public function SoundTransformExample() {
  453. stage.align = StageAlign.TOP_LEFT;
  454. stage.scaleMode = StageScaleMode.NO_SCALE;
  455. var request:URLRequest = new URLRequest(url);
  456. soundFactory = new Sound();
  457. soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
  458. soundFactory.load(request);
  459. channel = soundFactory.play();
  460. stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
  461. }
  462. private function ioErrorHandler(event:Event):void {
  463. trace("ioErrorHandler: " + event);
  464. }
  465. private function setPan(pan:Number):void {
  466. trace("setPan: " + pan.toFixed(2));
  467. var transform:SoundTransform = channel.soundTransform;
  468. transform.pan = pan;
  469. channel.soundTransform = transform;
  470. }
  471. private function setVolume(volume:Number):void {
  472. trace("setVolume: " + volume.toFixed(2));
  473. var transform:SoundTransform = channel.soundTransform;
  474. transform.volume = volume;
  475. channel.soundTransform = transform;
  476. }
  477. private function mouseMoveHandler(event:MouseEvent):void {
  478. var halfStage:uint = Math.floor(stage.stageWidth / 2);
  479. var xPos:uint = event.stageX;
  480. var yPos:uint = event.stageY;
  481. var value:Number;
  482. var pan:Number;
  483. if (xPos > halfStage) {
  484. value = xPos / halfStage;
  485. pan = value - 1;
  486. } else if (xPos &lt; halfStage) {
  487. value = (xPos - halfStage) / halfStage;
  488. pan = value;
  489. } else {
  490. pan = 0;
  491. }
  492. var volume:Number = 1 - (yPos / stage.stageHeight);
  493. setVolume(volume);
  494. setPan(pan);
  495. }
  496. }
  497. }
  498. </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 ">
  499. Crée un objet 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>
  500. </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 ">Volume, compris entre 0 (muet) et 1 (volume maximal).
  501. </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 ">Balance horizontale du son, comprise entre -1 (balance à gauche) et 1 (balance à droite). La valeur 0 correspond à une balance équilibrée (centre).
  502. </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  503. Crée un objet SoundTransform.
  504. </apiDesc><example conref="examples\SoundTransform_constructorExample.as" class="- topic/example "> Dans lexemple suivant, le fichier audio nest lu quà partir du canal droit, et le volume est défini sur 50 pour-cent.
  505. <p class="- topic/p ">Dans le constructeur, le son est chargé et affecté à un canal audio (<codeph class="+ topic/ph pr-d/codeph ">channel</codeph>). Un objet SoundTranform (<codeph class="+ topic/ph pr-d/codeph ">transform</codeph>) est également créé. Son premier argument définit le volume sur 50 pour-cent (la plage va de 0.0 à 1.0). Son second argument définit la balance. Dans cet exemple, la balance est définie sur 1.0, ce qui signifie que le son provient du haut-parleur droit uniquement. Pour que ces réglages prennent effet, lobjet SoundTranform <codeph class="+ topic/ph pr-d/codeph ">transform</codeph> est attribué à la propriété <codeph class="+ topic/ph pr-d/codeph ">souundTransform</codeph> du canal audio.</p>
  506. <p class="- topic/p "> <b class="+ topic/ph hi-d/b ">Remarque :</b> la gestion derreur écrite pour cet exemple est limitée.</p>
  507. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  508. package {
  509. import flash.display.Sprite;
  510. import flash.net.URLRequest;
  511. import flash.media.Sound;
  512. import flash.media.SoundChannel;
  513. import flash.media.SoundTransform;
  514. import flash.events.IOErrorEvent;
  515. public class SoundTransform_constructorExample extends Sprite
  516. {
  517. public function SoundTransform_constructorExample() {
  518. var mySound:Sound = new Sound();
  519. var url:URLRequest = new URLRequest("mySound.mp3");
  520. var channel:SoundChannel;
  521. var transform:SoundTransform = new SoundTransform(0.5, 1.0);
  522. mySound.load(url);
  523. channel = mySound.play();
  524. channel.soundTransform = transform;
  525. mySound.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
  526. }
  527. private function errorHandler(errorEvent:IOErrorEvent):void {
  528. trace("The sound could not be loaded: " + errorEvent.text);
  529. }
  530. }
  531. }
  532. </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 ">
  533. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée gauche à émettre dans le haut-parleur gauche.</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>
  534. </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 ">
  535. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée gauche à émettre dans le haut-parleur gauche.
  536. </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 ">
  537. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée gauche à émettre dans le haut-parleur droit.</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>
  538. </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 ">
  539. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée gauche à émettre dans le haut-parleur droit.
  540. </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 ">
  541. Balance horizontale du son, comprise entre -1 (balance à gauche) et 1 (balance à droite).</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>
  542. </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 ">
  543. Balance horizontale du son, comprise entre -1 (balance à gauche) et 1 (balance à droite). La valeur 0 correspond à une balance équilibrée (centre).
  544. </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 ">
  545. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée droite à émettre dans le haut-parleur gauche.</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>
  546. </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 ">
  547. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée droite à émettre dans le haut-parleur gauche.
  548. </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 ">
  549. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée droite à émettre dans le haut-parleur droit.</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>
  550. </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 ">
  551. Valeur, comprise entre 0 (aucun) et 1 (maximum), indiquant la quantité dentrée droite à émettre dans le haut-parleur droit.
  552. </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 ">
  553. Volume, compris entre 0 (muet) et 1 (volume maximal).</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>
  554. </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 ">
  555. Volume, compris entre 0 (muet) et 1 (volume maximal).
  556. </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 ">
  557. Cette classe définit une énumération qui indique si la vidéo sur la scène est actuellement disponible.</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 ">Enumération qui indique si la vidéo sur la scène est actuellement disponible.
  558. </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  559. Cette classe définit une énumération qui indique si la vidéo sur la scène est actuellement disponible.
  560. </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 ">
  561. La vidéo sur la scène est actuellement disponible.</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 ">La vidéo sur la scène est actuellement disponible.
  562. </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  563. La vidéo sur la scène est actuellement disponible.
  564. </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 ">
  565. La vidéo sur la scène nest actuellement pas disponible.</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 ">La vidéo sur la scène nest actuellement pas disponible.
  566. </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  567. La vidéo sur la scène nest actuellement pas disponible.
  568. </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 ">
  569. La classe StageWebView affiche le contenu HTML dans une fenêtre daffichage de la scène.</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 ">
  570. La classe StageWebView affiche le contenu HTML dans une fenêtre daffichage de la scène.
  571. <p class="- topic/p ">La classe StageWebView fournit un moyen simple pour afficher du contenu HTML sur les périphériques qui ne prennent pas en charge la classe HTMLLoader. Cette classe ne fournit aucune interaction entre ActionScript et le contenu HTML, sauf à travers les méthodes et les propriétés de la classe StageWebView elle-même. Par exemple, il nexiste aucun moyen de transmettre des valeurs ou dappeler des fonctions entre ActionScript et JavaScript.</p>
  572. <p class="- topic/p "><i class="+ topic/ph hi-d/i ">Prise en charge du profil AIR :</i> cette fonctionnalité est prise en charge sur tous les systèmes dexploitation de bureau et sur tous les périphériques mobiles, mais ne lest pas sur les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de lexécution à laide de la propriété <codeph class="+ topic/ph pr-d/codeph ">StageWebView.isSupported</codeph>. Voir <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">Prise en charge du profil AIR</xref> pour plus dinformations sur la prise en charge de lAPI dans plusieurs profils.</p>
  573. <p class="- topic/p ">Sur les périphériques des profils mobiles et des profils mobiles étendus, la classe StageWebView utilise le contrôle du système Web proposé par le système dexploitation du périphérique. Par conséquent, les fonctions disponibles et laspect du rendu peuvent varier dun périphérique à lautre. Sur les ordinateurs de bureau (dans les profils de bureau et les profils de bureau étendu), la classe StageWebView utilise le moteur WebKit AIR interne. Les fonctionnalités disponibles et laspect du rendu sont les mêmes que ceux de la classe HTMLLoader (sans lintégration étroite et la correspondance de scripts entre ActionScript et JavaScript fournis par une occurrence de HTMLLoader). Testez la propriété <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> de la classe StageWebView pour déterminer si la classe est prise en charge sur le périphérique actuel.</p>
  574. <p class="- topic/p ">La classe StageWebView nest PAS un objet daffichage et ne peut pas être ajoutée à la liste daffichage de Flash. Par contre, vous pouvez afficher un objet StageWebView en lassociant directement à une scène à laide de la propriété <codeph class="+ topic/ph pr-d/codeph ">stage</codeph>. Loccurrence de StageWebView associée à une scène saffiche au-dessus de nimporte quel objet daffichage Flash. Vous pouvez contrôler la taille et la position de la zone de rendu avec la propriété <codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph>. Il nexiste aucun moyen de contrôler lordre de profondeur des différents objets StageWebView. Le chevauchement de deux instances nest pas recommandé.</p>
  575. <p class="- topic/p ">Dès que le contenu à lintérieur de lobjet StageWebView a le focus, lobjet StageWebView a la première occasion de gérer la saisie au clavier. La scène à laquelle lobjet StageWebView est associé distribue toute saisie au clavier qui nest pas gérée. La capture et la propagation standard dévénements ne sappliquent pas ici, car loccurrence de StageWebView ne fait pas partie de la liste daffichage.</p>
  576. <p class="- topic/p ">Dans Android 3.0+, lapplication doit activer laccélération matérielle dans lélément manifestAdditions Android du descripteur dapplication AIR pour afficher le contenu des modules dextension dans un objet StageWebView.</p>
  577. </apiDesc><example conref="examples\StageWebViewExample.1.as" class="- topic/example "> Lexemple suivant définit un objet StageWebView pour remplir la scène. Cet exemple charge un site Web avec la méthode <codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph>, et utilise les touches Retour et Recherche du périphérique pour naviguer dans lhistorique.
  578. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  579. package {
  580. import flash.display.MovieClip;
  581. import flash.media.StageWebView;
  582. import flash.geom.Rectangle;
  583. import flash.events.KeyboardEvent;
  584. import flash.ui.Keyboard;
  585. import flash.desktop.NativeApplication;
  586. public class StageWebViewExample extends MovieClip{
  587. private var webView:StageWebView = new StageWebView();
  588. public function StageWebViewExample()
  589. {
  590. webView.stage = this.stage;
  591. webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight );
  592. webView.loadURL( "http://www.example.com" );
  593. stage.addEventListener( KeyboardEvent.KEY_DOWN, onKey );
  594. }
  595. private function onKey( event:KeyboardEvent ):void
  596. {
  597. if( event.keyCode == Keyboard.BACK &amp;&amp; webView.isHistoryBackEnabled )
  598. {
  599. trace("Back.");
  600. webView.historyBack();
  601. event.preventDefault();
  602. }
  603. if( event.keyCode == Keyboard.SEARCH &amp;&amp; webView.isHistoryForwardEnabled )
  604. {
  605. trace("Forward.");
  606. webView.historyForward();
  607. }
  608. }
  609. }
  610. }
  611. </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="../../flash/html/HTMLLoader.html" class="- topic/link "><linktext class="- topic/linktext ">Classe 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 : AIR sur Android : 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 : Prise en charge dOAuth</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 ">Activation de Flash Player et dautres modules dextension dans un objet StageWebView</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 ">
  612. Distribué lorsque StageWebView abandonne le focus.</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 ">
  613. Distribué lorsque StageWebView abandonne le focus.
  614. </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 ">
  615. Distribué lorsque cet objet StageWebView reçoit le focus.</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 ">
  616. Distribué lorsque cet objet StageWebView reçoit le focus.
  617. </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 ">
  618. Indique quune erreur est survenue.</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 ">
  619. Indique quune erreur est survenue.
  620. </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 ">
  621. Indique que la dernière opération de chargement sollicitée par la méthode loadString() ou loadURL() est terminée.</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 ">Indique que la dernière opération de chargement sollicitée par la méthode loadString() ou load() est terminée.
  622. </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  623. Indique que la dernière opération de chargement sollicitée par la méthode <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> est terminée.
  624. </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 ">
  625. Indique que la propriété location de lobjet StageWebView est sur le point dêtre modifiée.</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 ">Indique que la propriété location de lobjet StageWebView est sur le point dêtre modifiée.
  626. </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  627. Indique que la propriété <codeph class="+ topic/ph pr-d/codeph ">location</codeph> de lobjet StageWebView est sur le point dêtre modifiée.
  628. <p class="- topic/p ">Un événement locationChanging est distribué uniquement lorsque le changement demplacement est initié via le contenu HTML ou le code qui sexécute à lintérieur de lobjet StageWebView, notamment lorsquun utilisateur clique sur un lien. Par défaut, le nouvel emplacement est affiché dans cet objet StageWebView. Vous pouvez appeler la méthode <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> de lobjet dévénement pour annuler le comportement par défaut. Par exemple, vous pouvez utiliser la fonction <codeph class="+ topic/ph pr-d/codeph ">flash.net.navigateToURL()</codeph> pour ouvrir la page dans le navigateur système en fonction de la propriété <codeph class="+ topic/ph pr-d/codeph ">location</codeph> de lobjet dévénement.</p>
  629. <p class="- topic/p ">Aucun événement locationChanging nest distribué lorsque vous modifiez lemplacement à laide des méthodes suivantes :</p>
  630. <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>
  631. </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 ">
  632. Indique que la propriété location de lobjet StageWebView a été modifiée.</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 ">Indique que la propriété location de lobjet StageWebView a été modifiée.
  633. </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  634. Signale que la propriété <codeph class="+ topic/ph pr-d/codeph ">location</codeph> de lobjet StageWebView a été modifiée.
  635. <p class="- topic/p ">Il est impossible dannuler cet événement.</p>
  636. </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 ">
  637. Crée un objet 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 ">
  638. Crée un objet StageWebView.
  639. <p class="- topic/p ">Lobjet est invisible tant quil nest pas associé à une scène et tant que la propriété <codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> nest pas définie.</p>
  640. </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 ">
  641. Donne le focus au contenu dans cet objet 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 ">Indique si le premier ou le dernier objet pouvant recevoir le focus dans le contenu affiché doit recevoir le focus.
  642. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  643. Donne le focus au contenu dans cet objet StageWebView.
  644. <p class="- topic/p ">Les valeurs de direction sont définies dans la classe FocusDirection et comprennent : "bottom", "none" et "top".</p>
  645. </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 ">
  646. Supprime cet objet 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 ">
  647. Supprime cet objet StageWebView.
  648. <p class="- topic/p ">Lappel de la méthode <codeph class="+ topic/ph pr-d/codeph ">dispose()</codeph> est facultatif. Si vous navez pas conservé de référence à cette occurrence de StageWebView, elle peut faire lobjet dune récupération de place. Lappel de la méthode <codeph class="+ topic/ph pr-d/codeph ">dispose()</codeph> peut accélérer la récupération de place ou la faire intervenir à un moment plus opportun.</p>
  649. </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 ">
  650. Crée la fenêtre daffichage de lobjet StageWebView sur un bitmap.</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 "> La largeur ou la hauteur de limage bitmap est différente de celle de la fenêtre daffichage.
  651. </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 ">Le paramètre bitmap est défini sur null.
  652. </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 ">Objet BitmapData sur lequel créer la partie visible de la fenêtre daffichage de lobjet StageWebView.
  653. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  654. Crée la fenêtre daffichage de lobjet StageWebView sur un bitmap.
  655. <p class="- topic/p ">Capturez limage bitmap et définissez la scène sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph> pour afficher le contenu au-dessus de lobjet StageWebView. </p>
  656. </apiDesc><example conref="examples\StageWebView.bitmapcapture.as" class="- topic/example "> Lexemple suivant affiche deux libellés : google et facebook. Le fait de cliquer sur le libellé capture la page Web correspondante et laffiche sous forme dinstantané sur la scène.
  657. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  658. package
  659. {
  660. import flash.display.Bitmap;
  661. import flash.display.BitmapData;
  662. import flash.display.Sprite;
  663. import flash.events.*;
  664. import flash.geom.Rectangle;
  665. import flash.media.StageWebView;
  666. import flash.net.*;
  667. import flash.text.TextField;
  668. public class stagewebview1 extends Sprite
  669. {
  670. public var webView:StageWebView = new StageWebView();
  671. public var textGoogle:TextField=new TextField();
  672. public var textFacebook:TextField=new TextField();
  673. public function stagewebview()
  674. {
  675. textGoogle.htmlText="&lt;b>Google&lt;/b>";
  676. textGoogle.x=300;
  677. textGoogle.y=-80;
  678. addChild(textGoogle);
  679. textFacebook.htmlText="&lt;b>Facebook&lt;/b>";
  680. textFacebook.x=0;
  681. textFacebook.y=-80;
  682. addChild(textFacebook);
  683. textGoogle.addEventListener(MouseEvent.CLICK,goGoogle);
  684. textFacebook.addEventListener(MouseEvent.CLICK,goFaceBook);
  685. webView.stage = this.stage;
  686. webView.viewPort = new Rectangle(0, 0, stage.stageWidth, stage.stageHeight);
  687. }
  688. public function goGoogle(e:Event):void
  689. {
  690. webView.loadURL("http://www.google.com");
  691. webView.stage = null;
  692. webView.addEventListener(Event.COMPLETE,handleLoad);
  693. }
  694. public function goFaceBook(e:Event):void
  695. {
  696. webView.loadURL("http://www.facebook.com");
  697. webView.stage = null;
  698. webView.addEventListener(Event.COMPLETE,handleLoad);
  699. }
  700. public function handleLoad(e:Event):void
  701. {
  702. var bitmapData:BitmapData = new BitmapData(webView.viewPort.width, webView.viewPort.height);
  703. webView.drawViewPortToBitmapData(bitmapData);
  704. var webViewBitmap:Bitmap=new Bitmap(bitmapData);
  705. addChild(webViewBitmap);
  706. }
  707. }
  708. }
  709. </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 ">
  710. Revient à la page précédente dans lhistorique de navigation.</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 ">
  711. Revient à la page précédente dans lhistorique de navigation.
  712. </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 ">
  713. Passe à la page suivante dans lhistorique de navigation.</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 ">
  714. Passe à la page suivante dans lhistorique de navigation.
  715. </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 ">
  716. Charge et affiche la chaîne HTML spécifiée.</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 ">Chaîne de contenu HTML ou XHTML à afficher.
  717. </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 ">Type MIME du contenu, soit "text/html" soit "application/xhtml+xml".
  718. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  719. Charge et affiche la chaîne HTML spécifiée.
  720. <p class="- topic/p ">Lors de lutilisation de la méthode <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph>, la propriété <codeph class="+ topic/ph pr-d/codeph ">position</codeph> est signalée comme "about:blank". Seuls les modèles dURI standard peuvent être utilisés dans les URL de la chaîne HTML. Les modèles dURI dAIR, à savoir "app:" et "app-storage:", ne sont pas autorisés.</p>
  721. <p class="- topic/p ">Le contenu HTML ne peut pas charger des ressources locales, telles que des fichiers image. Les requêtes HTTP XML ne sont pas autorisées.</p>
  722. <p class="- topic/p ">Seuls les types MIME "text/html" et "application/xhtml+xml" sont pris en charge.</p>
  723. </apiDesc><example conref="examples\StageWebView.loadString.1.as" class="- topic/example "> Lexemple suivant définit un objet StageWebView pour remplir la scène. Cet exemple charge une page HTML avec la méthode <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph>.
  724. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  725. var webView:StageWebView = new StageWebView();
  726. webView.stage = this.stage;
  727. webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight );
  728. var htmlString:String = "&lt;!DOCTYPE HTML>" +
  729. "&lt;html>" +
  730. "&lt;body>" +
  731. "&lt;h1>Example&lt;/h1>" +
  732. "&lt;p>King Phillip cut open five green snakes.&lt;/p>" +
  733. "&lt;/body>" +
  734. "&lt;/html>";
  735. webView.loadString( htmlString, "text/html" );
  736. </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 ">
  737. Charge la page à ladresse URL spécifiée.</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 ">
  738. Charge la page à ladresse URL spécifiée.
  739. <p class="- topic/p ">LURL peut utiliser les modèles dURI suivants : http:, https:, file:, data: et javascript:. Contenu chargé avec le fichier : le modèle peut charger dautres ressources locales.</p>
  740. </apiDesc><example conref="examples\StageWebView.loadURL.1.as" class="- topic/example "> Lexemple suivant définit un objet StageWebView pour remplir la scène. Cet exemple charge un site Web avec la méthode <codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph>.
  741. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> sur Android, vous devez spécifier une autorisation INTERNET dans votre fichier descripteur dapplication AIR pour charger URL distantes.</p>
  742. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  743. var webView:StageWebView = new StageWebView();
  744. webView.stage = this.stage;
  745. webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight );
  746. webView.loadURL( "http://www.example.com" );
  747. </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 ">
  748. Recharge la page en cours.</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 ">
  749. Recharge la page en cours.
  750. </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 ">
  751. Interrompt lopération de chargement en cours.</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 ">
  752. Interrompt lopération de chargement en cours.
  753. </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 ">
  754. Indique sil existe une page précédente dans lhistorique de navigation.</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 ">
  755. Indique sil existe une page précédente dans lhistorique de navigation.
  756. </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 ">
  757. Indique sil existe une page suivante dans lhistorique de navigation.</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 ">
  758. Indique sil existe une page suivante dans lhistorique de navigation.
  759. </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 ">
  760. Indique si la classe StageWebView est prise en charge sur le périphérique actuel.</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 ">
  761. Indique si la classe StageWebView est prise en charge sur le périphérique actuel.
  762. </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 ">
  763. URL de lemplacement actuel.</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 ">
  764. URL de lemplacement actuel.
  765. </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 ">
  766. Scène sur laquelle cet objet StageWebView est affiché.</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 ">
  767. Scène sur laquelle cet objet StageWebView est affiché.
  768. <p class="- topic/p ">Définissez <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph> pour masquer cet objet StageWebView.</p>
  769. </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 ">
  770. Valeur du titre 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 ">
  771. Valeur du titre HTML.
  772. </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 ">
  773. Zone sur la scène sur laquelle lobjet StageWebView est affiché.</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 ">La valeur Rectangle nest pas valide.
  774. </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 ">
  775. Zone sur la scène sur laquelle lobjet StageWebView est affiché.
  776. </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 ">
  777. Cette classe définit une énumération décrivant de possibles niveaux de décodage vidéo.</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 ">Enumération décrivant de possibles niveaux de décodage vidéo.
  778. </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  779. Cette classe définit une énumération décrivant de possibles niveaux de décodage vidéo.
  780. </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 ">
  781. Indique que le décodage vidéo est effectué par accélération matérielle (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 ">Indique que le décodage vidéo est effectué par accélération matérielle (GPU).
  782. </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  783. Indique que le décodage vidéo est effectué par accélération matérielle (GPU).
  784. </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 ">
  785. Indique que le décodage vidéo est effectué via le logiciel.</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 ">Indique que le décodage vidéo est effectué via le logiciel.
  786. </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  787. Indique que le décodage vidéo est effectué via le logiciel.
  788. </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 ">
  789. Le décodage vidéo nest pas pris en charge.</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 ">La vidéo nest pas prise en charge.
  790. </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  791. Le décodage vidéo nest pas pris en charge.
  792. </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 ">
  793. La classe MediaPromise représente le fichier promis permettant de fournir un objet multimédia.</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 ">
  794. La classe MediaPromise représente le fichier promis permettant de fournir un objet multimédia.
  795. <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">data</codeph> dun objet MediaEvent est une occurrence de MediaPromise. Vous pouvez utiliser les méthodes MediaPromise pour accéder à lobjet multimédia promis. Les formats multimédias pris en charge formats sont des images fixes et des vidéos.</p>
  796. <p class="- topic/p ">Vous ne pouvez pas créer un objet MediaPromise. Lappel de <codeph class="+ topic/ph pr-d/codeph ">MediaPromise()</codeph> génère une erreur dexécution.</p>
  797. </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 ">
  798. Un objet MediaPromise distribue un événement complete après la lecture de toutes les données.</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 ">
  799. Un objet MediaPromise distribue un événement <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> après la lecture de toutes les données. Lévénement indique quil nexiste plus aucune donnée disponible dans le flux sous-jacent.
  800. <p class="- topic/p ">Aucun événement <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> nest distribué par une source de données synchrone.</p>
  801. </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 ">
  802. Un objet MediaPromise distribue des événements progress au fur et à mesure que les données deviennent disponibles.</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 ">
  803. Un objet MediaPromise distribue des événements <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> lorsque les données deviennent disponibles.
  804. <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">bytesTotal</codeph> de tous les événements progress, à lexception du dernier, a une valeur de 0. Si toutes les données sont disponibles immédiatement, il est possible quaucun événement <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> ne soit distribué. Aucun événement <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> nest distribué par des sources de données synchrones.</p>
  805. </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 ">
  806. Un objet MediaPromise distribue un événement ioError si une erreur est détectée lors de la lecture du flux de données sous-jacent.</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 ">
  807. Un objet MediaPromise distribue un événement <codeph class="+ topic/ph pr-d/codeph ">ioError</codeph> si une erreur est détectée lors de la lecture du flux de données sous-jacent. Plus aucune donnée ne peut être lue après la distribution de cet événement.
  808. </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 ">
  809. Un objet MediaPromise distribue un événement close après la fermeture du flux de données sous-jacent.</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 ">
  810. Un objet MediaPromise distribue un événement <codeph class="+ topic/ph pr-d/codeph ">close</codeph> après la fermeture du flux de données sous-jacent.
  811. </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 ">
  812. Ferme la source de données.</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 ">
  813. Ferme la source de données.
  814. </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 ">
  815. Ouvre la source de données sous-jacente et renvoie loccurrence de IDataInput permettant de la lire.</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.
  816. </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 ">
  817. Ouvre la source de données sous-jacente et renvoie loccurrence de IDataInput permettant de la lire.
  818. <p class="- topic/p ">Si la source de données sous-jacente est asynchrone, lobjet MediaPromise distribue des événements <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> et <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> qui indiquent si les données sont disponibles pour la lecture. Si la source de données est synchrone, toutes les données sont immédiatement disponibles et ces événements ne sont pas distribués.</p>
  819. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> vous pouvez charger un objet MediaPromise à laide de la méthode <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> de la classe Loader au lieu de lire les données manuellement.</p>
  820. </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 ">
  821. Utilisé par le moteur dexécution pour signaler des erreurs.</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 ">Lévénement derreur à distribuer.
  822. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  823. Utilisé par le moteur dexécution pour signaler des erreurs.
  824. <p class="- topic/p ">Le code de lapplication ne doit pas appeler cette méthode.</p>
  825. </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 ">
  826. Occurrence de File représentant lobjet multimédia, sil existe.</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 ">
  827. Occurrence de File représentant lobjet multimédia, sil existe.
  828. <p class="- topic/p ">Cette propriété fait référence à un objet File si la source de données sous-jacente est basée sur un fichier et si le fichier est accessible à lapplication. Dans le cas contraire, cette propriété est <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.</p>
  829. </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 ">
  830. Indique si la source de données sous-jacente est asynchrone ou synchrone.</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 ">
  831. Indique si la source de données sous-jacente est asynchrone ou synchrone.
  832. <p class="- topic/p "/>
  833. </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 ">
  834. Type général déléments multimédias (images ou vidéos).</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 ">
  835. Type général déléments multimédias (images ou vidéos).
  836. <p class="- topic/p ">Les constantes de la classe MediaType définissent les valeurs possibles de cette propriété :</p>
  837. <ul class="- topic/ul "><li class="- topic/li ">MediaType.IMAGE</li><li class="- topic/li ">MediaType.VIDEO</li></ul>
  838. </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 ">
  839. Nom du fichier de lobjet multimédia, sil existe.</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 ">
  840. Nom du fichier de lobjet multimédia, sil existe.
  841. <p class="- topic/p ">Un nom de fichier est disponible si la source de données sous-jacente est basée sur un fichier et si le fichier est accessible à lapplication. Dans le cas contraire, cette propriété est <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.</p>
  842. </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 ">
  843. La classe SoundLoaderContext effectue des contrôles de sécurité des fichiers qui chargent le son.</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 ">
  844. La classe SoundLoaderContext effectue des contrôles de sécurité des fichiers qui chargent le son. Les objets SoundLoaderContext sont transmis en tant quarguments au constructeur et à la méthode <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> de la classe Sound.
  845. <p class="- topic/p ">Lorsque vous employez cette classe, tenez compte du modèle de sécurité suivant : </p>
  846. <ul class="- topic/ul "><li class="- topic/li ">Le chargement et la lecture dun son ne sont pas autorisés si le fichier appelant se trouve sur un sandbox réseau et que le fichier à charger est local.</li><li class="- topic/li ">Par défaut, le chargement et la lecture dun son sont interdits si le fichier appelant est local et tente de charger et de lire un son distant. Pour que cette opération soit possible, un utilisateur doit accorder une autorisation explicite.</li><li class="- topic/li ">Des restrictions sappliquent à certaines opérations concernant le son. Tout fichier appartenant à un autre domaine ne peut pas accéder aux données dun son chargé, sauf si vous implémentez un fichier de régulation dURL. La propriété <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> et les méthodes <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> et <codeph class="+ topic/ph pr-d/codeph ">SoundTransform()</codeph> comptent parmi les API liées au son qui sont soumises à cette restriction.</li></ul>
  847. <p class="- topic/p ">Néanmoins, dans Adobe AIR, le contenu du sandbox de sécurité <codeph class="+ topic/ph pr-d/codeph ">application</codeph> (contenu installé avec lapplication AIR) nest pas soumis à ces restrictions de sécurité.</p>
  848. <p class="- topic/p ">Pour plus dinformations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : <xref href="http://www.adobe.com/go/devnet_security_fr" scope="external" class="- topic/xref ">Sécurité</xref> (disponible en anglais uniquement).</p>
  849. </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 ">
  850. Crée un objet 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><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 ">Durée, en secondes, de préchargement dans une mémoire tampon dun son en flux continu avant que la diffusion ne commence.
  851. </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 ">Indique si lexistence dun fichier de régulation dURL doit être vérifiée après le chargement de lobjet (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) ou non.
  852. </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  853. Crée un objet SoundLoaderContext.
  854. </apiDesc><example conref="examples\SoundLoaderContextExample.as" class="- topic/example "> Dans lexemple suivant, le tampon des données audio devant être chargées est défini sur trois secondes.
  855. <p class="- topic/p ">Le premier paramètre dun objet SoundLoaderContext (<codeph class="+ topic/ph pr-d/codeph ">context</codeph>) est utilisé pour augmenter la valeur de tampon par défaut dune seconde à trois secondes (la valeur est en millisecondes). Si le second paramètre de lobjet SoundLoaderContext est défini sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, Flash Player recherche un fichier de régulation interdomaines lors du chargement de lobjet Ici, il est défini sur la valeur par défaut <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, donc aucun fichier de régulation nest recherché. La méthode <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> de lobjet audio utilisera le paramètre de contexte pour sassurer que le préchargement des données audio en flux continu dans un tampon prendra trois secondes avant que ces données ne commencent à être diffusées. Lobjet <codeph class="+ topic/ph pr-d/codeph ">URLRequest</codeph> détermine lemplacement du fichier, qui correspond à un podcast dAdobe. Si une erreur <codeph class="+ topic/ph pr-d/codeph ">IOErrorEvent.IO_ERROR</codeph> se produit pendant le chargement du fichier audio, la méthode <codeph class="+ topic/ph pr-d/codeph ">errorHandler()</codeph> est invoquée.</p>
  856. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  857. package {
  858. import flash.display.Sprite;
  859. import flash.net.URLRequest;
  860. import flash.media.Sound;
  861. import flash.media.SoundLoaderContext;
  862. import flash.events.IOErrorEvent;
  863. public class SoundLoaderContextExample extends Sprite {
  864. public function SoundLoaderContextExample() {
  865. var snd:Sound = new Sound();
  866. var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3");
  867. var context:SoundLoaderContext = new SoundLoaderContext(3000, false);
  868. snd.load(req, context);
  869. snd.play();
  870. snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
  871. }
  872. private function errorHandler(errorEvent:IOErrorEvent):void {
  873. trace("The sound could not be loaded: " + errorEvent.text);
  874. }
  875. }
  876. }
  877. </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 ">
  878. Durée, en millisecondes, de préchargement dans une mémoire tampon dun son en flux continu avant que la diffusion ne commence.</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 ">
  879. Durée, en millisecondes, de préchargement dans une mémoire tampon dun son en flux continu avant que la diffusion ne commence.
  880. <p class="- topic/p ">Vous pouvez remplacer la valeur de <codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.bufferTime</codeph> en définissant la propriété globale <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph>. <ph class="- topic/ph ">La propriété <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> affecte uniquement la durée de mise en mémoire tampon des sons en flux continu imbriqués dans un fichier SWF. Elle na aucune incidence sur les objets Sound créés dynamiquement (autrement dit, créés dans ActionScript).</ph></p>
  881. </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 ">
  882. Indique si lapplication doit tenter de télécharger un fichier de régulation dURL à partir du serveur du son chargé avant de commencer à charger ce dernier.</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
  883. </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 ">
  884. Indique si lapplication doit tenter de télécharger un fichier de régulation dURL à partir du serveur du son chargé avant de commencer à charger ce dernier. Cette propriété sapplique si le son chargé à laide de la méthode <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> se trouve en dehors du domaine du fichier appelant.
  885. <p class="- topic/p ">Définissez cette propriété sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> lorsque vous chargez un son qui se trouve en dehors du domaine du fichier appelant et que le code dans le fichier appelant requiert un accès de niveau bas pour les données du son. Référencer la propriété <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> pour extraire un objet ID3Info et appeler la méthode <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph> pour extraire des échantillons audio du son chargé constituent des exemples daccès de bas niveau. Si vous tentez daccéder aux données audio sans régler la propriété <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> au chargement, vous risquez dobtenir une exception SecurityError car le fichier de régulation requis na pas été téléchargé.</p>
  886. <p class="- topic/p ">Si un accès de bas niveau aux données audio que vous chargez est inutile, il est préférable de ne pas régler <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. La recherche dun fichier de régulation consomme de la bande passante réseau et peut retarder le début du téléchargement. Neffectuez donc cette opération quen cas de nécessité.</p>
  887. <p class="- topic/p ">Lorsque vous appelez <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> en définissant <codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.checkPolicyFile</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, Flash Player ou AIR doit télécharger un fichier de régulation dURL approprié, ou déterminer quun tel fichier nexiste pas, avant de commencer à télécharger le son spécifié. <ph class="- topic/ph ">Flash Player ou</ph> AIR exécute les actions suivantes, dans lordre indiqué, pour vérifier lexistence dun fichier de régulation :</p>
  888. <ul class="- topic/ul "><li class="- topic/li ">Flash Player ou AIR examine les fichiers de régulation téléchargés au préalable.</li><li class="- topic/li ">Flash Player ou AIR tente de télécharger tout fichier de régulation en attente spécifié dans les appels de <codeph class="+ topic/ph pr-d/codeph ">Security.loadPolicyFile()</codeph>.</li><li class="- topic/li ">Flash Player ou AIR tente de télécharger un fichier de régulation à partir de lemplacement par défaut qui correspond à lURL du son, autrement dit <codeph class="+ topic/ph pr-d/codeph ">/crossdomain.xml</codeph> sur le même serveur que <codeph class="+ topic/ph pr-d/codeph ">URLRequest.url</codeph> (lURL du son est spécifiée dans la propriété <codeph class="+ topic/ph pr-d/codeph ">url</codeph> de lobjet URLRequest transmis à <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> ou à la fonction du constructeur Sound()).</li></ul>
  889. <p class="- topic/p ">Dans tous les cas, Flash Player ou AIR requiert que le serveur du son héberge un fichier de régulation approprié et que ce fichier autorise laccès au fichier son à <codeph class="+ topic/ph pr-d/codeph ">URLRequest.url</codeph>, sur la base de lemplacement du fichier de régulation, et quil permette au domaine du fichier appelant daccéder au son par le biais dune ou plusieurs balises <codeph class="+ topic/ph pr-d/codeph ">&lt;allow-access-from></codeph>.
  890. </p>
  891. <p class="- topic/p ">Si vous réglez <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, Flash Player ouAIR attend la vérification du fichier de régulation avant de télécharger le son. Avant deffectuer des opérations de bas niveau sur les données audio, en appelant <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph> par exemple, attendez que lobjet Sound ait déclenché les événements <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> et <codeph class="+ topic/ph pr-d/codeph ">complete</codeph>.
  892. </p>
  893. <p class="- topic/p ">Si vous définissez <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> et quil nexiste aucun fichier de régulation approprié, vous ne recevez aucun message derreur tant que vous neffectuez pas dopération nécessitant un tel fichier ; dans ce cas Flash Player ou AIR renvoie une exception <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph>. Une fois que vous avez reçu un événement <codeph class="+ topic/ph pr-d/codeph ">complete</codeph>, vous pouvez vérifier quun fichier de régulation approprié a été éventuellement trouvé en extrayant la valeur de <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> dun bloc <codeph class="+ topic/ph pr-d/codeph ">try</codeph> et en vérifiant si une exception <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph> est renvoyée.</p>
  894. <p class="- topic/p ">Servez-vous de <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> avec précaution si vous téléchargez un son à partir dune URL qui utilise des redirections HTTP côté serveur. Flash Player ou AIR tente dextraire les fichiers de régulation correspondant à la propriété <codeph class="+ topic/ph pr-d/codeph ">url</codeph> de lobjet URLRequest transmis à <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph>. Si le fichier audio final provient dune URL différente en raison de redirections HTTP, les fichiers de régulation initialement téléchargés peuvent ne pas être applicables à lURL finale du son, autrement dit lURL à prendre en compte dans les décisions relatives à la sécurité.</p>
  895. <p class="- topic/p ">La solution ci-après peut vous permettre de résoudre ce problème. Après la réception dun événement <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> ou <codeph class="+ topic/ph pr-d/codeph ">complete</codeph>, vous pouvez examiner la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">Sound.url</codeph> qui contient lURL finale du son. Appelez ensuite la méthode <codeph class="+ topic/ph pr-d/codeph ">Security.loadPolicyFile()</codeph> en vous basant sur lURL finale du son pour calculer lURL du fichier de régulation. Enfin, interrogez <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> jusquà ce quaucune exception ne soit renvoyée.</p>
  896. <p class="- topic/p ">Ceci ne sapplique pas au contenu dans le sandbox de lapplication AIR. Le contenu dans le sandbox de lapplication a toujours un accès par programmation au contenu sonore, quelle que soit son origine.</p>
  897. <p class="- topic/p ">Pour plus dinformations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : <xref href="http://www.adobe.com/go/devnet_security_fr" scope="external" class="- topic/xref ">Sécurité</xref> (disponible en anglais uniquement).</p>
  898. </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 ">
  899. La classe SoundChannel contrôle un son dans une application.</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>
  900. </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 ">
  901. La classe SoundChannel contrôle un son dans une application. Chaque son est attribué à un canal audio, et lapplication peut avoir plusieurs canaux audio mélangés. La classe SoundChannel contient une méthode <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph>, des propriétés permettant de contrôler lamplitude (volume) du canal et une propriété servant à affecter un objet SoundTransform au canal.
  902. </apiDesc><example conref="examples\SoundChannelExample.as" class="- topic/example "> Lexemple suivant charge un fichier MP3, le lit et affiche des informations sur les événements sonores qui se produisent tandis que le fichier MP3 est chargé et lu. Un objet Timer fournit des informations récentes sur le positionnement de la tête de lecture toutes les 50 millisecondes. Pour exécuter lexemple, placez un fichier intitulé MySound.mp3 dans le même répertoire que votre fichier SWF.
  903. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  904. package {
  905. import flash.display.Sprite;
  906. import flash.events.*;
  907. import flash.media.Sound;
  908. import flash.media.SoundChannel;
  909. import flash.net.URLRequest;
  910. import flash.utils.Timer;
  911. public class SoundChannelExample extends Sprite {
  912. private var url:String = "MySound.mp3";
  913. private var soundFactory:Sound;
  914. private var channel:SoundChannel;
  915. private var positionTimer:Timer;
  916. public function SoundChannelExample() {
  917. var request:URLRequest = new URLRequest(url);
  918. soundFactory = new Sound();
  919. soundFactory.addEventListener(Event.COMPLETE, completeHandler);
  920. soundFactory.addEventListener(Event.ID3, id3Handler);
  921. soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
  922. soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler);
  923. soundFactory.load(request);
  924. channel = soundFactory.play();
  925. channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler);
  926. positionTimer = new Timer(50);
  927. positionTimer.addEventListener(TimerEvent.TIMER, positionTimerHandler);
  928. positionTimer.start();
  929. }
  930. private function positionTimerHandler(event:TimerEvent):void {
  931. trace("positionTimerHandler: " + channel.position.toFixed(2));
  932. }
  933. private function completeHandler(event:Event):void {
  934. trace("completeHandler: " + event);
  935. }
  936. private function id3Handler(event:Event):void {
  937. trace("id3Handler: " + event);
  938. }
  939. private function ioErrorHandler(event:Event):void {
  940. trace("ioErrorHandler: " + event);
  941. positionTimer.stop();
  942. }
  943. private function progressHandler(event:ProgressEvent):void {
  944. trace("progressHandler: " + event);
  945. }
  946. private function soundCompleteHandler(event:Event):void {
  947. trace("soundCompleteHandler: " + event);
  948. positionTimer.stop();
  949. }
  950. }
  951. }
  952. </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 ">
  953. Distribué au terme de la lecture dun son.</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 ">
  954. Distribué au terme de la lecture dun son.
  955. </apiDesc><example conref="examples\SoundChannel_event_soundCompleteExample.as" class="- topic/example "> Dans lexemple suivant, lutilisateur sélectionne des morceaux dans une liste de lecture, puis sélectionne Lecture pour les écouter dans lordre sélectionné.
  956. <p class="- topic/p ">Dans le constructeur, un champ de texte est défini et contient la liste des chansons et une ligne de sélection des lectures (généralement, des boutons servent à lire et à lister les champs dune liste de chansons). Un objet text format est défini pour changer le format des lignes de chansons en italique une fois quelles sont sélectionnées. Lorsquun utilisateur sélectionne le champ de texte, la méthode <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> est invoquée.</p>
  957. <p class="- topic/p ">Dans la méthode <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph>, la méthode <codeph class="+ topic/ph pr-d/codeph ">getLineIndexAtPoint()</codeph> de lobjet de champ de texte renvoie lindex de la ligne que lutilisateur a sélectionnée. A laide de lindex de la ligne, la méthode <codeph class="+ topic/ph pr-d/codeph ">getLineText()</codeph> obtient le contenu du texte. Linstruction if vérifie si lutilisateur a sélectionné un élément pour le lire ou pour ajouter une chanson à la liste de lecture. Si lutilisateur a activé la lecture et quun morceau a été sélectionné, lécouteur dévénement du clic de souris est supprimé et la méthode <codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> est appelée pour commencer la lecture des morceaux. Si lutilisateur a sélectionné un titre de chanson, le contenu de la ligne est ajouté au tableau <codeph class="+ topic/ph pr-d/codeph ">songList</codeph> et le format de la ligne est défini sur italique.</p>
  958. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> charge et lit chaque chanson en faisant une itération dans la liste du tableau. La chanson est également affectée à un canal audio. Un écouteur dévénement du canal audio est ajouté pour répondre lorsque la lecture de la chanson est terminée et lévénement <codeph class="+ topic/ph pr-d/codeph ">Event.SOUND_COMPLETE</codeph> est distribué. La méthode <codeph class="+ topic/ph pr-d/codeph ">soundCompleteHandler()</codeph> invoque alors la méthode <codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> pour diffuser la chanson suivante. Ce processus se poursuit jusquà ce que la lecture de toutes les chansons du tableau soit terminée.</p>
  959. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  960. package {
  961. import flash.display.Sprite;
  962. import flash.media.Sound;
  963. import flash.media.SoundChannel;
  964. import flash.text.TextField;
  965. import flash.text.TextFieldAutoSize;
  966. import flash.events.MouseEvent;
  967. import flash.text.TextFormat;
  968. import flash.net.URLRequest;
  969. import flash.events.Event;
  970. import flash.events.IOErrorEvent;
  971. public class SoundChannel_event_soundCompleteExample extends Sprite {
  972. private var channel:SoundChannel = new SoundChannel();
  973. private var songList:Array = new Array();
  974. private var listTextField:TextField = new TextField();
  975. private var songFormat:TextFormat = new TextFormat();
  976. private var arrayIndex:int = 0;
  977. private var songSelected:Boolean = false;
  978. public function SoundChannel_event_soundCompleteExample() {
  979. listTextField.autoSize = TextFieldAutoSize.LEFT;
  980. listTextField.border = true
  981. listTextField.background = true;
  982. listTextField.text = "Song1.mp3\n" + "Song2.mp3\n"
  983. + "Song3.mp3\n" + "Song4.mp3\n" + "PLAY";
  984. songFormat.italic = true;
  985. listTextField.addEventListener(MouseEvent.CLICK, clickHandler);
  986. addChild(listTextField);
  987. }
  988. private function clickHandler(e:MouseEvent):void {
  989. var index:int = listTextField.getLineIndexAtPoint(e.localX, e.localY);
  990. var line:String = listTextField.getLineText(index);
  991. var firstIndex:uint = listTextField.getLineOffset(index);
  992. var playLine:uint = listTextField.numLines - 1;
  993. if((index == playLine) &amp;&amp; (songSelected == true)) {
  994. listTextField.removeEventListener(MouseEvent.CLICK, clickHandler);
  995. playNext();
  996. } else if (index != playLine) {
  997. songList.push(line.substr(0, (line.length - 1)));
  998. listTextField.setTextFormat(songFormat, firstIndex,
  999. (firstIndex + listTextField.getLineLength(index)));
  1000. songSelected = true;
  1001. }
  1002. }
  1003. private function playNext():void {
  1004. if(arrayIndex &lt; songList.length) {
  1005. var snd:Sound = new Sound();
  1006. snd.load(new URLRequest(songList[arrayIndex]));
  1007. channel = snd.play();
  1008. channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler);
  1009. arrayIndex++;
  1010. } else {
  1011. songSelected = false;
  1012. while(arrayIndex > 0) {
  1013. songList.pop();
  1014. arrayIndex--;
  1015. }
  1016. }
  1017. }
  1018. private function soundCompleteHandler(e:Event):void {
  1019. playNext();
  1020. }
  1021. private function errorHandler(errorEvent:IOErrorEvent):void {
  1022. trace(errorEvent.text);
  1023. }
  1024. }
  1025. }
  1026. </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 ">
  1027. Arrête la lecture du son dans le canal.</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>
  1028. </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 ">
  1029. Arrête la lecture du son dans le canal.
  1030. </apiDesc><example conref="examples\SoundChannel_stopExample.as" class="- topic/example "> Dans lexemple suivant, lutilisateur peut interrompre et reprendre la lecture dun fichier audio.
  1031. <p class="- topic/p ">Le fichier audio est chargé dans le constructeur (cet exemple suppose que le fichier est dans le même répertoire que le fichier SWF). Un champ de texte est utilisé comme bouton pour que lutilisateur puisse lire ou interrompre la lecture. Lorsque lutilisateur sélectionne le champ de texte <codeph class="+ topic/ph pr-d/codeph ">button</codeph>, la méthode <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> est invoquée.</p>
  1032. <p class="- topic/p ">Dans la méthode <codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph>, la première fois que lutilisateur sélectionne le champ de texte, le son est défini sur lecture et affecté à un canal audio. Lorsque lutilisateur sélectionne ensuite le champ de texte pour faire une pause, la lecture sinterrompt. La propriété <codeph class="+ topic/ph pr-d/codeph ">position</codeph> du canal audio enregistre la position du son au moment il a été arrêté. Cette propriété est utilisée pour reprendre le son à partir de cette position, une fois que lutilisateur sélectionne le champ de texte pour relancer la lecture. Chaque fois que la méthode <codeph class="+ topic/ph pr-d/codeph ">Sound.play()</codeph> est appelée, un nouvel objet SoundChannel est créé et affecté à la variable <codeph class="+ topic/ph pr-d/codeph ">channel</codeph>. Lobjet Sound doit être affecté à un objet SoundChannel pour que la méthode <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> du canal audio soit utilisée pour arrêter le son.</p>
  1033. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1034. package {
  1035. import flash.display.Sprite;
  1036. import flash.media.Sound;
  1037. import flash.media.SoundChannel;
  1038. import flash.net.URLLoader;
  1039. import flash.net.URLRequest;
  1040. import flash.text.TextField;
  1041. import flash.events.MouseEvent;
  1042. import flash.text.TextFieldAutoSize;
  1043. public class SoundChannel_stopExample extends Sprite {
  1044. private var snd:Sound = new Sound();
  1045. private var channel:SoundChannel = new SoundChannel();
  1046. private var button:TextField = new TextField();
  1047. public function SoundChannel_stopExample() {
  1048. var req:URLRequest = new URLRequest("MySound.mp3");
  1049. snd.load(req);
  1050. button.x = 10;
  1051. button.y = 10;
  1052. button.text = "PLAY";
  1053. button.border = true;
  1054. button.background = true;
  1055. button.selectable = false;
  1056. button.autoSize = TextFieldAutoSize.CENTER;
  1057. button.addEventListener(MouseEvent.CLICK, clickHandler);
  1058. this.addChild(button);
  1059. }
  1060. private function clickHandler(e:MouseEvent):void {
  1061. var pausePosition:int = channel.position;
  1062. if(button.text == "PLAY") {
  1063. channel = snd.play(pausePosition);
  1064. button.text = "PAUSE";
  1065. }
  1066. else {
  1067. channel.stop();
  1068. button.text = "PLAY";
  1069. }
  1070. }
  1071. }
  1072. }
  1073. </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 ">
  1074. Amplitude actuelle (volume) du canal gauche, comprise entre 0 (muet) et 1 (amplitude maximale).</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>
  1075. </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 ">
  1076. Amplitude actuelle (volume) du canal gauche, comprise entre 0 (muet) et 1 (amplitude maximale).
  1077. </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 ">
  1078. Lorsque le fichier est en cours de lecture, la propriété position indique en millisecondes le point en cours de lecture dans le fichier audio.</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 ">
  1079. Lorsque le fichier est en cours de lecture, la propriété <codeph class="+ topic/ph pr-d/codeph ">position</codeph> indique en millisecondes le point en cours de lecture dans le fichier audio. Lorsque la lecture est arrêtée ou interrompue, la propriété <codeph class="+ topic/ph pr-d/codeph ">position</codeph> indique le dernier point lu dans le fichier audio.
  1080. <p class="- topic/p ">Généralement, la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">position</codeph> est enregistrée lorsque la lecture est interrompue. Vous pouvez ensuite reprendre la lecture en redémarrant à partir de cette position enregistrée.
  1081. </p>
  1082. <p class="- topic/p ">Si le son fait lobjet dune boucle, la propriété <codeph class="+ topic/ph pr-d/codeph ">position</codeph> est réinitialisée à 0 au début de chaque boucle.</p>
  1083. </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 ">
  1084. Amplitude actuelle (volume) du canal droit, comprise entre 0 (muet) et 1 (amplitude maximale).</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>
  1085. </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 ">
  1086. Amplitude actuelle (volume) du canal droit, comprise entre 0 (muet) et 1 (amplitude maximale).
  1087. </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 ">
  1088. Objet SoundTransform affecté au canal audio.</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>
  1089. </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 ">
  1090. Objet SoundTransform affecté au canal audio. Un objet SoundTransform comprend les propriétés de réglage du volume, du déplacement panoramique, ainsi que des haut-parleurs gauche et droit.
  1091. </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 ">
  1092. La classe SoundMixer contient des propriétés et des méthodes statiques permettant de contrôler globalement le son dans lapplication.</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 ">
  1093. La classe SoundMixer contient des propriétés et des méthodes statiques permettant de contrôler globalement le son dans lapplication. La classe SoundMixer contrôle les sons en flux continu intégrés dans lapplication. elle ne contrôle pas dynamiquement les sons créés (cest-à-dire les sons générés en réponse à un objet Sound qui distribue un événement <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph>).
  1094. </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 ">
  1095. Détermine si des sons sont inaccessibles en raison de restrictions de sécurité.</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>
  1096. </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 ">Représentation de la chaîne de la valeur booléenne.
  1097. </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1098. Détermine si des sons sont inaccessibles en raison de restrictions de sécurité. Par exemple, un son chargé à partir dun domaine différent de celui du contenu appelant cette méthode est inaccessible si le serveur du son ne possède pas de fichier de régulation dURL autorisant laccès au domaine de ce domaine. Le son peut cependant être chargé et lu, mais les opérations de bas niveau, telles que lextraction de métadonnées ID3 pour le son, ne peuvent pas être exécutées sur des sons inaccessibles.
  1099. <p class="- topic/p ">Pour le contenu dune application AIR dans le sandbox de sécurité de lapplication, lappel à cette méthode renvoie toujours <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. Tous les sons, y compris ceux chargés dautres domaines, sont accessibles au contenu dans le sandbox de sécurité de lapplication.</p>
  1100. </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 ">
  1101. Génère un instantané de londe sonore actuelle et le place dans lobjet ByteArray spécifié.</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.
  1102. </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 ">Objet ByteArray qui contient les valeurs associées au son. Si certains sons ne sont pas disponibles en raison des restrictions de sécurité (<codeph class="+ topic/ph pr-d/codeph ">areSoundsInaccessible == true</codeph>), lobjet <codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> ne subit aucune modification. Si tous les sons sont arrêtés, lobjet <codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> est rempli de zéros.
  1103. </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 ">Valeur booléenne indiquant si les données audio sont dabord soumises à une transformation de Fourier. Lorsque ce paramètre correspond à <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, la méthode renvoie un spectre de fréquences, plutôt que londe sonore brute. Dans le spectre de fréquences, les basses fréquences sont représentées sur la gauche et les hautes fréquences sur la droite.
  1104. </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 ">Résolution des échantillons audio. Si vous réglez la valeur <codeph class="+ topic/ph pr-d/codeph ">stretchFactor</codeph> sur 0, les données sont échantillonnées à 44,1 KHz. Réglez-la sur 1 et elles sont échantillonnées à 22,05 KHz ; sur 2 et elles sont échantillonnées à 11,025 KHz, etc.
  1105. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1106. Génère un instantané de londe sonore actuelle et le place dans lobjet ByteArray spécifié. Les valeurs sont mises en forme comme des valeurs à virgule flottante normalisées allant de -1,0 à 1,0. Lobjet ByteArray transmis au paramètre <codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> est remplacé par de nouvelles valeurs. La taille de lobjet ByteArray créé est fixée à 512 valeurs à virgule flottante, les 256 premières représentant le canal gauche et les autres le canal droit.
  1107. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque </b>: cette méthode est soumise aux restrictions relatives à la sécurité des fichiers locaux et aux restrictions concernant le chargement interdomaines. Si vous utilisez des fichiers locaux ou des sons chargés à partir dun serveur appartenant à un autre domaine que le contenu appelant, vous devez peut-être contourner les restrictions liées au sandbox par le biais dun fichier de régulation interdomaines. Pour plus dinformations, voir la description de la classe Sound. En outre, cette méthode ne permet pas dextraire des données de flux RTMP, même si elle est appelée par un contenu résidant dans le même domaine que le serveur RTMP.</p>
  1108. <p class="- topic/p ">Cette méthode est prise en charge sur RTMP dans Flash Player 9.0.115.0 et versions ultérieures, ainsi que dans Adobe AIR. Vous pouvez contrôler laccès aux flux sur un serveur FMS (Flash Media Server) dans un script coté serveur. Pour plus de détails, voir les propriétés <codeph class="+ topic/ph pr-d/codeph ">Client.audioSampleAccess</codeph> et <codeph class="+ topic/ph pr-d/codeph ">Client.videoSampleAccess</codeph> dans le <xref href="http://www.adobe.com/go/documentation_fr" scope="external" class="- topic/xref "><i class="+ topic/ph hi-d/i "> Guide de référence du langage ActionScript dAdobe Flash Media Server côté serveur</i></xref>.</p>
  1109. </apiDesc><example conref="examples\SoundMixer_computeSpectrumExample.as" class="- topic/example "> Dans lexemple suivant, la méthode <codeph class="+ topic/ph pr-d/codeph ">computeSpectrum()</codeph> est utilisée pour produire une représentation graphique des données dondes acoustiques.
  1110. <p class="- topic/p ">Dans le constructeur, un fichier audio est chargé et défini sur lecture (il ny a pas de gestion derreur dans cet exemple, et le fichier audio est supposé être dans le même répertoire que le fichier SWF). Cet exemple est à lécoute de lévénement <codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> pendant la lecture du son, ce qui déclenche de façon répétée la méthode <codeph class="+ topic/ph pr-d/codeph ">onEnterFrame()</codeph> pour le traçage du graphique des valeurs de données audio. Lorsque la lecture dun son est terminée, la méthode <codeph class="+ topic/ph pr-d/codeph ">onPlaybackComplete()</codeph> arrête le processus de dessin en supprimant lécouteur de lévénement <codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph>.</p>
  1111. <p class="- topic/p ">Dans la méthode <codeph class="+ topic/ph pr-d/codeph ">onEnterFrame()</codeph>, la méthode <codeph class="+ topic/ph pr-d/codeph ">computeSpectrum()</codeph> stocke le son brut dans lobjet tableau doctets <codeph class="+ topic/ph pr-d/codeph ">bytes</codeph>. Les données sont échantillonnées à 44,1 KHz. Le tableau doctets contient 512 octets de données, chacun contenant une valeur à virgule flottante comprise entre -1 et 1. Les 256 premières valeurs représentent le canal gauche et les autres le canal droit. La première boucle for lit les 256 premières valeurs (canal stéréo gauche ) et trace chaque fois une ligne dun point à lautre via la méthode <codeph class="+ topic/ph pr-d/codeph ">Graphics.lineTo()</codeph> (laffichage du graphique vectoriel de londe acoustique est directement écrit dans lobjet Sprite de la classe). Les octets du son sont lus sous forme de nombre à virgule flottante 32 bits dans le flux doctets et multipliés par la hauteur du point pour autoriser la plage verticale du graphique. La largeur est définie sur le double de la longueur du canal. La seconde boucle for lit les 256 valeurs suivantes (canal stéréo droit) et trace les lignes en ordre inverse. Les méthodes <codeph class="+ topic/ph pr-d/codeph ">g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);</codeph> et <codeph class="+ topic/ph pr-d/codeph ">g.lineTo(0, PLOT_HEIGHT);</codeph> tracent la base des ondes. Le dessin de la courbe audio qui en résulte produit un effet miroir.</p>
  1112. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1113. package {
  1114. import flash.display.Sprite;
  1115. import flash.display.Graphics;
  1116. import flash.events.Event;
  1117. import flash.media.Sound;
  1118. import flash.media.SoundChannel;
  1119. import flash.media.SoundMixer;
  1120. import flash.net.URLRequest;
  1121. import flash.utils.ByteArray;
  1122. import flash.text.TextField;
  1123. public class SoundMixer_computeSpectrumExample extends Sprite {
  1124. public function SoundMixer_computeSpectrumExample() {
  1125. var snd:Sound = new Sound();
  1126. var req:URLRequest = new URLRequest("Song1.mp3");
  1127. snd.load(req);
  1128. var channel:SoundChannel;
  1129. channel = snd.play();
  1130. addEventListener(Event.ENTER_FRAME, onEnterFrame);
  1131. channel.addEventListener(Event.SOUND_COMPLETE, onPlaybackComplete);
  1132. }
  1133. private function onEnterFrame(event:Event):void {
  1134. var bytes:ByteArray = new ByteArray();
  1135. const PLOT_HEIGHT:int = 200;
  1136. const CHANNEL_LENGTH:int = 256;
  1137. SoundMixer.computeSpectrum(bytes, false, 0);
  1138. var g:Graphics = this.graphics;
  1139. g.clear();
  1140. g.lineStyle(0, 0x6600CC);
  1141. g.beginFill(0x6600CC);
  1142. g.moveTo(0, PLOT_HEIGHT);
  1143. var n:Number = 0;
  1144. for (var i:int = 0; i &lt; CHANNEL_LENGTH; i++) {
  1145. n = (bytes.readFloat() * PLOT_HEIGHT);
  1146. g.lineTo(i * 2, PLOT_HEIGHT - n);
  1147. }
  1148. g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);
  1149. g.endFill();
  1150. g.lineStyle(0, 0xCC0066);
  1151. g.beginFill(0xCC0066, 0.5);
  1152. g.moveTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);
  1153. for (i = CHANNEL_LENGTH; i > 0; i--) {
  1154. n = (bytes.readFloat() * PLOT_HEIGHT);
  1155. g.lineTo(i * 2, PLOT_HEIGHT - n);
  1156. }
  1157. g.lineTo(0, PLOT_HEIGHT);
  1158. g.endFill();
  1159. }
  1160. private function onPlaybackComplete(event:Event):void {
  1161. removeEventListener(Event.ENTER_FRAME, onEnterFrame);
  1162. }
  1163. }
  1164. }
  1165. </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 ">
  1166. Arrête tout son en cours de lecture.</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 ">
  1167. Arrête tout son en cours de lecture.
  1168. <p class="- topic/p ">>Dans Flash Professional, cette méthode narrête pas la tête de lecture. Les sons diffusés en continu sont émis de nouveau lorsque la tête de lecture passe au-dessus des images les contenant.</p>
  1169. <p class="- topic/p ">Pour utiliser cette propriété, tenez compte du modèle de sécurité suivant :</p>
  1170. <ul class="- topic/ul "><li class="- topic/li "> Par défaut, lappel de la méthode <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> arrête uniquement les sons se trouvant dans le même sandbox de sécurité que lobjet qui appelle la méthode. Les sons dont la lecture na pas été lancée à partir du sandbox de lobjet appelant ne sont pas arrêtés.</li><li class="- topic/li ">Lorsque vous chargez le son à laide de la méthode <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> de la classe Sound, vous pouvez spécifier un paramètre <codeph class="+ topic/ph pr-d/codeph ">context</codeph> qui est un objet SoundLoaderContext. Si vous réglez la propriété <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> de lobjet SoundLoaderContext sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, <ph class="- topic/ph ">Flash Player ou </ph>Adobe AIR recherche un fichier de régulation interdomaines sur le serveur à partir duquel le son est chargé. Si le serveur dispose dun fichier de régulation interdomaines qui autorise le domaine du contenu appelant, ce fichier peut arrêter le son chargé par le biais de la méthode <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> ; dans le cas contraire, il ne peut pas larrêter.</li></ul>
  1171. <p class="- topic/p ">Néanmoins, dans Adobe AIR, le contenu du sandbox de sécurité <codeph class="+ topic/ph pr-d/codeph ">application</codeph> (contenu installé avec lapplication AIR) nest pas soumis à ces restrictions de sécurité.</p>
  1172. <p class="- topic/p ">Pour plus dinformations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : <xref href="http://www.adobe.com/go/devnet_security_fr" scope="external" class="- topic/xref ">Sécurité</xref> (disponible en anglais uniquement).</p>
  1173. </apiDesc><example conref="examples\SoundMixer_stopAllExample.as" class="- topic/example "> Dans lexemple suivant, la méthode <codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> est utilisée pour désactiver deux sons lus en même temps.
  1174. <p class="- topic/p ">Dans le constructeur, deux fichiers audio différents sont chargés et définis sur la lecture. Le premier est chargé localement et attribué à un canal audio (ce fichier est supposé être dans le même répertoire que le fichier SWF). Le second fichier est chargé et diffusé en continu depuis le site dAdobe. Pour utiliser la méthode <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph>, tous les sons doivent être accessibles (un objet SoundLoaderContext peut être utilisé pour rechercher le fichier de régulation interdomaines). Chaque son doit également posséder un écouteur dévénement invoqué lorsquune erreur dE/S survient lors du chargement du fichier audio. Un champ de texte <codeph class="+ topic/ph pr-d/codeph ">muteButton</codeph> est également créé. Il écoute un événement de type clic, qui invoque la méthode <codeph class="+ topic/ph pr-d/codeph ">muteButtonClickHandler()</codeph>.</p>
  1175. <p class="- topic/p ">Dans la méthode <codeph class="+ topic/ph pr-d/codeph ">muteButtonClickHandler()</codeph>, si le contenu du champ de texte est « MUTE », la méthode <codeph class="+ topic/ph pr-d/codeph ">areSoundsInaccessible()</codeph> vérifie que le mélangeur de sons a accès aux fichiers. Si les fichiers sont accessibles, la méthode <codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> interrompt les sons. Si le champ de texte est à nouveau sélectionné, la lecture du premier son commence et le contenu du champ de texte est à nouveau défini sur « MUTE ». Cette fois la méthode <codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> désactive le son en cours de lecture. Notez que la méthode <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> du canal audio peut également être utilisée pour arrêter un son spécifique attribué au canal (pour utiliser la fonctionnalité du canal, le son doit être réaffecté à ce canal à chaque appel de la méthode <codeph class="+ topic/ph pr-d/codeph ">play()</codeph>).</p>
  1176. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1177. package {
  1178. import flash.display.Sprite;
  1179. import flash.net.URLRequest;
  1180. import flash.media.Sound;
  1181. import flash.media.SoundLoaderContext;
  1182. import flash.media.SoundChannel;
  1183. import flash.media.SoundMixer;
  1184. import flash.text.TextField;
  1185. import flash.text.TextFieldAutoSize;
  1186. import flash.events.MouseEvent;
  1187. import flash.events.IOErrorEvent;
  1188. public class SoundMixer_stopAllExample extends Sprite {
  1189. private var firstSound:Sound = new Sound();
  1190. private var secondSound:Sound = new Sound();
  1191. private var muteButton:TextField = new TextField();
  1192. private var channel1:SoundChannel = new SoundChannel();
  1193. public function SoundMixer_stopAllExample() {
  1194. firstSound.load(new URLRequest("mySound.mp3"));
  1195. secondSound.load(new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"));
  1196. firstSound.addEventListener(IOErrorEvent.IO_ERROR, firstSoundErrorHandler);
  1197. secondSound.addEventListener(IOErrorEvent.IO_ERROR, secondSoundErrorHandler);
  1198. channel1 = firstSound.play();
  1199. secondSound.play();
  1200. muteButton.autoSize = TextFieldAutoSize.LEFT;
  1201. muteButton.border = true;
  1202. muteButton.background = true;
  1203. muteButton.text = "MUTE";
  1204. muteButton.addEventListener(MouseEvent.CLICK, muteButtonClickHandler);
  1205. this.addChild(muteButton);
  1206. }
  1207. private function muteButtonClickHandler(event:MouseEvent):void {
  1208. if(muteButton.text == "MUTE") {
  1209. if(SoundMixer.areSoundsInaccessible() == false) {
  1210. SoundMixer.stopAll();
  1211. muteButton.text = "click to play only one of sound.";
  1212. }
  1213. else {
  1214. muteButton.text = "The sounds are not accessible.";
  1215. }
  1216. }
  1217. else {
  1218. firstSound.play();
  1219. muteButton.text = "MUTE";
  1220. }
  1221. }
  1222. private function firstSoundErrorHandler(errorEvent:IOErrorEvent):void {
  1223. trace(errorEvent.text);
  1224. }
  1225. private function secondSoundErrorHandler(errorEvent:IOErrorEvent):void {
  1226. trace(errorEvent.text);
  1227. }
  1228. }
  1229. }
  1230. </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 ">
  1231. Durée, en secondes, de préchargement dans une mémoire tampon dun son en flux continu imbriqué avant que la diffusion en continu ne commence.</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>
  1232. </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 ">
  1233. Durée, en secondes, de préchargement dans une mémoire tampon dun son en flux continu imbriqué avant que la diffusion en continu ne commence. Les données dun son chargé, y compris sa durée de préchargement en mémoire tampon, ne sont pas accessibles par un fichier SWF appartenant à un autre domaine, sauf si vous mettez en place un fichier de régulation interdomaines. Pour plus dinformations sur la sécurité et le son, voir la description de la classe Sound. <ph class="- topic/ph ">Les données dun son chargé, y compris sa durée de préchargement en mémoire tampon, ne sont pas accessibles par le code dun fichier appartenant à un autre domaine, sauf si vous mettez en place un fichier de régulation interdomaines. Néanmoins, dans le sandbox dapplication dune application AIR, le code peut accéder aux données dans des fichiers de son à partir de nimporte quelle source. Pour plus dinformations sur la sécurité et le son, voir la description de la classe Sound.</ph>
  1234. <p class="- topic/p ">La propriété <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> affecte uniquement la durée de mise en mémoire tampon des sons en flux continu imbriqués dans un fichier SWF. Elle na aucune incidence sur les objets Sound créés dynamiquement (autrement dit, créés dans ActionScript). La valeur de <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> ne peut pas remplacer ni définir la durée de mise en mémoire tampon par défaut spécifiée dans lobjet SoundLoaderContext qui est transmis à la méthode <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph>.</p>
  1235. </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 ">
  1236. Objet SoundTransform contrôlant les propriétés audio globales.</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>
  1237. </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 ">
  1238. Objet SoundTransform contrôlant les propriétés audio globales. Un objet SoundTransform comprend les propriétés de réglage du volume, du déplacement panoramique, ainsi que des haut-parleurs gauche et droit. Lobjet SoundTransform utilisé dans cette propriété fournit des paramètres audio finaux qui sont appliqués à la totalité des sons après lapplication de paramètres audio individuels.
  1239. </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 ">
  1240. La classe CameraUI permet de capturer une image figée ou vidéo à laide de lapplication de caméra par défaut dun périphérique.</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 ">
  1241. La classe CameraUI permet de capturer une image figée ou vidéo à laide de lapplication de caméra par défaut dun périphérique.
  1242. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> demande au périphérique douvrir la caméra par défaut de lapplication. Limage ou la vidéo capturée est disponible dans lobjet MediaEvent distribué pour lévénement complete. Etant donné que lapplication de caméra par défaut peut enregistrer la vidéo ou limage dans divers formats, il est possible que le moteur dexécution dAIR ne puisse pas charger et afficher lobjet multimédia renvoyé. </p>
  1243. <p class="- topic/p ">Sur certaines plates-formes, lobjet multimédia renvoyé par la caméra est accessible en tant que média promis basé sur un fichier. Sur dautres, le média promis nest pas basé sur un fichier, et les propriétés <codeph class="+ topic/ph pr-d/codeph ">file</codeph> et <codeph class="+ topic/ph pr-d/codeph ">relativePath</codeph> de lobjet MediaPromise sont définies sur <codeph class="+ topic/ph pr-d/codeph ">null</codeph>. Evitez de recourir à ces propriétés dans le code utilisé sur plusieurs plates-formes.</p>
  1244. <p class="- topic/p ">Sur certaines plates-formes, lobjet multimédia est automatiquement stocké dans la bibliothèque multimédia du périphérique. Sur ces plates-formes (sur lesquelles les images et les vidéos ne sont pas automatiquement stockées par lapplication de caméra par défaut), vous pouvez utiliser la fonction <codeph class="+ topic/ph pr-d/codeph ">addBitmapData()</codeph> du dossier Pellicule pour stocker lobjet multimédia.</p>
  1245. <p class="- topic/p ">Sur Android, lapplication de caméra par défaut ne souvre pas si la carte de stockage externe nest pas disponible (notamment lorsque lutilisateur a installé la carte comme périphérique de stockage de masse USB). En outre, lapplication AIR qui lance la caméra perd le focus. Si le périphérique dispose de peu de ressources, le système dexploitation peut fermer lapplication AIR avant que la capture de lobjet multimédia ne soit terminée.</p>
  1246. <p class="- topic/p "><i class="+ topic/ph hi-d/i ">Prise en charge du profil AIR :</i> cette fonctionnalité est prise en charge sur les périphériques mobiles, mais ne lest pas sur les systèmes dexploitation de bureau ou sur les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de lexécution à laide de la propriété <codeph class="+ topic/ph pr-d/codeph ">CameraUI.isSupported</codeph>. Voir <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">Prise en charge du profil AIR</xref> pour plus dinformations sur la prise en charge de lAPI dans plusieurs profils.</p>
  1247. </apiDesc><example conref="examples\CameraUIExample.Still.1.as" class="- topic/example "> Lexemple suivant utilise la classe CameraUI pour lancer lapplication de caméra par défaut sur le périphérique. Lorsque lutilisateur prend une photo, lexemple place limage sur la liste daffichage.
  1248. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1249. package {
  1250. import flash.desktop.NativeApplication;
  1251. import flash.display.Loader;
  1252. import flash.display.MovieClip;
  1253. import flash.display.StageAlign;
  1254. import flash.display.StageScaleMode;
  1255. import flash.events.ErrorEvent;
  1256. import flash.events.Event;
  1257. import flash.events.IOErrorEvent;
  1258. import flash.events.MediaEvent;
  1259. import flash.media.CameraUI;
  1260. import flash.media.MediaPromise;
  1261. import flash.media.MediaType;
  1262. public class CameraUIStillImage extends MovieClip{
  1263. private var deviceCameraApp:CameraUI = new CameraUI();
  1264. private var imageLoader:Loader;
  1265. public function CameraUIStillImage() {
  1266. this.stage.align = StageAlign.TOP_LEFT;
  1267. this.stage.scaleMode = StageScaleMode.NO_SCALE;
  1268. if( CameraUI.isSupported )
  1269. {
  1270. trace( "Initializing camera..." );
  1271. deviceCameraApp.addEventListener( MediaEvent.COMPLETE, imageCaptured );
  1272. deviceCameraApp.addEventListener( Event.CANCEL, captureCanceled );
  1273. deviceCameraApp.addEventListener( ErrorEvent.ERROR, cameraError );
  1274. deviceCameraApp.launch( MediaType.IMAGE );
  1275. }
  1276. else
  1277. {
  1278. trace( "Camera interface is not supported.");
  1279. }
  1280. }
  1281. private function imageCaptured( event:MediaEvent ):void
  1282. {
  1283. trace( "Media captured..." );
  1284. var imagePromise:MediaPromise = event.data;
  1285. if( imagePromise.isAsync )
  1286. {
  1287. trace( "Asynchronous media promise." );
  1288. imageLoader = new Loader();
  1289. imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, asyncImageLoaded );
  1290. imageLoader.addEventListener( IOErrorEvent.IO_ERROR, cameraError );
  1291. imageLoader.loadFilePromise( imagePromise );
  1292. }
  1293. else
  1294. {
  1295. trace( "Synchronous media promise." );
  1296. imageLoader.loadFilePromise( imagePromise );
  1297. showMedia( imageLoader );
  1298. }
  1299. }
  1300. private function captureCanceled( event:Event ):void
  1301. {
  1302. trace( "Media capture canceled." );
  1303. NativeApplication.nativeApplication.exit();
  1304. }
  1305. private function asyncImageLoaded( event:Event ):void
  1306. {
  1307. trace( "Media loaded in memory." );
  1308. showMedia( imageLoader );
  1309. }
  1310. private function showMedia( loader:Loader ):void
  1311. {
  1312. this.addChild( loader );
  1313. }
  1314. private function cameraError( error:ErrorEvent ):void
  1315. {
  1316. trace( "Error:" + error.text );
  1317. NativeApplication.nativeApplication.exit();
  1318. }
  1319. }
  1320. }
  1321. </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 et la caméra</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 ">
  1322. Lévénement cancel est distribué lorsque lutilisateur ferme lIU de la caméra sans enregistrer dimage ou de vidéo.</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 ">
  1323. Lévénement <codeph class="+ topic/ph pr-d/codeph ">cancel</codeph> est distribué lorsque lutilisateur ferme lIU de la caméra sans enregistrer dimage ou de vidéo.
  1324. </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 ">
  1325. Lévénement error est distribué lorsquil savère impossible douvrir la caméra par défaut.</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 ">
  1326. Lévénement <codeph class="+ topic/ph pr-d/codeph ">error</codeph> est distribué lorsquil savère impossible douvrir la caméra par défaut.
  1327. </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 ">
  1328. Lévénement complete est distribué lorsque lutilisateur capture une image figée ou capture une vidéo dans linterface utilisateur de la caméra.</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 ">
  1329. Lévénement <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> est distribué lorsque lutilisateur capture une image figée ou capture une vidéo dans linterface utilisateur de la caméra.
  1330. </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 ">
  1331. Crée un objet 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 ">
  1332. Crée un objet CameraUI.
  1333. </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 ">
  1334. Lance lapplication de caméra par défaut sur le périphérique.</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 ">Type dobjet multimédia à capturer. Les valeurs valides de ce paramètre sont définies dans la classe MediaType :
  1335. <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>
  1336. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1337. Lance lapplication de caméra par défaut sur le périphérique.
  1338. <p class="- topic/p ">Cette classe permet de capturer soit des images fixes soit de la vidéo. La capture de vidéo utilise le profil de caméra "Low Quality" sur le périphérique.</p>
  1339. <p class="- topic/p ">Lors de lappel de la méthode <codeph class="+ topic/ph pr-d/codeph ">launch()</codeph>, lapplication de caméra par défaut est invoquée sur le périphérique. Lapplication AIR perd le focus et attend que lutilisateur capture une image fixe ou termine la capture de vidéo. Une fois que lutilisateur capture lobjet multimédia de son choix, lapplication AIR retrouve le focus et cet objet CameraUI distribue un événement <codeph class="+ topic/ph pr-d/codeph ">complete</codeph>. Si lutilisateur annule lopération, cet objet CameraUI distribue un événement <codeph class="+ topic/ph pr-d/codeph ">cancel</codeph>.</p>
  1340. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> il est possible que le système dexploitation dAndroid ferme lapplication AIR lorsque cette dernière se trouve en arrière-plan et attend que lutilisateur capture une image ou une vidéo. Le cas échéant, lutilisateur doit redémarrer lapplication. Lapplication AIR ne distribue pas dévénement multimédia pour la capture dimage précédente.</p>
  1341. <p class="- topic/p ">Vous pouvez accéder aux fichiers multimédias capturés à laide de la propriété <codeph class="+ topic/ph pr-d/codeph ">data</codeph> de lobjet MediaEvent distribué pour lévénement <codeph class="+ topic/ph pr-d/codeph ">complete</codeph>. Cette propriété est une occurrence de la classe MediaPromise, que vous pouvez charger dans votre application à laide de la méthode <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> de la classe Loader. Notez que la caméra du périphérique peut enregistrer les fichiers multimédias capturés dans divers formats. La vidéo est particulièrement problématique à cet égard. Il peut savérer impossible dafficher lobjet multimédia capturé dans AIR.</p>
  1342. </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 ">Distribué lors de la capture dun objet multimédia.
  1343. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué lors de la capture dun objet multimédia.</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 ">Distribué lorsque lutilisateur quitte la caméra native sans capturer dobjet multimédia.
  1344. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué lorsque lutilisateur quitte la caméra native sans capturer dobjet multimédia.</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 ">Distribué si lapplication de caméra par défaut est déjà en cours dutilisation.
  1345. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué si lapplication de caméra par défaut est déjà en cours dutilisation.</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 ">Distribué si lapplication AIR se trouve à larrière-plan lorsquelle appelle cette fonction.
  1346. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué si lapplication AIR se trouve à larrière-plan lorsquelle appelle cette fonction.</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 ">
  1347. Indique si la classe CameraUI est prise en charge sur le périphérique actuel.</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 ">
  1348. Indique si la classe CameraUI est prise en charge sur le périphérique actuel.
  1349. </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 ">
  1350. La classe SoundCodec énumère les valeurs constantes utilisées lors de la définition de la propriété codec de la classe 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" 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 ">
  1351. La classe SoundCodec énumère les valeurs constantes utilisées lors de la définition de la propriété <codeph class="+ topic/ph pr-d/codeph ">codec</codeph> de la classe <codeph class="+ topic/ph pr-d/codeph ">Microphone</codeph>.
  1352. </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 ">
  1353. Spécifie que le codec Nellymoser doit être utilisé pour la compression audio.</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 ">
  1354. Spécifie que le codec Nellymoser doit être utilisé pour la compression audio. Cette constante est la valeur par défaut de la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.codec</codeph>.
  1355. </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 ">
  1356. Spécifie que le codec Speex doit être utilisé pour la compression audio.</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 ">
  1357. Spécifie que le codec Speex doit être utilisé pour la compression audio.
  1358. </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 ">
  1359. La classe CameraRoll permet daccéder aux données dimage dans la bibliothèque multimédia du système ou dans le dossier Pellicule. Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur les périphériques mobiles, mais ne lest pas sur les systèmes dexploitation de bureau ou sur les périphériques AIR pour TV.</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 ">
  1360. La classe CameraRoll permet daccéder aux données dimage dans la bibliothèque multimédia du système ou dans le dossier Pellicule.
  1361. <p class="- topic/p "><i class="+ topic/ph hi-d/i ">Prise en charge du profil AIR :</i> cette fonctionnalité est prise en charge sur les périphériques mobiles, mais ne lest pas sur les systèmes dexploitation de bureau ou sur les périphériques AIR pour TV. Voir <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">Prise en charge du profil AIR</xref> pour plus dinformations sur la prise en charge de lAPI dans plusieurs profils.</p>
  1362. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> ajoute une image à la bibliothèque multimédia propre au périphérique. Pour savoir si votre application prend en charge la méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> à lexécution, vérifiez la propriété <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsAddBitmapData</codeph>.</p>
  1363. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> ouvre une boîte de dialogue de sélection dimages qui permet à lutilisateur de choisir une image dans la bibliothèque multimédia. Lorsque lutilisateur sélectionne une image, lobjet CameraRoll distribue un événement <codeph class="+ topic/ph pr-d/codeph ">select</codeph>. Utilisez lobjet MediaEvent distribué pour cet événement pour accéder à limage choisie. Pour savoir si votre application prend en charge la méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> à lexécution, vérifiez la propriété <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsBrowseForImage</codeph>.</p>
  1364. </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 ">
  1365. Distribué lorsquun utilisateur annule une opération de recherche dimage sans sélectionner dimage.</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 ">
  1366. Distribué lorsquun utilisateur annule une opération de recherche dimage sans sélectionner dimage.
  1367. </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 ">
  1368. Distribué lorsquun utilisateur sélectionne une image de la bibliothèque multimédia du périphérique.</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 ">
  1369. Distribué lorsquun utilisateur sélectionne une image de la bibliothèque multimédia du périphérique.
  1370. <p class="- topic/p ">Lobjet MediaEvent distribué pour cet événement permet daccéder au fichier multimédia choisi.</p>
  1371. </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 ">
  1372. Lévénement error est distribué lorsquune erreur se produit.</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 ">
  1373. Lévénement <codeph class="+ topic/ph pr-d/codeph ">error</codeph> est distribué lorsquune erreur se produit.
  1374. <p class="- topic/p ">Les sources derreurs sont les suivantes :</p>
  1375. <ul class="- topic/ul "><li class="- topic/li ">Il est impossible douvrir un explorateur dimages.</li><li class="- topic/li ">Un explorateur dimages est en cours dutilisation.</li><li class="- topic/li ">Lapplication AIR tente de rechercher une image alors quelle se trouve dans larrière-plan.</li><li class="- topic/li ">Il est impossible dajouter une image à la bibliothèque multimédia.</li><li class="- topic/li ">Une méthode est appelée qui nest pas prise en charge sur le périphérique.</li></ul>
  1376. </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 ">
  1377. Indique quune opération addBitmapData() a été correctement effectuée.</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 ">
  1378. Indique quune opération addBitmapData() a été correctement effectuée.
  1379. </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 ">
  1380. Crée un objet 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 ">
  1381. Crée un objet CameraRoll.
  1382. <p class="- topic/p ">Une seule bibliothèque multimédia est prise en charge par ActionScript. Tous les objets CameraRoll sont enregistrés dans le même référentiel dimages.</p>
  1383. </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 ">
  1384. Ajoute une image au dossier Pellicule du périphérique.</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 ">Objet BitmapData contenant limage à envoyer au dossier Pellicule.
  1385. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1386. Ajoute une image au dossier Pellicule du périphérique.
  1387. <p class="- topic/p ">Pour savoir si votre application prend en charge la méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> à lexécution, vérifiez la propriété <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsAddBitmapData</codeph>.</p>
  1388. </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 ">
  1389. Ouvre une boîte de dialogue dexplorateur dimages pour que lutilisateur puisse sélectionner une image existante du dossier Pellicule du périphérique.</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 ">
  1390. Ouvre une boîte de dialogue dexplorateur dimages pour que lutilisateur puisse sélectionner une image existante du dossier Pellicule du périphérique.
  1391. <p class="- topic/p ">Lorsque lutilisateur sélectionne une image, cette occurrence de CameraRoll distribue un événement <codeph class="+ topic/ph pr-d/codeph ">select</codeph> contenant un objet MediaEvent. Utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">data</codeph> de lobjet MediaEvent pour charger limage. La propriété <codeph class="+ topic/ph pr-d/codeph ">data</codeph> est un objet MediaPromise que vous pouvez charger à laide de la méthode <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> de la classe Loader.</p>
  1392. <p class="- topic/p ">Pour savoir si votre application prend en charge la méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> à lexécution, vérifiez la propriété <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsBrowseForImage</codeph>.</p>
  1393. </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
  1394. {
  1395. import flash.media.CameraRoll;
  1396. import flash.media.MediaPromise;
  1397. import flash.media.MediaType;
  1398. import flash.events.MediaEvent;
  1399. import flash.events.Event;
  1400. import flash.display.Loader;
  1401. import flash.display.Sprite;
  1402. import flash.events.IOErrorEvent;
  1403. import flash.display.StageAlign;
  1404. import flash.display.StageScaleMode;
  1405. public class CameraRollTest extends Sprite{
  1406. private var mediaSource:CameraRoll = new CameraRoll();
  1407. public function CameraRollTest() {
  1408. this.stage.align = StageAlign.TOP_LEFT;
  1409. this.stage.scaleMode = StageScaleMode.NO_SCALE;
  1410. if( CameraRoll.supportsBrowseForImage )
  1411. {
  1412. log( "Browsing for image..." );
  1413. mediaSource.addEventListener( MediaEvent.SELECT, imageSelected );
  1414. mediaSource.addEventListener( Event.CANCEL, browseCanceled );
  1415. mediaSource.browseForImage();
  1416. }
  1417. else
  1418. {
  1419. log( "Browsing in camera roll is not supported.");
  1420. }
  1421. }
  1422. private var imageLoader:Loader;
  1423. private function imageSelected( event:MediaEvent ):void
  1424. {
  1425. log( "Image selected..." );
  1426. var imagePromise:MediaPromise = event.data;
  1427. imageLoader = new Loader();
  1428. if( imagePromise.isAsync )
  1429. {
  1430. log( "Asynchronous media promise." );
  1431. imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, imageLoaded );
  1432. imageLoader.contentLoaderInfo.addEventListener( IOErrorEvent.IO_ERROR, imageLoadFailed );
  1433. imageLoader.loadFilePromise( imagePromise );
  1434. }
  1435. else
  1436. {
  1437. log( "Synchronous media promise." );
  1438. imageLoader.loadFilePromise( imagePromise );
  1439. this.addChild( imageLoader );
  1440. }
  1441. }
  1442. private function browseCanceled( event:Event ):void
  1443. {
  1444. log( "Image browse canceled." );
  1445. }
  1446. private function imageLoaded( event:Event ):void
  1447. {
  1448. log( "Image loaded asynchronously." );
  1449. this.addChild( imageLoader );
  1450. }
  1451. private function imageLoadFailed( event:Event ):void
  1452. {
  1453. log( "Image load failed." );
  1454. }
  1455. private function log( text:String ):void
  1456. {
  1457. trace( text );
  1458. }
  1459. }
  1460. }
  1461. </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 ">Distribué lorsque lutilisateur choisit une image.
  1462. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué lorsque lutilisateur choisit une image.</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 ">Distribué lorsque lutilisateur annule lopération de recherche.
  1463. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué lorsque lutilisateur annule lopération de recherche.</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 ">Distribué si lapplication de lexplorateur dimages par défaut est en cours dutilisation.
  1464. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué si lapplication de lexplorateur dimages par défaut est en cours dutilisation.</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 ">Distribué si lapplication AIR se trouve à larrière-plan lorsquelle appelle cette fonction.
  1465. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué si lapplication AIR se trouve à larrière-plan lorsquelle appelle cette fonction.</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 ">
  1466. Indique si la méthode CameraRoll.addBitmapData() est prise en charge.</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 ">
  1467. Indique si la méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> est prise en charge. Actuellement, cette fonction est uniquement prise en charge dans les applications AIR sur des périphériques mobiles.
  1468. </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 ">
  1469. Indique si la méthode CameraRoll.browseForImage() est prise en charge.</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 ">Indique si la méthode CameraRoll.browseForImage() est prise en charge.
  1470. </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1471. Indique si la méthode <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> est prise en charge. Actuellement, cette fonction est uniquement prise en charge dans les applications AIR sur des périphériques mobiles.
  1472. </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 ">
  1473. Utilisez la classe Microphone pour gérer ou capturer un son à partir dun 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
  1474. </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 ">
  1475. Utilisez la classe Microphone pour gérer ou capturer un son à partir dun microphone.
  1476. <p class="- topic/p ">
  1477. Pour obtenir une référence à une occurrence de Microphone, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> ou la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph>. Une occurrence de Microphone améliorée peut exécuter lannulation de lécho acoustique. Utilisez lannulation de lécho acoustique pour créer des applications audio/vidéo en temps réel qui nexigent pas lutilisation dun casque.
  1478. </p>
  1479. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Création dune application de dialogue en ligne en temps réel</b></p>
  1480. <p class="- topic/p ">Pour créer une application de dialogue en ligne en temps réel, capturez des données audio et envoyez-les à Flash Media Server. Utilisez les classes NetConnection et NetStream pour transmettre le flux audio à Flash Media Server. Flash Media Server peut diffuser le son à dautres clients. Pour créer une application de dialogue en ligne qui nexige pas lutilisation dun casque, utilisez lannulation de lécho acoustique. Lannulation de lécho acoustique empêche la boucle de réaction acoustique (qui se produit lorsque le son pénètre dans un microphone) de sortir des haut-parleurs et dentrer à nouveau dans le microphone. Pour utiliser lannulation de lécho acoustique, appelez la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> afin dobtenir une référence à une occurrence de Microphone. Définissez <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> sur une occurrence de la classe <codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> pour configurer les paramètres.</p>
  1481. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Lecture locale du son du microphone</b></p>
  1482. <p class="- topic/p ">Appelez la méthode <codeph class="+ topic/ph pr-d/codeph ">setLoopback()</codeph> du microphone pour acheminer le son du microphone directement vers la sortie audio de lordinateur local ou du périphérique. Une réaction acoustique incontrôlée constitue un danger sous-jacent susceptible de se produire chaque fois que la sortie audio peut être captée par lentrée du microphone. La méthode <codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> peut réduire, mais pas éliminer, le risque de réaction acoustique.</p>
  1483. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Capture du son du microphone pour lenregistrement ou le traitement local</b></p>
  1484. <p class="- topic/p ">Pour capturer le son du microphone, écoutez les événements <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> distribués par une occurrence de Microphone. Lobjet SampleDataEvent distribué pour cet événement contient les données audio.</p>
  1485. <p class="- topic/p ">Pour plus dinformations sur la capture vidéo, voir la classe Camera.</p>
  1486. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Prise en charge du microphone par le moteur dexécution</b></p>
  1487. <p class="- topic/p ">La classe Microphone nest pas prise en charge dans Flash Player sexécutant dans un navigateur mobile.</p>
  1488. <p class="- topic/p "><i class="+ topic/ph hi-d/i ">Prise en charge du profil AIR :</i> la classe Microphone est prise en charge sur les systèmes dexploitation de bureau, mais ne lest pas sur tous les périphériques mobiles. Elle nest pas prise en charge sur les périphériques AIR pour TV. Voir <xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">Prise en charge du profil AIR</xref> pour plus dinformations sur la prise en charge de lAPI dans plusieurs profils.</p>
  1489. <p class="- topic/p ">Vous pouvez tester la prise en charge lors de lexécution à laide de la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.isSupported</codeph>. Notez que pour les périphériques AIR pour TV, <codeph class="+ topic/ph pr-d/codeph ">Microphone.isSupported</codeph> est <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, mais <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> renvoie toujours <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.</p>
  1490. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Commandes de confidentialité</b></p>
  1491. <p class="- topic/p ">
  1492. Flash Player affiche une boîte de dialogue Confidentialité qui permet à lutilisateur dautoriser ou de refuser laccès au microphone. La taille de la fenêtre de votre application doit être dau moins 215 x 138 pixels, taille minimale requise pour afficher la boîte de dialogue ; dans le cas contraire, laccès est automatiquement refusé.
  1493. </p>
  1494. <p class="- topic/p ">Le contenu qui sexécute dans le sandbox de sécurité de lapplication AIR na pas besoin dautorisation pour accéder au microphone et aucune boîte de dialogue ne saffiche. Le contenu AIR qui sexécute en dehors du sandbox de lapplication nécessite une autorisation et la boîte de dialogue Confidentialité saffiche.</p>
  1495. </apiDesc><example conref="examples\MicrophoneExample.as" class="- topic/example "> Lexemple suivant capture le son en utilisant la suppression de lécho à partir du microphone une fois lautorisation daccès à lordinateur accordée par lutilisateur. La méthode <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> affiche la boîte de dialogue Flash Player qui demande lautorisation daccéder au microphone de lutilisateur. Lappel à <codeph class="+ topic/ph pr-d/codeph ">setLoopBack(true)</codeph> réachemine lentrée sur le haut-parleur local de sorte que vous pouvez entendre le son tandis que vous exécutez lexemple.
  1496. <p class="- topic/p ">Deux écouteurs surveillent les événements <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> et <codeph class="+ topic/ph pr-d/codeph ">status</codeph>. Lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> est distribué au début et à la fin (si elle existe) de la session, et il est capturé par la méthode <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> qui assure le suivi des informations sur lévénement. Lévénement <codeph class="+ topic/ph pr-d/codeph ">status</codeph> est distribué si lobjet microphone joint signale des informations détat ; sa capture et son suivi sont assurés par le biais de la méthode <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph>.</p>
  1497. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> un microphone doit être branché sur votre ordinateur pour le bon déroulement de cet exemple.</p>
  1498. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1499. package {
  1500. import flash.display.Sprite;
  1501. import flash.events.*;
  1502. import flash.media.Microphone;
  1503. import flash.system.Security;
  1504. public class MicrophoneExample extends Sprite {
  1505. public function MicrophoneExample() {
  1506. var mic:Microphone = Microphone.getMicrophone();
  1507. Security.showSettings("2");
  1508. mic.setLoopBack(true);
  1509. if (mic != null) {
  1510. mic.setUseEchoSuppression(true);
  1511. mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
  1512. mic.addEventListener(StatusEvent.STATUS, statusHandler);
  1513. }
  1514. }
  1515. private function activityHandler(event:ActivityEvent):void {
  1516. trace("activityHandler: " + event);
  1517. }
  1518. private function statusHandler(event:StatusEvent):void {
  1519. trace("statusHandler: " + event);
  1520. }
  1521. }
  1522. }
  1523. </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 : mise en œuvre de la fonctionnalité de suppression de lécho acoustique dans des applications 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 : Notes vocales pour 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 et le microphone</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 ">
  1524. Distribué lorsquun microphone publie son état.</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 ">
  1525. Distribué lorsquun microphone publie son état. Si la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Muted"</codeph>, lutilisateur a interdit au fichier SWF daccéder au microphone. Si la valeur de la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Unmuted"</codeph>, lutilisateur a autorisé le fichier SWF à accéder au microphone.
  1526. <p class="- topic/p ">Les événements détat ne sont pas distribués dans les applications dAdobe AIR ; il est impossible de modifier dynamiquement laccès au microphone. Les applications AIR peuvent toujours accéder au microphone sur la plupart des plates-formes. Sur Android, lapplication doit spécifier lautorisation RECORD_AUDIO dAndroid dans le descripteur dapplication. Dans le cas contraire, Android refuse laccès au microphone.</p>
  1527. </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 ">
  1528. Distribué lorsque le microphone dispose de données audio dans la mémoire tampon.</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 ">
  1529. Distribué lorsque le microphone dispose de données audio dans la mémoire tampon.
  1530. <p class="- topic/p ">
  1531. La propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.rate</codeph> détermine le nombre déchantillons générés par seconde. Le nombre déchantillons par événement est un facteur du nombre déchantillons par seconde et représente le temps dattente entre des appels dévénements.
  1532. </p>
  1533. </apiDesc><example conref="examples\Microphone.sampleDataEvent.1.as" class="- topic/example "> Lexemple suivant capture 4 secondes déchantillons audio depuis le microphone par défaut, puis lit laudio. Assurez-vous quun microphone est connecté. <codeph class="+ topic/ph pr-d/codeph ">micSampleDataHandler()</codeph> est lécouteur dévénement de lévénement <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> de lobjet Microphone. La méthode <codeph class="+ topic/ph pr-d/codeph ">micSampleDataHandler()</codeph> obtient les échantillons à mesure quils sont disponibles, puis ajoute leurs valeurs à un objet ByteArray. Un objet Timer est défini pour 4 secondes. Lobjet Timer supprime lévénement <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> de lécouteur dévénement de lobjet Microphone, crée un objet Sound, puis ajoute un écouteur dévénement <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> pour lobjet Sound. Lécouteur dévénement <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> de lobjet Sound, la méthode <codeph class="+ topic/ph pr-d/codeph ">playbackSampleHandler()</codeph>, fournit des échantillons audio en vue de la lecture de lobjet Sound. Ces échantillons audio sont extraits de lobjet ByteArray qui a stocké les échantillons Microphone. Les échantillons sont écrits dans lobjet Sound à deux reprises, étant donné que les échantillons Microphone sont enregistrés en son mono et que lobjet Sound sollicite des paires déchantillons en stéréo. La propriété <codeph class="+ topic/ph pr-d/codeph ">rate</codeph> de lobjet Microphone est définie sur 44 pour correspondre au taux déchantillonnage de 44 kHz utilisé par les objets Sound.
  1534. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1535. const DELAY_LENGTH:int = 4000;
  1536. var mic:Microphone = Microphone.getMicrophone();
  1537. mic.setSilenceLevel(0, DELAY_LENGTH);
  1538. mic.gain = 100;
  1539. mic.rate = 44;
  1540. mic.addEventListener(SampleDataEvent.SAMPLE_DATA, micSampleDataHandler);
  1541. var timer:Timer = new Timer(DELAY_LENGTH);
  1542. timer.addEventListener(TimerEvent.TIMER, timerHandler);
  1543. timer.start();
  1544. var soundBytes:ByteArray = new ByteArray();
  1545. function micSampleDataHandler(event:SampleDataEvent):void
  1546. {
  1547. while(event.data.bytesAvailable)
  1548. {
  1549. var sample:Number = event.data.readFloat();
  1550. soundBytes.writeFloat(sample);
  1551. }
  1552. }
  1553. function timerHandler(event:TimerEvent):void
  1554. {
  1555. mic.removeEventListener(SampleDataEvent.SAMPLE_DATA, micSampleDataHandler);
  1556. timer.stop();
  1557. soundBytes.position = 0;
  1558. var sound:Sound = new Sound();
  1559. sound.addEventListener(SampleDataEvent.SAMPLE_DATA, playbackSampleHandler);
  1560. sound.play();
  1561. }
  1562. function playbackSampleHandler(event:SampleDataEvent):void
  1563. {
  1564. for (var i:int = 0; i &lt; 8192 &amp;&amp; soundBytes.bytesAvailable > 0; i++)
  1565. {
  1566. var sample:Number = soundBytes.readFloat();
  1567. event.data.writeFloat(sample);
  1568. event.data.writeFloat(sample);
  1569. }
  1570. }
  1571. </codeblock></example><example conref="examples\MicrophoneExample.as" class="- topic/example "> Lexemple suivant capture le son en utilisant la suppression de lécho à partir du microphone une fois lautorisation daccès à lordinateur accordée par lutilisateur. La méthode <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> affiche la boîte de dialogue Flash Player qui demande lautorisation daccéder au microphone de lutilisateur. Lappel à <codeph class="+ topic/ph pr-d/codeph ">setLoopBack(true)</codeph> réachemine lentrée sur le haut-parleur local de sorte que vous pouvez entendre le son tandis que vous exécutez lexemple.
  1572. <p class="- topic/p ">Deux écouteurs surveillent les événements <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> et <codeph class="+ topic/ph pr-d/codeph ">status</codeph>. Lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> est distribué au début et à la fin (si elle existe) de la session, et il est capturé par la méthode <codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> qui assure le suivi des informations sur lévénement. Lévénement <codeph class="+ topic/ph pr-d/codeph ">status</codeph> est distribué si lobjet microphone joint signale des informations détat ; sa capture et son suivi sont assurés par le biais de la méthode <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph>.</p>
  1573. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> un microphone doit être branché sur votre ordinateur pour le bon déroulement de cet exemple.</p>
  1574. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1575. package {
  1576. import flash.display.Sprite;
  1577. import flash.events.*;
  1578. import flash.media.Microphone;
  1579. import flash.system.Security;
  1580. public class MicrophoneExample extends Sprite {
  1581. public function MicrophoneExample() {
  1582. var mic:Microphone = Microphone.getMicrophone();
  1583. Security.showSettings("2");
  1584. mic.setLoopBack(true);
  1585. if (mic != null) {
  1586. mic.setUseEchoSuppression(true);
  1587. mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
  1588. mic.addEventListener(StatusEvent.STATUS, statusHandler);
  1589. }
  1590. }
  1591. private function activityHandler(event:ActivityEvent):void {
  1592. trace("activityHandler: " + event);
  1593. }
  1594. private function statusHandler(event:StatusEvent):void {
  1595. trace("statusHandler: " + event);
  1596. }
  1597. }
  1598. }
  1599. </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 ">
  1600. Distribué lorsquun microphone commence ou arrête lenregistrement suite à la détection dun silence.</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 ">
  1601. Distribué lorsquun microphone commence ou arrête lenregistrement suite à la détection dun silence.
  1602. <p class="- topic/p ">
  1603. Pour spécifier la quantité de son requise pour déclencher cet événement avec une propriété <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> <codeph class="+ topic/ph pr-d/codeph ">true</codeph> ou le délai devant sécouler sans son pour déclencher cet événement avec une propriété <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, utilisez <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph>.
  1604. </p>
  1605. <p class="- topic/p ">Pour quun objet Microphone distribue des événements dactivité, lapplication doit surveiller lentrée, soit en appelant <codeph class="+ topic/ph pr-d/codeph ">setLoopback( true )</codeph>, soit en écoutant les événements sampleData, soit en associant le microphone à un objet NetStream.</p>
  1606. </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 ">
  1607. Renvoie une référence à un objet Microphone optimisé capable dannuler lécho acoustique.</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 ">Une référence à un objet Microphone pour capturer des données audio. En cas déchec dinitialisation de lamélioration du son, renvoie <codeph class="+ topic/ph pr-d/codeph ">null</codeph>.
  1608. </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 ">Index du microphone.
  1609. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1610. Renvoie une référence à un objet Microphone optimisé capable dannuler lécho acoustique. Utilisez lannulation de lécho acoustique pour créer des applications audio/vidéo qui nexigent pas lutilisation dun casque.
  1611. <p class="- topic/p ">Le paramètre <codeph class="+ topic/ph pr-d/codeph ">index</codeph> des méthodes <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> fonctionne de la même façon.</p>
  1612. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Important :</b> vous pouvez, à un moment donné, disposer dune seule occurrence de microphone amélioré. Toutes les autres occurrences de Microphone cessent de fournir des données audio et reçoivent un événement <codeph class="+ topic/ph pr-d/codeph ">StatusEvent</codeph> dont la propriété de <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est <codeph class="+ topic/ph pr-d/codeph ">Microphone.Unavailable</codeph>. En cas déchec dinitialisation de lamélioration du son, les appels à cette méthode renvoient <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, la définition dune valeur pour <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> na aucun effet et toutes les occurrences existantes de Microphone fonctionnent comme avant.</p>
  1613. <p class="- topic/p ">Pour configurer un objet Microphone amélioré, définissez la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph>. Le code suivant utilise un objet Microphone amélioré et lannulation de lécho acoustique en duplex intégral dans un test local :</p>
  1614. <pre xml:space="preserve" class="- topic/pre ">
  1615. var mic:Microphone = Microphone.getEnhancedMicrophone();
  1616. var options:MicrophoneEnhancedOptions = new MicrophoneEnhancedOptions();
  1617. options.mode = MicrophoneEnhancedMode.FULL_DUPLEX;
  1618. mic.enhancedOptions = options;
  1619. mic.setLoopBack(true);
  1620. </pre>
  1621. <p class="- topic/p ">La méthode <codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> est ignorée lors de lutilisation de lannulation de lécho acoustique.
  1622. </p>
  1623. <p class="- topic/p ">
  1624. Lorsquun fichier SWF tente daccéder à lobjet renvoyé par la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph>, par exemple lorsque vous appelez <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph>, Flash Player affiche une boîte de dialogue Confidentialité qui permet à lutilisateur dautoriser ou de refuser laccès au microphone. (assurez-vous que la taille de votre scène est dau moins 215 x 138 pixels ; il sagit de la taille minimale requise par Flash Player pour afficher cette boîte de dialogue).
  1625. </p>
  1626. </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 ">
  1627. Renvoie une référence à un objet Microphone pour capturer des données audio.</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
  1628. </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 ">Une référence à un objet Microphone pour capturer des données audio.
  1629. </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 ">Index du microphone.
  1630. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1631. Renvoie une référence à un objet Microphone pour capturer des données audio. Pour commencer la capture du flux audio, vous devez relier lobjet Microphone à un objet NetStream (voir <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph>).
  1632. <p class="- topic/p ">
  1633. Plusieurs appels à <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> font référence au même microphone. Ainsi, si votre code contient les lignes <codeph class="+ topic/ph pr-d/codeph ">mic1 = Microphone.getMicrophone()</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mic2 = Microphone.getMicrophone()</codeph>, les lignes <codeph class="+ topic/ph pr-d/codeph ">mic1</codeph> et <codeph class="+ topic/ph pr-d/codeph ">mic2</codeph> font référence au même microphone (par défaut).</p>
  1634. <p class="- topic/p ">
  1635. En général, il est préférable de ne pas transmettre de valeur pour <codeph class="+ topic/ph pr-d/codeph ">index</codeph>. Il vous suffit dappeler la méthode <codeph class="+ topic/ph pr-d/codeph ">air.Microphone.getMicrophone()</codeph> pour renvoyer une référence au microphone par défaut. La section Paramètres du microphone du panneau Paramètres Adobe Flash Player permet à lutilisateur de spécifier le microphone par défaut que lapplication doit utiliser. (Pour accéder au panneau Paramètres Adobe Flash Player, lutilisateur doit cliquer avec le bouton droit de la souris sur le contenu de Flash Player sexécutant dans un navigateur Web.) Si vous transmettez une valeur pour <codeph class="+ topic/ph pr-d/codeph ">index</codeph>, vous pouvez référencer un microphone différent de celui que lutilisateur a choisi. Vous pouvez utiliser <codeph class="+ topic/ph pr-d/codeph ">index</codeph> en de rares occasions, par exemple si votre application capture un flux audio à partir de deux microphones simultanément. Le contenu sexécutant dans Adobe AIR utilise également le microphone par défaut défini dans Flash Player.</p>
  1636. <p class="- topic/p ">
  1637. Utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.index</codeph> pour obtenir la valeur dindex de lobjet Microphone actif. Vous pouvez ensuite transmettre cette valeur aux autres méthodes de la classe Microphone.
  1638. </p>
  1639. <p class="- topic/p ">
  1640. Lorsquun fichier SWF tente daccéder à lobjet renvoyé par la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph>, par exemple lorsque vous appelez <codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph>, Flash Player affiche une boîte de dialogue Confidentialité qui permet à lutilisateur dautoriser ou de refuser laccès au microphone (assurez-vous que la taille de votre scène est dau moins 215 x 138 pixels ; il sagit de la taille minimale requise par Flash Player pour afficher cette boîte de dialogue).
  1641. </p>
  1642. <p class="- topic/p ">
  1643. Lorsque lutilisateur répond à cette boîte de dialogue, un événement <codeph class="+ topic/ph pr-d/codeph ">status</codeph> indiquant la réponse de lutilisateur est distribué. Vous pouvez également vérifier la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.muted</codeph> pour déterminer si lutilisateur a autorisé ou interdit laccès au microphone.
  1644. </p>
  1645. <p class="- topic/p ">
  1646. Si <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> renvoie la valeur <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, cela signifie que le microphone est utilisé par une autre application ou quaucun microphone nest installé sur le système. Pour déterminer si un microphone est installé, utilisez <codeph class="+ topic/ph pr-d/codeph ">Microphones.names.length</codeph>. Pour afficher le panneau Paramètres du microphone de Flash Player, qui permet à lutilisateur de choisir le microphone référencé par <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph>, utilisez <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph>.
  1647. </p>
  1648. </apiDesc><example conref="examples\Microphone_getMicrophone.as" class="- topic/example "> Lexemple suivant indique comment demander laccès au microphone de lutilisateur à laide de la méthode statique Microphone.getMicrophone() et en écoutant lévénement status. Exemple fourni par <xref href="http://actionscriptexamples.com/2008/12/04/detecting-the-microphone-in-flash-using-actionscript-30/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref>.
  1649. <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">
  1650. var mic:Microphone = Microphone.getMicrophone();
  1651. mic.setLoopBack();
  1652. mic.addEventListener(StatusEvent.STATUS, mic_status);
  1653. var tf:TextField = new TextField();
  1654. tf.autoSize = TextFieldAutoSize.LEFT;
  1655. tf.text = "Detecting microphone...";
  1656. addChild(tf);
  1657. function mic_status(evt:StatusEvent):void {
  1658. tf.text = "Microphone is muted?: " + mic.muted;
  1659. switch (evt.code) {
  1660. case "Microphone.Unmuted":
  1661. tf.appendText("\n" + "Microphone access was allowed.");
  1662. break;
  1663. case "Microphone.Muted":
  1664. tf.appendText("\n" + "Microphone access was denied.");
  1665. break;
  1666. }
  1667. }
  1668. </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 ">Distribué lorsquun microphone publie son état. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">Microphone.Muted</codeph>, lutilisateur a interdit au fichier SWF daccéder à son microphone. Si la propriété <codeph class="+ topic/ph pr-d/codeph ">code</codeph> est réglée sur <codeph class="+ topic/ph pr-d/codeph ">Microphone.Unmuted</codeph>, lutilisateur a autorisé le fichier SWF à accéder à son microphone.
  1669. </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">Distribué lorsquun microphone publie son état.</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 ">
  1670. Dirige le flux audio capturé par un microphone vers les haut-parleurs locaux.</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.
  1671. </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 ">
  1672. Dirige le flux audio capturé par un microphone vers les haut-parleurs locaux.
  1673. </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 ">
  1674. Définit le niveau dentrée minimal devant être considéré comme du son et (éventuellement) la durée de silence indiquant le début du silence.</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
  1675. </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 ">Volume sonore requis pour activer le microphone et distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. Les valeurs gérées sont comprises entre 0 et 100.
  1676. </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 ">Nombre de millisecondes qui doit sécouler sans activité avant que Flash Player ou Adobe AIR considère que le son a cessé pour distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">dispatch</codeph>. La valeur par défaut est 2 000 (2 secondes). (<b class="+ topic/ph hi-d/b ">Remarque </b>: la valeur par défaut indiquée dans la signature, -1, est une valeur interne qui indique à Flash Player ou Adobe AIR dutiliser 2 000).
  1677. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1678. Définit le niveau dentrée minimal devant être considéré comme du son et (éventuellement) la durée de silence indiquant le début du silence.
  1679. <ul class="- topic/ul "><li class="- topic/li ">Pour empêcher le microphone de détecter le son, attribuez la valeur 100 au paramètre <codeph class="+ topic/ph pr-d/codeph ">silenceLevel</codeph> ; dans ce cas, lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> nest jamais distribué. </li><li class="- topic/li ">Pour déterminer le volume sonore actuellement détecté par le microphone, utilisez <codeph class="+ topic/ph pr-d/codeph ">Microphone.activityLevel</codeph>. </li></ul>
  1680. <p class="- topic/p ">Speex inclut la détection dactivité vocale (VAD) et réduit automatiquement la bande passante si aucune voix nest détectée. Lorsque vous utilisez le codec Speex, Adobe vous conseille de définir le niveau de silence sur 0. </p>
  1681. <p class="- topic/p ">La détection de lactivité est la capacité à détecter les niveaux audio indiquant quune personne est en train de parler. Lorsquune personne ne parle pas, il est possible déconomiser de la bande passante car il nest pas nécessaire denvoyer le flux audio correspondant. Ces informations peuvent également être utilisées à des fins de réponse visuelle afin que les utilisateurs (ou dautres personnes) sachent quils sont silencieux.</p>
  1682. <p class="- topic/p ">Les valeurs de silence correspondent directement aux valeurs dactivité. La valeur dactivité 0 est associée au silence total. La valeur dactivité 100 est associée à un bruit fort constant (maximum enregistrable selon le paramètre de gain actuel). Une fois le gain ajusté convenablement, votre valeur dactivité est inférieure à votre valeur de silence lorsque vous ne parlez pas. Inversement, lorsque vous parlez, la valeur dactivité dépasse celle du silence.</p>
  1683. <p class="- topic/p ">Cette méthode est similaire à la méthode <codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> ; ces deux méthodes sont utilisées pour spécifier à quel moment il convient de distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. Toutefois, leur impact sur la publication des flux diffère de manière significative :</p>
  1684. <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> est conçu pour détecter le mouvement et na aucune incidence sur lutilisation de la bande passante. La vidéo est envoyée peu importe quun flux vidéo détecte du mouvement ou non.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> est conçu pour optimiser la bande passante. Lorsquun flux audio est considéré comme étant silencieux, aucune donnée audio nest envoyée. En revanche, un message unique indiquant le début du silence est envoyé. </li></ul>
  1685. </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 ">
  1686. Spécifie sil convient dutiliser la fonctionnalité de suppression de lécho du codec audio.</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
  1687. </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 ">Valeur booléenne indiquant sil est nécessaire dutiliser la fonctionnalité de suppression de lécho (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) ou pas (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>).
  1688. </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">
  1689. Spécifie sil convient dutiliser la fonctionnalité de suppression de lécho du codec audio. La valeur par défaut est <codeph class="+ topic/ph pr-d/codeph ">false</codeph> sauf si lutilisateur sélectionne loption Réduire lécho dans le panneau Paramètres du microphone de Flash Player.
  1690. <p class="- topic/p ">La suppression de lécho vise à réduire les effets de la réaction acoustique créée lorsque le son qui sort du haut-parleur est capté par le microphone sur un même système. (Elle diffère de lannulation de lécho acoustique qui supprime entièrement la réaction acoustique. La méthode <codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> est ignorée lorsque vous appelez la méthode <codeph class="+ topic/ph pr-d/codeph ">getEnhancedMicrophone()</codeph> en vue dutiliser lannulation de lécho acoustique.)</p>
  1691. <p class="- topic/p ">En général, il est recommandé de supprimer lécho lorsque le son capturé est lu via les haut-parleurs, et non via le casque. Si votre fichier SWF autorise les utilisateurs à spécifier le périphérique de sortie audio, il peut être souhaitable dappeler <codeph class="+ topic/ph pr-d/codeph ">Microphone.setUseEchoSuppression(true)</codeph> sils précisent quils utilisent les haut-parleurs et quils ont également lintention dutiliser le microphone. </p>
  1692. <p class="- topic/p ">Les utilisateurs peuvent également ajuster ces paramètres dans le panneau Paramètres du microphone de Flash Player.</p>
  1693. </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 ">
  1694. Volume sonore détecté par le 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, Microphone.activityLevel, activityLevel
  1695. </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 ">
  1696. Volume sonore détecté par le microphone. Les valeurs gérées sont comprises entre 0 (aucun son nest détecté) et 100 (un son de grande intensité est détecté). La valeur de cette propriété peut vous aider à déterminer la valeur quil convient de transmettre à la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph>.
  1697. <p class="- topic/p ">Si la propriété <codeph class="+ topic/ph pr-d/codeph ">muted</codeph> du microphone est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, la valeur de cette propriété est toujours -1.</p>
  1698. </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 ">
  1699. Codec à utiliser pour la compression audio.</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
  1700. </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 ">
  1701. Codec à utiliser pour la compression audio. Les codecs disponibles sont Nellymoser (valeur par défaut) et Speex. La classe dénumération <codeph class="+ topic/ph pr-d/codeph ">SoundCodec</codeph> contient les différentes valeurs valides pour la propriété <codeph class="+ topic/ph pr-d/codeph ">codec</codeph>.
  1702. <p class="- topic/p ">Si vous utilisez le codec Nellymoser, vous pouvez définir le taux déchantillonnage à laide de la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.rate() </codeph>. Si vous utilisez le codec Speex, le taux déchantillonnage est défini sur 16 kHz. </p>
  1703. <p class="- topic/p ">Speex inclut la détection dactivité vocale (VAD) et réduit automatiquement la bande passante si aucune voix nest détectée. Lorsque vous utilisez le codec Speex, Adobe vous conseille de définir le niveau de silence sur 0. Pour définir le niveau de silence, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph>.</p>
  1704. </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 ">
  1705. Active la détection de lactivité vocale 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,
  1706. </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 ">
  1707. Active la détection de lactivité vocale Speex.
  1708. </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 ">
  1709. Qualité du discours codé lorsque le codec Speex est utilisé.</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,
  1710. </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 ">
  1711. Qualité du discours codé lorsque le codec Speex est utilisé. Les valeurs possibles sont comprises entre 0 et 10. La valeur par défaut est 6. Les nombres les plus élevés offrent une plus grande qualité mais consomment davantage de bande passante, comme le montre le tableau suivant. Les valeurs de vitesses de transmission énumérées représentent les vitesses de transmission nettes sans la surcharge de la mise en paquets.
  1712. <p class="- topic/p ">
  1713. <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Valeur de Quality</entry><entry class="- topic/entry ">Vitesse de transmission requise (Kbits par seconde)</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>
  1714. </p>
  1715. </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 ">
  1716. Contrôle les options du microphone amélioré.</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 ">
  1717. Contrôle les options du microphone amélioré. Pour plus dinformations, voir la classe <codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph>. Cette propriété est ignorée pour les occurrences de Microphone non améliorées.
  1718. </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 ">
  1719. Nombre dimages de discours Speex transmises dans un paquet (message).</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,
  1720. </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 ">
  1721. Nombre dimages de discours Speex transmises dans un paquet (message). La longueur de chaque image est 20 ms. La valeur par défaut est deux images par paquet.
  1722. <p class="- topic/p ">Plus un message comporte dimages Speex, moins la bande passante requise est élevée, mais plus lenvoi du message est retardé. Moins dimages Speex augmente la bande passante, mais réduit le retard.</p>
  1723. </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 ">
  1724. Valeur selon laquelle le microphone amplifie le signal. </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
  1725. </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 ">
  1726. Valeur selon laquelle le microphone amplifie le signal. Les valeurs valides sont comprises entre 0 et 100. La valeur par défaut est 50.
  1727. </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 ">
  1728. Index du microphone, tel quindiqué dans le tableau renvoyé par 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
  1729. </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 ">
  1730. Index du microphone, tel quindiqué dans le tableau renvoyé par <codeph class="+ topic/ph pr-d/codeph ">Microphone.names</codeph>.
  1731. </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 ">
  1732. La propriété isSupported est définie sur true si la classe Microphone est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur 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 ">
  1733. La propriété <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> est définie sur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> si la classe Microphone est disponible sur la plate-forme actuelle ; dans le cas contraire, elle est définie sur <codeph class="+ topic/ph pr-d/codeph ">false</codeph>.
  1734. </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 ">
  1735. Spécifie si lutilisateur a refusé (true) ou autorisé (false) laccès au 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, Microphone.muted, muted
  1736. </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 ">
  1737. Spécifie si lutilisateur a refusé (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) ou autorisé (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>) laccès au microphone. Lorsque cette valeur change, un événement <codeph class="+ topic/ph pr-d/codeph ">status</codeph> est distribué. Pour plus dinformations, voir <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph>.
  1738. </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 ">
  1739. Nom du périphérique de capture audio actuel, tel que renvoyé par le matériel de capture de son.</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
  1740. </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 ">
  1741. Nom du périphérique de capture audio actuel, tel que renvoyé par le matériel de capture de son.
  1742. </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 ">
  1743. Tableau de chaînes contenant les noms de tous les périphériques de capture audio disponibles.</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
  1744. </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 ">
  1745. Tableau de chaînes contenant les noms de tous les périphériques de capture audio disponibles. Les noms sont renvoyés sans quil soit nécessaire dafficher le panneau des paramètres de confidentialité de Flash Player à lintention de lutilisateur. Ce tableau indique lindex (commençant à zéro) de chaque périphérique de capture audio, ainsi que le nombre de ces périphériques présents dans le système, par le biais de la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.names.length</codeph>. Pour plus dinformations, voir lentrée de la classe Array.
  1746. <p class="- topic/p ">Lappel de la propriété <codeph class="+ topic/ph pr-d/codeph ">Microphone.names</codeph> exige un examen minutieux du matériel et plusieurs secondes peuvent être nécessaires pour composer le tableau. Dans la plupart des cas, vous pouvez utiliser le microphone par défaut.</p>
  1747. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> pour connaître le nom du microphone actif, utilisez la propriété <codeph class="+ topic/ph pr-d/codeph ">name</codeph>.</p>
  1748. </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 ">
  1749. Atténuation maximale du bruit, en dB (nombre négatif), utilisée pour le codeur 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,
  1750. </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 ">
  1751. Atténuation maximale du bruit, en dB (nombre négatif), utilisée pour le codeur Speex. Si elle est activée, la suppression du bruit est appliquée au son capturé via le microphone avant la compression Speex. Sélectionnez 0 pour désactiver la suppression du bruit. La suppression du bruit est activée par défaut avec une latténuation maximale de -30 dB. Cette propriété est ignorée lorsque le codec Nellymoser est sélectionné.
  1752. </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 ">
  1753. Taux auquel le microphone capture le son, en 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
  1754. </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 ">
  1755. Taux auquel le microphone capture le son, en kHz. Les valeurs possibles sont 5, 8, 11, 22 et 44. La valeur par défaut est 8 kHz si votre périphérique de capture audio prend en charge cette valeur. Dans le cas contraire, la valeur par défaut correspond au niveau de capture supérieur à 8 kHz immédiatement disponible et pouvant être pris en charge par votre périphérique de capture audio, généralement 11 kHz.
  1756. <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Remarque :</b> la vitesse réelle diffère légèrement de la valeur <codeph class="+ topic/ph pr-d/codeph ">rate</codeph>, comme indiqué dans le tableau suivant : </p>
  1757. <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 ">Valeur <codeph class="+ topic/ph pr-d/codeph ">rate</codeph></entry><entry class="- topic/entry ">Fréquence actuelle</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>
  1758. </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 ">
  1759. Volume sonore requis pour activer le microphone et distribuer lévénement 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
  1760. </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 ">
  1761. Volume sonore requis pour activer le microphone et distribuer lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph>. La valeur par défaut est 10.
  1762. </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 ">
  1763. Nombre de millisecondes qui sécoule entre le moment le microphone arrête la détection du son et le moment lévénement activity est appelé.</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
  1764. </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 ">
  1765. Nombre de millisecondes qui sécoule entre le moment le microphone arrête la détection du son et le moment lévénement <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> est distribué. La valeur par défaut est 2 000 (2 secondes).
  1766. <p class="- topic/p ">Pour définir cette valeur, utilisez la méthode <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph>.</p>
  1767. </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 ">
  1768. Contrôle le son de cet objet Microphone lorsque le mode loopback est activé.</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 "><