| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| |
| --> |
| <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 "> |
| ID3Info クラスには、ID3 メタデータが反映されるプロパティが含まれます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="AS3" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ID3Info クラスには、ID3 メタデータが反映されるプロパティが含まれます。Sound クラスの <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> プロパティにアクセスして、MP3 ファイルから追加のメタデータを取得できます。例えば、<codeph class="+ topic/ph pr-d/codeph ">mySound.id3.TIME</codeph> です。詳細については、<codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> の項目と ID3 タグの定義（<xref href="http://www.id3.org" class="- topic/xref ">http://www.id3.org</xref>）を参照してください。 |
| </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 "> |
| アルバム名です。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 "> |
| アルバム名です。ID3 2.0 タグ TALB に対応します。 |
| </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 "> |
| アーチスト名です。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 "> |
| アーチスト名です。ID3 2.0 タグ TPE1 に対応します。 |
| </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 "> |
| 録音に関するコメントです。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 "> |
| 録音に関するコメントです。ID3 2.0 タグ COMM に対応します。 |
| </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 "> |
| 曲のジャンルです。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 "> |
| 曲のジャンルです。ID3 2.0 タグ TCON に対応します。 |
| </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 "> |
| 曲名です。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 "> |
| 曲名です。ID3 2.0 タグ TIT2 に対応します。 |
| </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 "> |
| トラック番号です。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 "> |
| トラック番号です。ID3 2.0 タグ TRCK に対応します。 |
| </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 "> |
| 録音された年です。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 "> |
| 録音された年です。ID3 2.0 タグ TYER に対応します。 |
| </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 "> |
| MediaType クラスは、カメラから返される可能性があるメディアの一般的な種類を列挙します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| MediaType クラスは、カメラから返される可能性があるメディアの一般的な種類を列挙します。 |
| |
| <p class="- topic/p ">このクラスに定義されている定数を、CameraUI クラスの <codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> メソッドの入力として使用します。また、MediaType 値は MediaPromise クラスの <codeph class="+ topic/ph pr-d/codeph ">mediaType</codeph> プロパティでも使用されます。</p> |
| |
| </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 "> |
| 単一の画像。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 単一の画像。 |
| |
| </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 "> |
| ビデオ。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| ビデオ。 |
| |
| </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 "> |
| システム上のマイクとカメラを強制的に再スキャンします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| システム上のマイクとカメラを強制的に再スキャンします。 |
| |
| </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 "> |
| Camera クラスは、クライアントシステムのカメラからビデオをキャプチャするために使用します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video |
| </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 "> |
| Camera クラスは、クライアントシステムのカメラからビデオをキャプチャするために使用します。Video クラスは、ビデオをローカルで監視するために使用します。NetConnection クラスおよび NetStream クラスは、Flash Media Server にビデオを送信するために使用します。Flash Media Server は、他のサーバーにそのビデオストリームを送信し、Flash Player を実行する他のクライアントにブロードキャストできます。 |
| |
| <p class="- topic/p ">カメラインスタンスは、横長の縦横比でビデオをキャプチャします。携帯電話など、画面の方向を変更できるデバイスの場合、カメラにアタッチされている Video オブジェクトでは、横長の縦横比の方向に縦型のビデオのみが表示されます。したがって、モバイルアプリケーションでは、ビデオを表示するときに自動回転しないようにするときは横長の方向を使用する必要があります。</p> |
| |
| <p class="- topic/p ">オートフォーカスカメラを備えたモバイルデバイス上で動作している場合、AIR 2.6 では、オートフォーカスが自動的に有効になります。カメラがコンティニュアスオートフォーカスに対応していない場合は（モバイルデバイス内蔵カメラの多くは非対応です）、Camera オブジェクトがビデオストリームに添付されているときに <codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> メソッドが呼び出されるとフォーカスが動作します。デスクトップコンピューターでは、オートフォーカスビヘイビアーはカメラのドライバーと設定に依存します。</p> |
| |
| <p class="- topic/p ">Android および iOS 上の AIR アプリケーションでは、AIR アプリケーションがアクティブなフォアグラウンドアプリケーションでない場合、カメラによるビデオのキャプチャは実行されません。また、アプリケーションがバックグラウンドのときに、ストリーミング接続が切断される場合があります。iOS 上では、アプリケーションが GPU レンダリングモードを使用している場合、カメラのビデオは表示できません。ただし、この場合もカメラのビデオをサーバーにストリーミングすることは可能です。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">モバイルブラウザーのサポート：</b>このクラスはモバイルブラウザーではサポートされません。</p> |
| |
| <p class="- topic/p ">AIR プロファイルのサポート：<i class="+ topic/ph hi-d/i "/>この機能はデスクトップオペレーティングシステムではサポートされますが、すべてのモバイルデバイスではサポートされませんまた、テレビ用 AIR デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、<xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR プロファイルのサポート</xref>を参照してください。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Camera.isSupported</codeph> プロパティを使用すると、サポートされているかどうかを実行時にテストすることができます。ただし、テレビ用 AIR デバイスでは、<codeph class="+ topic/ph pr-d/codeph ">Camera.isSupported</codeph> は <codeph class="+ topic/ph pr-d/codeph ">true</codeph> ですが <codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> の返す値は常に <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。</p> |
| |
| <p class="- topic/p "> |
| オーディオのキャプチャに関する詳細については、Microphone クラスのトピックを参照してください。 |
| </p> |
| |
| <p class="- topic/p "> |
| <b class="+ topic/ph hi-d/b ">重要：</b>ユーザーがカメラへのアクセスを許可するか拒否するかを選択できるように、Flash Player でプライバシーダイアログボックスが表示されます。アプリケーションウィンドウのサイズは 215 × 138 ピクセル以上に設定してください。これは、ダイアログボックスを表示するために必要な最小サイズです。 |
| </p> |
| |
| <p class="- topic/p ">Camera オブジェクトを作成または参照するには、<codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> メソッドを使用します。</p> |
| |
| </apiDesc><example conref="examples\CameraExample.as" class="- topic/example "> 次の例では、セキュリティ警告を承認した後のカメラからのイメージを示しています。ステージは拡大 / 縮小されないように設定され、Flash Player のウィンドウの左上に揃えられます。<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントはセッションの開始時と終了時（存在する場合）に送出され、<codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> メソッドによって捕捉されます。このメソッドはイベントの情報を出力します。 |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>この例を正しく機能させるには、コンピューターにカメラを接続しておく必要があります。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| import flash.display.StageAlign; |
| import flash.display.StageScaleMode; |
| import flash.events.*; |
| import flash.media.Camera; |
| import flash.media.Video; |
| |
| public class CameraExample extends Sprite { |
| private var video:Video; |
| |
| public function CameraExample() { |
| stage.scaleMode = StageScaleMode.NO_SCALE; |
| stage.align = StageAlign.TOP_LEFT; |
| |
| var camera:Camera = Camera.getCamera(); |
| |
| if (camera != null) { |
| camera.addEventListener(ActivityEvent.ACTIVITY, activityHandler); |
| video = new Video(camera.width * 2, camera.height * 2); |
| video.attachCamera(camera); |
| addChild(video); |
| } else { |
| trace("You need a camera."); |
| } |
| } |
| |
| private function activityHandler(event:ActivityEvent):void { |
| trace("activityHandler: " + event); |
| } |
| } |
| } |
| </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：Video Chat for Android in 30 Lines of 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, and the Camera</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 "> |
| カメラがそのステータスをレポートしたときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| カメラがそのステータスをレポートしたときに送出されます。カメラにアクセスする前に、Flash Player にはプライバシーダイアログボックスが表示されて、ユーザーがカメラへのアクセスを許可または拒否することができます。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Camera.Muted"</codeph> である場合、SWF ファイルのカメラへのアクセス許可を拒否したことになります。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Camera.Unmuted"</codeph> の場合、SWF ファイルがユーザーのカメラにアクセスすることをユーザーが許可しています。 |
| </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 "> |
| カメラがセッションを開始または終了したときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| カメラがセッションを開始または終了したときに送出されます。<codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> を呼び出して、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントをトリガーするために必要なモーション量を指定するか（<codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 値を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定）、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントをトリガーする前に経過する必要があるアクティビティを実行しない時間を指定します（<codeph class="+ topic/ph pr-d/codeph ">activating</codeph> 値を <codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定）。 |
| |
| |
| |
| </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 "> |
| ビデオをキャプチャする Camera オブジェクトへの参照を返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, constructor, Camera.getCamera, getCamera |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">name</codeph> パラメーターを指定しない場合は、デフォルトのカメラへの参照を返します。デフォルトのカメラが他のアプリケーションで使用されている場合は、使用できる最初のカメラへの参照を返します。複数のカメラがインストールされている場合、ユーザーは Flash Player 設定パネルの「カメラ」でデフォルトのカメラを指定できます。利用できるカメラがない場合、またはカメラがインストールされていない場合は、<codeph class="+ topic/ph pr-d/codeph ">null</codeph> を返します。 |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:Camera</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">取得するカメラを <codeph class="+ topic/ph pr-d/codeph ">names</codeph> プロパティで返される配列から決定します。多くのアプリケーションでは、パラメーターを省略してデフォルトのカメラを取得します。このパラメーターの値を指定するには、Camera.names 配列内の 0 ベースのインデックス位置のストリング表現を使用します。例えば、配列内の 3 番目のカメラを指定するには、<codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera("2")</codeph> を使用します。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ビデオをキャプチャする Camera オブジェクトへの参照を返します。ビデオのキャプチャを開始するには、Camera オブジェクトを Video オブジェクトに関連付ける必要があります。詳細については、<codeph class="+ topic/ph pr-d/codeph ">Video.attachCamera()</codeph> のトピックを参照してください。ビデオを Flash Media Server に送信するには、<codeph class="+ topic/ph pr-d/codeph ">NetStream.attachCamera()</codeph> を呼び出して、Camera オブジェクトを NetStream オブジェクトに関連付けます。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> メソッドを複数回呼び出した場合は、同じカメラドライバーへの参照が返されます。したがって、<codeph class="+ topic/ph pr-d/codeph ">firstCam:Camera = getCamera()</codeph> と <codeph class="+ topic/ph pr-d/codeph ">secondCam:Camera = getCamera()</codeph> のようなコードが含まれている場合、<codeph class="+ topic/ph pr-d/codeph ">firstCam</codeph> と <codeph class="+ topic/ph pr-d/codeph ">secondCam</codeph> はどちらも、ユーザーのデフォルトである同じカメラを参照します。</p> |
| |
| <p class="- topic/p ">前方カメラと後方カメラを備えた iOS デバイスでは、一度に片方のカメラからしかビデオをキャプチャすることはできません。Android デバイスでは、後方カメラにのみアクセス可能です。</p> |
| |
| <p class="- topic/p ">一般には、<codeph class="+ topic/ph pr-d/codeph ">name</codeph> パラメーターの値は指定せず、単に <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> を使用してデフォルトのカメラへの参照を取得します。ユーザーは、このセクションで後述する「カメラ」ボックスで、使用するデフォルトのカメラを指定できます。 </p> |
| |
| <p class="- topic/p ">ActionScript を使用してユーザーによるカメラへのアクセスの許可または拒否を設定することはできませんが、ユーザーによるカメラのアクセス許可の設定が可能な Adobe Flash Player 設定のカメラ設定ダイアログボックスを表示することができます。 <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> メソッドを使用する SWF ファイルが <codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> メソッドによって返されたカメラを Video オブジェクトまたは NetStream オブジェクトに接続しようとすると、Flash Player はカメラへのアクセスの許可または拒否をユーザーに選択させるダイアログボックスを表示します。アプリケーションウィンドウのサイズは必ず 215×138 ピクセル以上に設定してください。これは、ダイアログボックスを表示するために必要な Flash Player の最小サイズです。ユーザーがカメラ設定のダイアログボックスに応答すると、Flash Player はユーザーの応答を示す <codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベント内の情報オブジェクトを返します。 <codeph class="+ topic/ph pr-d/codeph ">Camera.muted</codeph> と <codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph> はそれぞれ、ユーザーによるカメラへのアクセスの拒否と許可を示します。 <codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベントを使用せずにユーザーがカメラへのアクセスを拒否したか許可したかを判断するには、<codeph class="+ topic/ph pr-d/codeph ">muted</codeph> プロパティを使用します。</p> |
| |
| <p class="- topic/p ">Flash Player で再生中の SWF ファイルを右クリック（Windows および Linux）または Control キーを押しながらクリック（Macintosh）し、設定を選択してプライバシーダイアログで「後で確認」を選択すると、ユーザーは特定のドメインに対する永続的なプライバシー設定を指定できます。ユーザーが「後で確認」を選択していた場合、SWF ファイルがこのドメインからカメラにアクセスすることを許可するか拒否するかを確認するメッセージは表示されません。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>ユーザーが Flash Player の設定ダイアログボックスで「後で確認」を選択して既にアクセスを拒否している場合、<codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> メソッドではカメラへのアクセスの許可または拒否を確認するダイアログボックスは表示されません。この場合、<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings(SecurityPanel.PRIVACY)</codeph> を使用するユーザーに対して Adobe Flash Player 設定パネルの「プライバシー」を表示して許可または拒否の設定を変更するように要求することができます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> が <codeph class="+ topic/ph pr-d/codeph ">null</codeph> を返した場合、カメラは他のアプリケーションによって使用されているか、そのシステムにはカメラがインストールされていません。カメラがインストールされているかどうかを調べるには、<codeph class="+ topic/ph pr-d/codeph ">names.length</codeph> プロパティを使用します。Flash Player 設定パネルの「カメラ」を表示して、<codeph class="+ topic/ph pr-d/codeph ">getCamera()</codeph> が参照するカメラをユーザーが選択できるようにするには、<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings(SecurityPanel.CAMERA)</codeph> を使用します。 </p> |
| |
| <p class="- topic/p ">カメラのハードウェアスキャンには時間がかかります。ランタイムによってカメラが 1 つでも見つかると、その Flash Player インスタンスの存続中は、ハードウェアが再びスキャンされることはありません。しかし、カメラが見つからなかった場合は、<codeph class="+ topic/ph pr-d/codeph ">getCamera</codeph> が呼び出されるたびにハードウェアがスキャンされます。この動作は、カメラは存在するのに無効になっている場合に便利です。<codeph class="+ topic/ph pr-d/codeph ">getCamera</codeph> を呼び出すための「再試行」ボタンを SWF ファイルに用意すると、ユーザーが SWF ファイルを再起動しなくてもカメラを見つけることができます。</p> |
| |
| </apiDesc><example conref="examples\Camera_getCameraExample.as" class="- topic/example "> 次の例では、ユーザーがカメラへのアクセスを許可した場合、接続されたカメラを使用してビデオイメージをキャプチャします。 ビデオストリームに関する情報（現在の 1 秒あたりのフレーム数など）も表示します。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> メソッドは、カメラオブジェクトへの参照を返します。利用できるカメラがない場合、またはカメラが取り付けられていない場合は、null を返します。カメラが見つかったかどうか、およびユーザーがカメラへのアクセスを許可したかどうかを if ステートメントでチェックします。 ユーザーがアクセスを拒否した場合、<codeph class="+ topic/ph pr-d/codeph ">muted</codeph> プロパティは <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定されます。</p> |
| |
| <p class="- topic/p ">通常は <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> メソッドが呼び出されると、Flash Player によるカメラへのアクセスを許可するかどうかをユーザーに確認するダイアログボックスが表示されます。 ただし、ユーザーがアクセスを拒否し、<codeph class="+ topic/ph pr-d/codeph ">「後で確認」</codeph>オプションを選択した場合、ダイアログボックスなどは何も表示されません。 ユーザーがカメラへのアクセスを許可するオプションを使用できるように、Flash Player 設定ダイアログボックスを起動するためにテキストフィールドをクリックするようにという指示が <codeph class="+ topic/ph pr-d/codeph ">myTextField</codeph> テキストフィールドに表示されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドは <codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> メソッドを呼び出します。これにより、設定ダイアログボックスの<codeph class="+ topic/ph pr-d/codeph ">プライバシー</codeph>パネルが表示されます。 ユーザーがアクセスを許可した場合、<codeph class="+ topic/ph pr-d/codeph ">StatusEvent.STATUS</codeph> イベントが送出され、イベントの <codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">Camera.Unmuted</codeph> に設定されます。 （同時にカメラオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">mute</codeph> プロパティが <codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定されます。）</p> |
| |
| <p class="- topic/p ">ユーザーがアクセスを許可した場合、ユーザーの設定のステータス変更をリスニングするために追加された <codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph> メソッドにより、<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> メソッドが呼び出されます。 <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> メソッドは、キャプチャされたストリームの幅と高さを使用してビデオオブジェクトをインスタンス化します。カメラでキャプチャされたビデオを表示するため、ビデオストリームへの参照をビデオオブジェクトに関連付けて、ビデオオブジェクトを表示リストに追加します。</p> |
| |
| <p class="- topic/p ">さらに、Timer オブジェクトを開始します。1 秒ごとに Timer オブジェクトのタイマーイベントが送出され、<codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> メソッドが呼び出されます。<codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> メソッドが表示され、Camera オブジェクトのいくつかのプロパティが更新されます。 </p> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>この例では、変更されるプロパティは <codeph class="+ topic/ph pr-d/codeph ">currentFPS</codeph> プロパティのみです。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.media.Camera; |
| import flash.media.Video; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.utils.Timer; |
| import flash.events.TimerEvent; |
| import flash.events.StatusEvent; |
| import flash.events.MouseEvent; |
| import flash.system.SecurityPanel; |
| import flash.system.Security; |
| |
| public class Camera_getCameraExample extends Sprite { |
| private var myTextField:TextField; |
| private var cam:Camera; |
| private var t:Timer = new Timer(1000); |
| |
| public function Camera_getCameraExample() { |
| myTextField = new TextField(); |
| myTextField.x = 10; |
| myTextField.y = 10; |
| myTextField.background = true; |
| myTextField.selectable = false; |
| myTextField.autoSize = TextFieldAutoSize.LEFT; |
| |
| if (Camera.isSupported) |
| { |
| cam = Camera.getCamera(); |
| |
| if (!cam) { |
| myTextField.text = "No camera is installed."; |
| |
| } else if (cam.muted) { |
| myTextField.text = "To enable the use of the camera,\n" |
| + "please click on this text field.\n" |
| + "When the Flash Player Settings dialog appears,\n" |
| + "make sure to select the Allow radio button\n" |
| + "to grant access to your camera."; |
| |
| myTextField.addEventListener(MouseEvent.CLICK, clickHandler); |
| |
| }else { |
| myTextField.text = "Connecting"; |
| connectCamera(); |
| } |
| |
| addChild(myTextField); |
| |
| t.addEventListener(TimerEvent.TIMER, timerHandler); |
| }else { |
| myTextField.text = "The Camera class is not supported on this device."; |
| } |
| } |
| |
| private function clickHandler(e:MouseEvent):void { |
| Security.showSettings(SecurityPanel.PRIVACY); |
| |
| cam.addEventListener(StatusEvent.STATUS, statusHandler); |
| |
| myTextField.removeEventListener(MouseEvent.CLICK, clickHandler); |
| } |
| |
| private function statusHandler(event:StatusEvent):void { |
| |
| if (event.code == "Camera.Unmuted") { |
| connectCamera(); |
| cam.removeEventListener(StatusEvent.STATUS, statusHandler); |
| } |
| } |
| |
| private function connectCamera():void { |
| var vid:Video = new Video(cam.width, cam.height); |
| vid.x = 10; |
| vid.y = 10; |
| vid.attachCamera(cam); |
| addChild(vid); |
| |
| t.start(); |
| } |
| |
| private function timerHandler(event:TimerEvent):void { |
| myTextField.y = cam.height + 20; |
| myTextField.text = ""; |
| myTextField.appendText("bandwidth: " + cam.bandwidth + "\n"); |
| myTextField.appendText("currentFPS: " + Math.round(cam.currentFPS) + "\n"); |
| myTextField.appendText("fps: " + cam.fps + "\n"); |
| myTextField.appendText("keyFrameInterval: " + cam.keyFrameInterval + "\n"); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/index" class="- topic/link "><linktext class="- topic/linktext ">index</linktext></link><link href="flash.media.xml#Camera/muted" class="- topic/link "><linktext class="- topic/linktext ">muted</linktext></link><link href="flash.media.xml#Camera/names" class="- topic/link "><linktext class="- topic/linktext ">names</linktext></link><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link><link href="flash.media.xml#Camera/event:status" class="- topic/link "><linktext class="- topic/linktext ">status</linktext></link><link href="flash.media.xml#Video/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">Video.attachCamera()</linktext></link></related-links><adobeApiEvent id="flash.media:Camera:getCamera_status" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">status</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:StatusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">カメラがそのステータスをレポートしたときに送出されます。カメラにアクセスする前に、Flash Player にはプライバシーダイアログボックスが表示されて、ユーザーがカメラへのアクセスを許可または拒否することができます。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Camera.muted"</codeph> である場合、SWF ファイルのカメラへのアクセス許可を拒否したことになります。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Camera.Unmuted"</codeph> の場合、SWF ファイルがユーザーのカメラにアクセスすることをユーザーが許可しています。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">カメラがそのステータスをレポートしたときに送出されます。</shortdesc></adobeApiEvent></apiOperation><apiOperation id="flash.media:Camera:setKeyFrameInterval" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setKeyFrameInterval</apiName><shortdesc class="- topic/shortdesc "> |
| ビデオ圧縮アルゴリズムによって補間されずに完全に送信されるビデオフレーム (キーフレームと呼ばれる) を指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">keyFrameInterval</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ビデオ圧縮アルゴリズムによって補間されるのではなく、（キーフレームとして）完全送信されるビデオフレームを指定する値です。1 を指定すると、すべてのフレームがキーフレームになり、3 を指定すると、3 つのフレームごとにフレームがキーフレームになります（以下同様）。有効な値は、1 ～ 48 です。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ビデオ圧縮アルゴリズムによって補間されるのではなく、（<i class="+ topic/ph hi-d/i ">キーフレーム</i>と呼ばれる）完全送信されるビデオフレームを指定します。このメソッドは、Flash Media Server を使用してビデオを送信している場合にだけ使用できます。 |
| |
| <p class="- topic/p ">Flash Video 圧縮アルゴリズムでは、ビデオの最後のフレームからの変更のみを送信して、ビデオを圧縮します。これらの変更部分が補間フレームと見なされます。ビデオのフレームは、前のフレームの内容に応じて補間されます。ただし、キーフレームは完全なビデオフレームであるため、前のフレームから補間されることはありません。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> パラメーターの値を設定する方法を判別するには、帯域幅の使用量とビデオ再生アクセシビリティの両方を検討します。例えば、<codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> に対して大きい値を指定すると（キーフレームの送信が少なくなる）、帯域幅の使用量が減少します。ただし、これはビデオの特定のポイントで再生ヘッドの位置を指定する際に要する時間を増やすことになります。つまり、ビデオを再開する際、より多くの先行ビデオフレームを補間しなければならない場合があります。</p> |
| |
| <p class="- topic/p ">逆に、<codeph class="+ topic/ph pr-d/codeph ">keyFrameInterval</codeph> に対して小さい値を指定すると（キーフレームの送信が多くなる）、ビデオフレーム全体の送信が多くなるため、帯域幅の使用量が増加しますが、録画済みのビデオ内で特定のビデオフレームをシークする際に要する時間は減ります。</p> |
| |
| </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 "> |
| カメラのローカルビューに対して圧縮したビデオストリームを使用するかどうかを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">compress</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">カメラが受け取るローカルビューに対して、圧縮したビデオストリーム（<codeph class="+ topic/ph pr-d/codeph ">true</codeph>）を使用するか、または圧縮されていないストリーム（<codeph class="+ topic/ph pr-d/codeph ">false</codeph>）を使用するかを指定します。 |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| カメラのローカルビューに対して圧縮したビデオストリームを使用するかどうかを指定します。このメソッドは、Flash Media Server を使用してビデオを送信している場合にだけ使用できます。<codeph class="+ topic/ph pr-d/codeph ">compress</codeph> を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定すると、リアルタイムで表示したときの、ユーザーに対するビデオの表示状態をより正確に確認できます。 |
| |
| <p class="- topic/p ">圧縮したストリームは、ビデオの品質設定のプレビューなど、テスト目的で使用する場合には役立ちますが、ローカルビューは単に圧縮されるだけではないので、非常に処理コストがかかります。ローカルビューは圧縮された後、ライブ接続で送信する場合と同じように編集され、さらにローカルで表示するために解凍されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">compress</codeph> を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定した場合に使用する圧縮率を設定するには、<codeph class="+ topic/ph pr-d/codeph ">Camera.setQuality()</codeph> を使用します。</p> |
| |
| </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 "> |
| カメラのキャプチャモードを指定の要件に最も近いネイティブモードに設定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">width</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要求されたキャプチャの幅（ピクセル単位）です。デフォルト値は 160 です。 |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">height</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">要求されたキャプチャの高さ（ピクセル単位）です。デフォルト値は 120 です。 |
| </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 ">要求されたデータキャプチャレート（1 秒あたりのフレーム数）です。デフォルト値は 15 です。 |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">favorArea</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">true</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">指定要件に合うネイティブモードがカメラにない場合に、幅、高さ、フレームレートをどのように操作するかを指定します。デフォルト値は <codeph class="+ topic/ph pr-d/codeph ">true</codeph> で、キャプチャサイズを維持することを示します。このパラメーターを使用すると、<codeph class="+ topic/ph pr-d/codeph ">width</codeph> 値と <codeph class="+ topic/ph pr-d/codeph ">height</codeph> 値に最も近いモードが選択されます。ただし、これによりフレームレートが低下し、パフォーマンスに悪影響を及ぼすことがあります。カメラの高さと幅よりも最大フレームレートを優先するには、<codeph class="+ topic/ph pr-d/codeph ">false</codeph> を <codeph class="+ topic/ph pr-d/codeph ">favorArea</codeph> パラメーターに指定します。 |
| |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| カメラのキャプチャモードを指定の要件に最も近いネイティブモードに設定します。指定したすべてのパラメーターに一致するネイティブモードがカメラにない場合は、要求したモードに最も近いキャプチャモードが選択されます。これにより、画像の一部が切り取られたり、フレームが削除される可能性があります。 |
| |
| <p class="- topic/p ">デフォルトでは、画像のサイズを維持するために、必要に応じてフレームが削除されます。削除されるフレームの数を最小限に抑えるには、<codeph class="+ topic/ph pr-d/codeph ">false</codeph> を <codeph class="+ topic/ph pr-d/codeph ">favorArea</codeph> パラメーターで渡します。ただし、これによって画像のサイズは小さくなります。</p> |
| |
| <p class="- topic/p ">ネイティブモードを選択した場合は、指定した縦横比ができる限り維持されます。例えば、<codeph class="+ topic/ph pr-d/codeph ">myCam.setMode(400, 400, 30)</codeph> コマンドを実行し、そのカメラで利用できる最大の幅と高さが 320 および 288 である場合は、幅と高さがともに 288 に設定されます。幅と高さを同じ値に設定することで、要求された 1:1 の縦横比が維持されます。</p> |
| |
| <p class="- topic/p ">要求した値に最も近いモードが選択された後に、割り当てられた幅、高さ、ビデオキャプチャレートを調べるには、<codeph class="+ topic/ph pr-d/codeph ">width</codeph>、<codeph class="+ topic/ph pr-d/codeph ">height</codeph>、および <codeph class="+ topic/ph pr-d/codeph ">fps</codeph> の各プロパティを使用します。</p> |
| |
| <p class="- topic/p "> |
| Flash Media Server を使用する場合は、単一のフレームのキャプチャまたはコマ撮り写真の作成もできます。詳細については、<codeph class="+ topic/ph pr-d/codeph ">NetStream.attachCamera()</codeph> のトピックを参照してください。 |
| </p> |
| |
| </apiDesc><example conref="examples\Camera_setModeExample.as" class="- topic/example "> 次の例では、ユーザーがステージをクリックするとビデオのサイズが変更され、キャプチャレート（1 秒あたりのフレーム数）が新しい値に設定されます。 |
| |
| <p class="- topic/p ">ステージは拡大 / 縮小されないように設定されます。<codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> メソッドは、カメラオブジェクトへの参照を返します。利用できるカメラがない場合、またはカメラが取り付けられていない場合は、null を返します。カメラが存在する場合は、<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> メソッドが呼び出されます。<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> メソッドは、ビデオオブジェクトをインスタンス化します。カメラでキャプチャされたビデオを表示するため、ビデオストリームへの参照をビデオオブジェクトに関連付けて、ビデオオブジェクトを表示リストに追加します。<codeph class="+ topic/ph pr-d/codeph ">MouseEvent.CLICK</codeph> イベントのイベントリスナーも設定します。ユーザーがステージをクリックすると、<codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドが呼び出されます。 このメソッドはキャプチャされたビデオの幅を確認し、カメラキャプチャモードの幅、高さおよび必要なキャプチャレート（1 秒あたりのフレーム数）を設定します。これらの設定を有効にするために、ビデオオブジェクトを削除して再作成する必要があります。また、ビデオの幅と高さをカメラオブジェクトの幅と高さに設定する必要があります。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.media.Camera; |
| import flash.media.Video; |
| import flash.events.MouseEvent; |
| import flash.display.StageScaleMode; |
| |
| public class Camera_setModeExample extends Sprite { |
| private var cam:Camera; |
| private var vid:Video; |
| |
| public function Camera_setModeExample() { |
| stage.scaleMode = StageScaleMode.NO_SCALE; |
| |
| cam = Camera.getCamera(); |
| |
| if (!cam) { |
| trace("No camera is installed."); |
| }else { |
| connectCamera(); |
| } |
| } |
| |
| private function connectCamera():void { |
| vid = new Video(); |
| vid.width = cam.width; |
| vid.height = cam.height; |
| vid.attachCamera(cam); |
| addChild(vid); |
| |
| stage.addEventListener(MouseEvent.CLICK, clickHandler); |
| } |
| |
| private function clickHandler(e:MouseEvent):void { |
| |
| switch (cam.width) { |
| case 160: |
| cam.setMode(320, 240, 10); |
| break; |
| case 320: |
| cam.setMode(640, 480, 5); |
| break; |
| default: |
| cam.setMode(160, 120, 15); |
| break; |
| } |
| |
| removeChild(vid); |
| connectCamera(); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/fps" class="- topic/link "><linktext class="- topic/linktext ">fps</linktext></link><link href="flash.media.xml#Camera/height" class="- topic/link "><linktext class="- topic/linktext ">height</linktext></link><link href="flash.media.xml#Camera/width" class="- topic/link "><linktext class="- topic/linktext ">width</linktext></link><link href="flash.net.xml#NetStream/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.attachCamera()</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Camera:setMotionLevel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setMotionLevel</apiName><shortdesc class="- topic/shortdesc "> |
| 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 |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">motionLevel</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントを送出するために必要なモーションの量を指定します。使用可能な値の範囲は 0 ～ 100 です。デフォルト値は 50 です。 |
| |
| </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 ">アクティビティがない場合に、アクティビティが停止したと判定して <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントを送出するまでの経過時間をミリ秒単位で指定します。デフォルト値は 2000 ミリ秒（2 秒）です。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントを送出するために必要なモーションの量を指定します。アクティビティがない場合に、モーションが停止したと判定してイベントを送出するまでの時間をミリ秒単位で設定することもできます。 |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>ビデオは <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph> パラメーターの値に関係なく表示できます。このパラメーターは、ビデオを実際にキャプチャまたは表示するかどうかではなく、イベントを送出するタイミングと状況のみを決定します。</p> |
| <p class="- topic/p "> |
| カメラがモーションをまったく検知しないようにするには、<codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph> パラメーターに 100 を指定します。この場合、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントは送出されません。この値は、通常はテスト目的にのみ使用します。例えば、イベントが送出されたときに通常トリガーされるハンドラーを一時的に無効にする場合などに使用します。 |
| </p> |
| <p class="- topic/p "> |
| カメラが現在検知しているモーションの量を調べるには、<codeph class="+ topic/ph pr-d/codeph ">activityLevel</codeph> プロパティを使用します。モーションの精度（sensitivity）の値がアクティビティの値に直接対応します。モーションがまったく存在しない場合、アクティビティ値は 0 です。継続的にモーションが発生している場合、アクティビティ値は 100 です。移動していない場合、アクティビティ値はモーション精度値よりも低くなります。移動している場合、アクティビティ値は頻繁にモーション精度値を超えます。 |
| </p> |
| <p class="- topic/p "> |
| このメソッドの目的は <codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> メソッドに似ています。どちらのメソッドも、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントの送出方法を指定するために使用します。ただし、パブリッシュするストリームに対する影響という点では、この 2 つのメソッドは大きく異なります。 |
| </p> |
| |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> は帯域幅を最適化するように設計されています。オーディオストリームが無音と考えられる場合には、オーディオデータは送信されません。代わりに、無音状態が始まったことを示すメッセージが送信されます。 </li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> はモーションを検知し、使用する帯域幅には影響しないように設計されています。ビデオストリームでモーションが検知されない間も、ビデオは送信されます。</li></ul> |
| |
| |
| |
| </apiDesc><example conref="examples\Camera_setMotionLevelExample.as" class="- topic/example "> 次の例では、ユーザーのカメラをモニターまたは監視カメラとして使用します。カメラがモーションを検知すると、テキストフィールドにアクティビティレベルが表示されます。この例を拡張して、アラームを鳴らしたり、Web サービスを通じて他のアプリケーションにメッセージを送信したりすることも可能です。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Camera.getCamera()</codeph> メソッドは、カメラオブジェクトへの参照を返します。利用できるカメラがない場合、またはカメラが取り付けられていない場合は、null を返します。if ステートメントでカメラが利用できるかどうかをチェックし、利用できる場合は <codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> メソッドを呼び出します。<codeph class="+ topic/ph pr-d/codeph ">connectCamera()</codeph> メソッドは、キャプチャされたストリームの幅と高さを使用してビデオオブジェクトをインスタンス化します。カメラでキャプチャされたビデオを表示するため、ビデオストリームへの参照をビデオオブジェクトに関連付けて、ビデオオブジェクトを表示リストに追加します。通常は <codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> メソッドが呼び出されると、Flash Player によるカメラへのアクセスを許可するかどうかをユーザーに確認するダイアログボックスが表示されます。 ただし、ユーザーがアクセスを拒否し、<codeph class="+ topic/ph pr-d/codeph ">「後で確認」</codeph>オプションを選択した場合、ダイアログボックスは表示されず、何も表示されません。 ユーザーがカメラへのアクセスを許可するオプションを確実に設定できるようにするため、<codeph class="+ topic/ph pr-d/codeph ">system.Security.showSettings()</codeph> メソッドを使用して Flash Player 設定ダイアログボックスを表示します。</p> |
| |
| <p class="- topic/p ">アクティビティイベントが呼び出される前に、<codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph> メソッドによってアクティビティのレベル（モーションの量）を 5（わずかな動きも検出する）に設定します。カメラがモーション検知を停止してからアクティビティイベントが呼び出されるまでの時間を 1 秒（1000 ミリ秒）に設定します。アクティビティなしの状態で 1 秒が経過するか、またはアクティビティのレベルが 5 に達すると、<codeph class="+ topic/ph pr-d/codeph ">ActivityEvent.ACTIVITY</codeph> イベントが送出され、<codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> メソッドが呼び出されます。アクティビティのレベルによってイベントがトリガーされた場合、<codeph class="+ topic/ph pr-d/codeph ">activating</codeph> プロパティが <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定され、Timer オブジェクトが開始されます。1 秒ごとに Timer オブジェクトのタイマーイベントが送出され、<codeph class="+ topic/ph pr-d/codeph ">timerHandler()</codeph> メソッドが呼び出され、現在のアクティビティレベルが表示されます。（5 以上のレベルによりタイマーがトリガーされますが、表示される現在のアクティビティのレベルはそれより小さい数値になる場合があります。）</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.media.Camera; |
| import flash.media.Video; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.utils.Timer; |
| import flash.events.TimerEvent; |
| import flash.events.ActivityEvent; |
| |
| public class Camera_setMotionLevelExample extends Sprite { |
| private var myTextField:TextField; |
| private var cam:Camera; |
| private var t:Timer = new Timer(1000); |
| |
| public function Camera_setMotionLevelExample() { |
| myTextField = new TextField(); |
| myTextField.background = true; |
| myTextField.selectable = false; |
| myTextField.autoSize = TextFieldAutoSize.LEFT; |
| |
| cam = Camera.getCamera(); |
| |
| if (!cam) { |
| myTextField.text = "No camera is installed."; |
| |
| }else { |
| myTextField.text = "Waiting to connect."; |
| connectCamera(); |
| } |
| |
| addChild(myTextField); |
| |
| t.addEventListener(TimerEvent.TIMER, timerHandler); |
| } |
| |
| private function connectCamera():void { |
| var vid:Video = new Video(cam.width, cam.height); |
| vid.x = 10; |
| vid.y = 10; |
| vid.attachCamera(cam); |
| addChild(vid); |
| |
| cam.setMotionLevel(5, 1000); |
| cam.addEventListener(ActivityEvent.ACTIVITY, activityHandler); |
| } |
| |
| private function activityHandler(e:ActivityEvent):void { |
| if (e.activating == true) { |
| t.start(); |
| } else { |
| myTextField.text = "Everything is quiet."; |
| t.stop(); |
| } |
| } |
| |
| private function timerHandler(event:TimerEvent):void { |
| myTextField.x = 10; |
| myTextField.y = cam.height + 20; |
| myTextField.text = "There is some activity. Level: " + cam.activityLevel; |
| } |
| } |
| } |
| </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 "> |
| 現在の送信ビデオフィードの 1 秒あたりの最大帯域幅、または必要な画質を設定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera.setQuality, setQuality |
| </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 ">現在の送信ビデオフィードで使用できる最大帯域幅（1 秒あたりのバイト数）を指定します。<codeph class="+ topic/ph pr-d/codeph ">quality</codeph> の値を維持するために必要な帯域幅を Flash Player のビデオが使用できるように指定するには、<codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> で 0 を渡します。デフォルト値は 16384 です。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">quality</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">必要な画質レベルを指定する整数です。各ビデオフレームに適用される圧縮率によって決まります。指定できる値は 1（最低品質、最大圧縮率）から 100（最高品質、圧縮なし）までです。帯域幅を超過するのを避けるために必要に応じて画質を変更するには、<codeph class="+ topic/ph pr-d/codeph ">quality</codeph> に 0 を指定します。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在の送信ビデオフィードの 1 秒あたりの最大帯域幅、または必要な画質を設定します。一般に、このメソッドは、Flash Media Server を使用してビデオを送信している場合にだけ使用します。 |
| |
| <p class="- topic/p ">このメソッドを使用して、送信ビデオフィードの要素として帯域幅と画質のどちらがそのアプリケーションにとって重要かを指定します。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">帯域幅の使用量を優先する場合は、<codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> に数値を、<codeph class="+ topic/ph pr-d/codeph ">quality</codeph> に 0 を指定します。こうすると、指定した帯域幅内で最高品質のビデオが送信されます。必要であれば、指定の帯域幅を超えるのを防ぐために、画質が下げられます。一般には、モーションが増えるほど、画質は下がります。</li><li class="- topic/li ">画質を優先する場合は、<codeph class="+ topic/ph pr-d/codeph ">bandwidth</codeph> に 0 を、<codeph class="+ topic/ph pr-d/codeph ">quality</codeph> に数値を指定します。こうすると、指定した画質を維持するために必要なだけの帯域幅が使われます。必要であれば、画質を維持するためにフレームレートが下げられます。一般には、モーションが増えるほど、使用する帯域幅も増加します。</li><li class="- topic/li ">帯域幅と品質の両方の重要性が同程度である場合は、両方のパラメーターに数値を指定します。指定の品質を達成でき、指定の帯域幅を超えない範囲のビデオが送信されます。必要であれば、指定の帯域幅を超えることなく画質を維持するために、フレームレートが下げられます。</li></ul> |
| |
| </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 "> |
| カメラが検知しているモーション量です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| カメラが検知しているモーション量です。0（モーションは検知されていない）から 100（大量のモーションが検知されている）までの値が設定されます。このプロパティの値は、<codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph> メソッドに設定を渡す必要があるかどうかを判断するのに役立ちます。 |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Video.attachCamera()</codeph> メソッドが呼び出されていないため、使用可能なカメラがまだ使用されていない場合は、このプロパティが -1 に設定されます。</p> |
| <p class="- topic/p ">圧縮されていないローカルビデオだけをストリーミングする場合、このプロパティはイベントハンドラーに関数を割り当て済みであるときに限り設定されます。それ以外の場合は undefined になります。</p> |
| |
| </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 "> |
| 現在の送信ビデオフィードで使用できる最大帯域幅（バイト単位）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| 現在の送信ビデオフィードで使用できる最大帯域幅（バイト単位）です。値 0 は、ビデオのフレーム品質を維持するために必要な帯域幅をフィードで使用できることを示します。 |
| <p class="- topic/p ">このプロパティの値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">setQuality()</codeph> メソッドを使用します。</p> |
| |
| </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 "> |
| 現在のデータキャプチャレート（1 秒あたりのフレーム数）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.currentFPS, currentFPS |
| </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 "> |
| 現在のデータキャプチャレート（1 秒あたりのフレーム数）です。このプロパティを設定することはできません。ただし、<codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> メソッドを使用すると、これに関係する <codeph class="+ topic/ph pr-d/codeph ">fps</codeph> プロパティを設定することができます。このプロパティは、データをキャプチャする際の希望最大フレームレートを指定します。 |
| |
| </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 "> |
| カメラの最大データキャプチャレート（1 秒あたりのフレーム数）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.fps, fps |
| </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 "> |
| カメラの最大データキャプチャレート（1 秒あたりのフレーム数）です。最大データキャプチャレートは、カメラの性能によって異なります。このフレームレートを実現できない場合があります。 |
| <ul class="- topic/ul "><li class="- topic/li ">このプロパティに必要な値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> メソッドを使用します。</li><li class="- topic/li ">現在のデータキャプチャレートを調べるには、<codeph class="+ topic/ph pr-d/codeph ">currentFPS</codeph> プロパティを使用します。</li></ul> |
| |
| </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 "> |
| 現在のキャプチャの高さ（ピクセル単位）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| 現在のキャプチャの高さ（ピクセル単位）です。このプロパティに値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> メソッドを使用します。 |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/width" class="- topic/link "><linktext class="- topic/linktext ">width</linktext></link><link href="flash.media.xml#Camera/setMode()" class="- topic/link "><linktext class="- topic/linktext ">setMode()</linktext></link></related-links></apiValue><apiValue id="flash.media:Camera:index:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">index</apiName><shortdesc class="- topic/shortdesc "> |
| カメラのインデックスを指定するゼロから始まる整数です。これは、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 |
| </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 "> |
| カメラのインデックスを指定するゼロから始まる整数です。これは、<codeph class="+ topic/ph pr-d/codeph ">names</codeph> プロパティから返される配列のインデックスと同じです。 |
| |
| </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 "> |
| 現在のプラットフォームで Camera クラスがサポートされている場合、isSupported プロパティは true に設定されます。サポートされていない場合は、false に設定されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在のプラットフォームで Camera クラスがサポートされている場合、<codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> プロパティは <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定されます。サポートされていない場合は、<codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定されます。 |
| |
| </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 "> |
| ビデオ圧縮アルゴリズムによって補間されるのではなく、完全送信されるビデオフレーム（キーフレームと呼ばれる）の数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| ビデオ圧縮アルゴリズムによって補間されるのではなく、完全送信されるビデオフレーム（<i class="+ topic/ph hi-d/i ">キーフレーム</i>と呼ばれる）の数です。デフォルト値は 15 で、15 のフレームごとにフレームがキーフレームになります。1 はすべてのフレームがキーフレームであることを意味します。設定できる値は、1 ～ 48 です。 |
| |
| </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 "> |
| カメラがキャプチャするローカルビューを、Flash Media Server を使用したライブ送信で使用されるように圧縮および解凍する（true）か、または圧縮されていない状態にする（false）かを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></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 "> |
| カメラがキャプチャするローカルビューを、Flash Media Server を使用したライブ送信で使用されるように圧縮および解凍する（<codeph class="+ topic/ph pr-d/codeph ">true</codeph>）か、または圧縮されていない状態にする（<codeph class="+ topic/ph pr-d/codeph ">false</codeph>）かを示します。デフォルト値は <codeph class="+ topic/ph pr-d/codeph ">false</codeph> です。 |
| |
| <p class="- topic/p "> |
| 圧縮したストリームは、ビデオの品質設定のプレビューなど、テスト目的で使用する場合には役立ちますが、非常に処理コストがかかります。ローカルビューは圧縮され、送信するためにライブ接続で使用されるように編集され、さらにローカルで表示するために解凍されます。 |
| </p> |
| |
| <p class="- topic/p ">この値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">Camera.setLoopback()</codeph> を使用します。このプロパティが true である場合に使用する圧縮率を設定するには、<codeph class="+ topic/ph pr-d/codeph ">Camera.setQuality()</codeph> を使用します。</p> |
| |
| </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 "> |
| 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 |
| </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 "> |
| <codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントを送出するために必要なモーションの量です。使用可能な値の範囲は 0 ～ 100 です。デフォルト値は 50 です。 |
| <p class="- topic/p ">ビデオは <codeph class="+ topic/ph pr-d/codeph ">motionLevel</codeph> プロパティの値に関係なく表示できます。詳細については、<codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph>を参照してください。</p> |
| |
| </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 "> |
| カメラがモーション検知を停止してから、activity イベントが呼び出されるまでの時間（ミリ秒単位）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.motionTimeout, motionTimeout |
| </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 "> |
| カメラがモーション検知を停止してから、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントが呼び出されるまでの時間（ミリ秒単位）です。デフォルト値は 2000（2 秒）です。 |
| <p class="- topic/p ">この値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">setMotionLevel()</codeph> を使用します。 </p> |
| |
| </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 "> |
| ユーザーが Flash Player のプライバシーダイアログボックスでカメラへのアクセスを拒否した（true）か、許可した（false）かを示すブール値です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Camera, video, Camera.muted, muted |
| </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 "> |
| ユーザーが Flash Player のプライバシーダイアログボックスでカメラへのアクセスを拒否した（<codeph class="+ topic/ph pr-d/codeph ">true</codeph>）か、許可した（<codeph class="+ topic/ph pr-d/codeph ">false</codeph>）かを示すブール値です。この値が変わると、<codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベントが送出されます。 |
| |
| </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 "> |
| カメラのハードウェアから返される、現在のカメラの名前です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| カメラのハードウェアから返される、現在のカメラの名前です。 |
| |
| </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 "> |
| Adobe 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 |
| </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 "> |
| Adobe Flash Player 設定パネルの「プライバシー」を表示せずに、使用できるすべてのカメラの名前を示すストリング配列です。この配列は ActionScript の他の配列と同じように動作します。この配列を使用して、それぞれのカメラの 0 から始まるインデックスと、システム上のカメラの数（<codeph class="+ topic/ph pr-d/codeph ">names.length</codeph>）を調べることができます。詳細については、Array クラスの <codeph class="+ topic/ph pr-d/codeph ">names</codeph> を参照してください。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">names</codeph> プロパティを呼び出すと、ハードウェアを広範囲にわたって調べる必要があります。ほとんどの場合は、デフォルトのカメラを使用できます。</p> |
| |
| <p class="- topic/p ">Android では、デバイスに複数のカメラデバイスが搭載されている場合でも、1 台のカメラのみがサポートされます。カメラの名前は常に「Default」です。</p> |
| |
| </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 "> |
| 必要な画質レベルです。各ビデオフレームに適用される圧縮率によって決まります。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| 必要な画質レベルです。各ビデオフレームに適用される圧縮率によって決まります。指定できる品質値は 1（最低品質、最大圧縮率）～ 100（最高品質、圧縮なし）です。デフォルト値は 0 です。これは、使用できる帯域幅を超えることがないように、画質が必要に応じて変更されることを示します。 |
| |
| <p class="- topic/p ">このプロパティの値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">setQuality()</codeph> メソッドを使用します。</p> |
| </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 "> |
| 現在のキャプチャの幅（ピクセル単位）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| 現在のキャプチャの幅（ピクセル単位）です。このプロパティに必要な値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">setMode()</codeph> メソッドを使用します。 |
| |
| </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 "> |
| 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> |
| |
| </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 "> |
| SoundTransform クラスにはボリュームとパンのプロパティが含まれます。 |
| |
| </apiDesc><example conref="examples\SoundTransformExample.as" class="- topic/example "> 次の例では、MP3 ファイルをロードして再生します。MP3 ファイルの再生中に、マウスまたはその他の入力デバイスを動かします。ステージ上でユーザー入力デバイスを動かすにつれて、ボリュームとパンが変わります。この例を実行するには、MySound.mp3 ファイルを SWF ファイルと同じディレクトリに配置します。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.display.StageAlign; |
| import flash.display.StageScaleMode; |
| import flash.events.*; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.media.SoundTransform; |
| import flash.net.URLRequest; |
| import flash.utils.Timer; |
| |
| public class SoundTransformExample extends Sprite { |
| private var url:String = "MySound.mp3"; |
| private var soundFactory:Sound; |
| private var channel:SoundChannel; |
| private var positionTimer:Timer; |
| |
| public function SoundTransformExample() { |
| stage.align = StageAlign.TOP_LEFT; |
| stage.scaleMode = StageScaleMode.NO_SCALE; |
| |
| var request:URLRequest = new URLRequest(url); |
| soundFactory = new Sound(); |
| soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); |
| soundFactory.load(request); |
| channel = soundFactory.play(); |
| stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler); |
| } |
| |
| private function ioErrorHandler(event:Event):void { |
| trace("ioErrorHandler: " + event); |
| } |
| |
| private function setPan(pan:Number):void { |
| trace("setPan: " + pan.toFixed(2)); |
| var transform:SoundTransform = channel.soundTransform; |
| transform.pan = pan; |
| channel.soundTransform = transform; |
| } |
| |
| private function setVolume(volume:Number):void { |
| trace("setVolume: " + volume.toFixed(2)); |
| var transform:SoundTransform = channel.soundTransform; |
| transform.volume = volume; |
| channel.soundTransform = transform; |
| } |
| |
| private function mouseMoveHandler(event:MouseEvent):void { |
| var halfStage:uint = Math.floor(stage.stageWidth / 2); |
| var xPos:uint = event.stageX; |
| var yPos:uint = event.stageY; |
| var value:Number; |
| var pan:Number; |
| |
| if (xPos > halfStage) { |
| value = xPos / halfStage; |
| pan = value - 1; |
| } else if (xPos < halfStage) { |
| value = (xPos - halfStage) / halfStage; |
| pan = value; |
| } else { |
| pan = 0; |
| } |
| |
| var volume:Number = 1 - (yPos / stage.stageHeight); |
| |
| setVolume(volume); |
| setPan(pan); |
| |
| } |
| } |
| } |
| </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 "> |
| 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> |
| |
| </refpath></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">vol</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ボリュームです。範囲は 0（無音）～ 1（フルボリューム）です。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">panning</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">サウンドの左から右へのパンです。範囲は -1（完全に左へパン）～ 1（完全に右へパン）です。0 はパンなし（中央）を表します。 |
| |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| SoundTransform オブジェクトを作成します。 |
| |
| </apiDesc><example conref="examples\SoundTransform_constructorExample.as" class="- topic/example "> 次の例では、サウンドは右チャンネルからのみ再生され、ボリュームは 50 ％に設定されます。 |
| |
| <p class="- topic/p ">コンストラクターで、サウンドがロードされ、サウンドチャンネル（<codeph class="+ topic/ph pr-d/codeph ">channel</codeph>）に割り当てられます。 SoundTranform オジェクト（<codeph class="+ topic/ph pr-d/codeph ">transform</codeph>）も作成されます。最初の引数では、ボリュームが 50% に設定されます（範囲は 0.0 ～ 1.0）。2 番目の引数では、パンが設定されます。この例では、パンは 1.0 に設定され、サウンドが右スピーカーからのみ再生されることを意味します。これらの設定を有効にするために、<codeph class="+ topic/ph pr-d/codeph ">transform</codeph> SoundTranform オブジェクトを、サウンドチャンネルの <codeph class="+ topic/ph pr-d/codeph ">souundTransform</codeph> プロパティに割り当てます。</p> |
| <p class="- topic/p "> <b class="+ topic/ph hi-d/b ">注意：</b>この例には、限定されたエラー処理が記述されています。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.URLRequest; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.media.SoundTransform; |
| import flash.events.IOErrorEvent; |
| |
| public class SoundTransform_constructorExample extends Sprite |
| { |
| public function SoundTransform_constructorExample() { |
| var mySound:Sound = new Sound(); |
| var url:URLRequest = new URLRequest("mySound.mp3"); |
| var channel:SoundChannel; |
| var transform:SoundTransform = new SoundTransform(0.5, 1.0); |
| |
| mySound.load(url); |
| channel = mySound.play(); |
| channel.soundTransform = transform; |
| |
| mySound.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); |
| } |
| |
| private function errorHandler(errorEvent:IOErrorEvent):void { |
| trace("The sound could not be loaded: " + errorEvent.text); |
| } |
| } |
| } |
| </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 "> |
| 左スピーカーで再生する左入力データの量を指定する値 0（なし）～ 1（すべて）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| 左スピーカーで再生する左入力データの量を指定する値 0（なし）～ 1（すべて）です。 |
| |
| </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 "> |
| 右スピーカーで再生する左入力データの量を指定する値 0（なし）～ 1（すべて）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| 右スピーカーで再生する左入力データの量を指定する値 0（なし）～ 1（すべて）です。 |
| |
| </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 "> |
| サウンドの左から右へのパンです。範囲は -1（完全に左へパン）～ 1（完全に右へパン）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| サウンドの左から右へのパンです。範囲は -1（完全に左へパン）～ 1（完全に右へパン）です。0 はパンなし（左右のバランスをとった中央）を表します。 |
| |
| </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 "> |
| 左スピーカーで再生する右入力データの量を指定する値 0（なし）～ 1（すべて）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| 左スピーカーで再生する右入力データの量を指定する値 0（なし）～ 1（すべて）です。 |
| |
| </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 "> |
| 右スピーカーで再生する右入力データの量を指定する値 0（なし）～ 1（すべて）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| 右スピーカーで再生する右入力データの量を指定する値 0（なし）～ 1（すべて）です。 |
| |
| </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 "> |
| ボリュームです。範囲は 0（無音）～ 1（フルボリューム）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| ボリュームです。範囲は 0（無音）～ 1（フルボリューム）です。 |
| |
| </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 "> |
| このクラスは、ステージビデオが現在使用可能かどうかを示す列挙を定義します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">ステージビデオが現在使用可能かどうかを示す列挙。 |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| このクラスは、ステージビデオが現在使用可能かどうかを示す列挙を定義します。 |
| </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 "> |
| ステージビデオは現在使用可能です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">ステージビデオは現在使用可能です。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ステージビデオは現在使用可能です。 |
| </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 "> |
| ステージビデオは現在使用できません。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">ステージビデオは現在使用できません。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ステージビデオは現在使用できません。 |
| </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 "> |
| StageWebView クラスを使用すると、ステージビューポートに HTML コンテンツが表示されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| StageWebView クラスを使用すると、ステージビューポートに HTML コンテンツが表示されます。 |
| |
| <p class="- topic/p ">StageWebView クラスを使用すると、HTMLLoader クラスがサポートされていないデバイスでも簡単に HTML コンテンツを表示できます。このクラスでは、StageWebView クラス自体のメソッドとプロパティを除いて、ActionScript と HTML コンテンツの間にやり取りはありません。例えば、ActionScript と JavaScipt の間で値を渡したり、関数を呼び出したりする方法はありません。</p> |
| |
| <p class="- topic/p ">AIR プロファイルのサポート：<i class="+ topic/ph hi-d/i "/>この機能はすべてのデスクトップオペレーティングシステムおよびモバイルデバイスでサポートされますが、テレビ用 AIR デバイスではサポートされません。<codeph class="+ topic/ph pr-d/codeph ">StageWebView.isSupported</codeph> プロパティを使用すると、サポートされているかどうかを実行時にテストすることができます。複数のプロファイル間での API サポートについて詳しくは、<xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR プロファイルのサポート</xref>を参照してください。</p> |
| |
| <p class="- topic/p ">デバイスのモバイルプロファイルおよび拡張モバイルプロファイルでは、StageWebView はデバイスのオペレーティングシステムに用意されているシステム Web コントロールを使用します。したがって、使用できる機能とレンダリングされる外観はデバイスによって異なる可能性があります。デスクトップコンピューター（デスクトッププロファイルおよび拡張デスクトッププロファイル）では、StageWebView は内部 AIR WebKit エンジンを使用します。使用できる機能とレンダリングされる外観は、HTMLLoader クラスの機能および外観と同じです（HTMLLoader インスタンスが提供する ActionScript および JavaScipt の間で密接な統合およびスクリプトブリッジがない場合）。現在のデバイスでこのクラスがサポートされているかどうかを判断するには、StageWebView クラスの <codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> プロパティをテストします。</p> |
| |
| <p class="- topic/p ">StageWebView クラスは表示オブジェクトではないため、Flash 表示リストに追加できません。代わりに <codeph class="+ topic/ph pr-d/codeph ">stage</codeph> プロパティを使用してステージに直接アタッチすることで、StageWebView オブジェクトを表示します。ステージにアタッチされている StageWebView インスタンスは、Flash 表示オブジェクトの上に表示されます。<codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> プロパティで、レンダリング領域のサイズと位置を制御します。複数の StageWebView オブジェクトの深度の順序を制御する方法はありません。重複する 2 つのインスタンスは推奨されません。</p> |
| |
| <p class="- topic/p ">StageWebView オブジェクト内のコンテンツにフォーカスがない場合、キーボードの入力を処理する最初の機会は StageWebView オブジェクトにあります。StageWebView オブジェクトをアタッチするステージは、処理されないキーボード入力を送出します。StageWebView インスタンスは表示リストの一部ではないため、通常のイベントキャプチャ/バブルサイクルはこの場合に適用されません。</p> |
| |
| <p class="- topic/p ">Android 3.0 以降では、AIR アプリケーション識別子の Android manifestAdditions 要素内でハードウェアアクセラレーションを有効にして、StageWebView オブジェクトでプラグインコンテンツを表示する必要があります。</p> |
| |
| </apiDesc><example conref="examples\StageWebViewExample.1.as" class="- topic/example "> 次の例では、ステージを塗るために StageWebView オブジェクトを設定します。この例では、<codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph> メソッドを使用して Web サイトをロードし、履歴の移動に、デバイスの「戻る」および「検索」ソフトキーを使用します。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.MovieClip; |
| import flash.media.StageWebView; |
| import flash.geom.Rectangle; |
| import flash.events.KeyboardEvent; |
| import flash.ui.Keyboard; |
| import flash.desktop.NativeApplication; |
| |
| public class StageWebViewExample extends MovieClip{ |
| |
| private var webView:StageWebView = new StageWebView(); |
| |
| public function StageWebViewExample() |
| { |
| webView.stage = this.stage; |
| webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); |
| webView.loadURL( "http://www.example.com" ); |
| |
| stage.addEventListener( KeyboardEvent.KEY_DOWN, onKey ); |
| } |
| |
| private function onKey( event:KeyboardEvent ):void |
| { |
| if( event.keyCode == Keyboard.BACK && webView.isHistoryBackEnabled ) |
| { |
| trace("Back."); |
| webView.historyBack(); |
| event.preventDefault(); |
| } |
| |
| if( event.keyCode == Keyboard.SEARCH && webView.isHistoryForwardEnabled ) |
| { |
| trace("Forward."); |
| webView.historyForward(); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="../../flash/html/HTMLLoader.html" class="- topic/link "><linktext class="- topic/linktext ">HTMLLoader クラス</linktext></link><link href="http://www.flashmobileblog.com/2010/06/18/air-on-android-tweetrapp-video-walk-through/" class="- topic/link "><linktext class="- topic/linktext ">Mark Doherty：AIR on 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：OAuth Support</linktext></link><link href="http://help.adobe.com/en_US/air/build/WSfffb011ac560372f-5d0f4f25128cc9cd0cb-7ffe.html#WS365a66ad37c9f5102ec8a8ba12f2d91095a-8000" class="- topic/link "><linktext class="- topic/linktext ">StageWebView オブジェクトで Flash Player プラグインおよびその他のプラグインを有効にする</linktext></link></related-links><adobeApiEvent id="flash.media:StageWebView_flash.events.FocusEvent_focusOut" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">focusOut</apiName><shortdesc class="- topic/shortdesc "> |
| StageWebView がフォーカスを放すときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| StageWebView がフォーカスを放すときに送出されます。 |
| |
| </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 "> |
| この StageWebView オブジェクトがフォーカスを受け取るときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.FocusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| この StageWebView オブジェクトがフォーカスを受け取るときに送出されます。 |
| |
| </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 "> |
| エラーが発生したことを通知します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| エラーが発生したことを通知します。 |
| |
| </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 "> |
| loadString() または loadURL() メソッドによって要求された最後のロード処理が完了したことを通知します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">loadString() または load() メソッドによって要求された最後のロード処理が完了したことを通知します。 |
| |
| </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| <codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> または <codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph> メソッドによって要求された最後のロード処理が完了したことを通知します。 |
| |
| </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 "> |
| StageWebView オブジェクトの location プロパティが変更されることを通知します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.LocationChangeEvent.LOCATION_CHANGING</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.LocationChangeEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">StageWebView オブジェクトの location プロパティが変更されることを通知します。 |
| |
| </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| StageWebView オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">location</codeph> プロパティが変更されることを通知します。 |
| |
| <p class="- topic/p ">locationChanging イベントが送出されるのは、HTML コンテンツ、またはユーザーがリンクをクリックしたときなどに StageWebView オブジェクト内で実行されるコードから、位置の変更が開始されるときのみです。デフォルトで、新しい場所はこの StageWebView オブジェクトに表示されます。デフォルトの動作をキャンセルするには、イベントオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">preventDefault()</codeph> メソッドを呼び出します。例えば、イベントオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">location</codeph> プロパティに基づいて、システムブラウザーのページを開くには、<codeph class="+ topic/ph pr-d/codeph ">flash.net.navigateToURL()</codeph> 関数を使用します</p> |
| |
| <p class="- topic/p ">次のメソッドで位置を変更した場合、locationChanging イベントは送出されません。</p> |
| <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> |
| |
| </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 "> |
| StageWebView オブジェクトの location プロパティが変更されたことを通知します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.LocationChangeEvent.LOCATION_CHANGE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.LocationChangeEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">StageWebView オブジェクトの location プロパティが変更されたことを通知します。 |
| |
| </apiTipText></apiTipTexts></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| StageWebView オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">location</codeph> プロパティが変更されたことを通知します。 |
| |
| <p class="- topic/p ">イベントはキャンセルできません。</p> |
| |
| </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 "> |
| 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 "> |
| StageWebView オブジェクトを作成します。 |
| |
| <p class="- topic/p ">オブジェクトがステージにアタッチされるまで、および <codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> が設定されるまで、オブジェクトは非表示です。</p> |
| |
| </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 "> |
| この 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 ">表示されるコンテンツの最初または最後のフォーカス可能なオブジェクトが、フォーカスを受け取るかどうかを指定します。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| この StageWebView オブジェクト内のコンテンツにフォーカスを割り当てます。 |
| |
| <p class="- topic/p ">Direction 値は FocusDirection クラスに定義され、"bottom"、"none" および "top" を含みます。</p> |
| |
| </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 "> |
| この 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 "> |
| この StageWebView オブジェクトを破棄します。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">dispose()</codeph> の呼び出しはオプションです。この StageWebView インスタンスへの参照を維持しない場合、ガベージコレクションの対象になります。<codeph class="+ topic/ph pr-d/codeph ">dispose()</codeph> の呼び出しによって、ガベージコレクションを早期に、または都合のよいタイミングで実行できます。</p> |
| |
| </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 "> |
| StageWebView のビューポートをビットマップに描画します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.6" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc "> ビットマップの幅または高さは、ビューポートの幅または高さとは異なります。 |
| </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 ">ビットマップが null です。 |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">Error</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Error</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bitmap</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:BitmapData</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">StageWebView のビューポートの可視部分を描画する対象の BitmapData オブジェクト。 |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| StageWebView のビューポートをビットマップに描画します。 |
| <p class="- topic/p ">StageWebView オブジェクトの上にコンテンツを表示するためにビットマップをキャプチャしてステージを <codeph class="+ topic/ph pr-d/codeph ">null</codeph> に設定します。 </p> |
| |
| </apiDesc><example conref="examples\StageWebView.bitmapcapture.as" class="- topic/example "> 次の例では、google と facebook の 2 つのラベルを表示します。ラベル上をクリックすると、対応する Web ページがキャプチャされ、ステージ上のスナップショットとして表示されます。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package |
| { |
| import flash.display.Bitmap; |
| import flash.display.BitmapData; |
| import flash.display.Sprite; |
| import flash.events.*; |
| import flash.geom.Rectangle; |
| import flash.media.StageWebView; |
| import flash.net.*; |
| import flash.text.TextField; |
| |
| public class stagewebview1 extends Sprite |
| { |
| public var webView:StageWebView = new StageWebView(); |
| public var textGoogle:TextField=new TextField(); |
| public var textFacebook:TextField=new TextField(); |
| |
| public function stagewebview() |
| |
| { |
| textGoogle.htmlText="<b>Google</b>"; |
| textGoogle.x=300; |
| textGoogle.y=-80; |
| addChild(textGoogle); |
| textFacebook.htmlText="<b>Facebook</b>"; |
| textFacebook.x=0; |
| textFacebook.y=-80; |
| addChild(textFacebook); |
| textGoogle.addEventListener(MouseEvent.CLICK,goGoogle); |
| textFacebook.addEventListener(MouseEvent.CLICK,goFaceBook); |
| webView.stage = this.stage; |
| webView.viewPort = new Rectangle(0, 0, stage.stageWidth, stage.stageHeight); |
| |
| } |
| |
| public function goGoogle(e:Event):void |
| |
| { |
| webView.loadURL("http://www.google.com"); |
| webView.stage = null; |
| webView.addEventListener(Event.COMPLETE,handleLoad); |
| } |
| |
| public function goFaceBook(e:Event):void |
| { |
| webView.loadURL("http://www.facebook.com"); |
| webView.stage = null; |
| webView.addEventListener(Event.COMPLETE,handleLoad); |
| } |
| |
| public function handleLoad(e:Event):void |
| { |
| var bitmapData:BitmapData = new BitmapData(webView.viewPort.width, webView.viewPort.height); |
| webView.drawViewPortToBitmapData(bitmapData); |
| var webViewBitmap:Bitmap=new Bitmap(bitmapData); |
| addChild(webViewBitmap); |
| } |
| } |
| } |
| </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 "> |
| 参照履歴の前のページに移動します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 参照履歴の前のページに移動します。 |
| |
| </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 "> |
| 参照履歴の次のページに移動します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 参照履歴の次のページに移動します。 |
| |
| </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 "> |
| 指定した HTML 文字列を読み込み、表示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">text</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">表示する HTML または XHTML コンテンツの文字列。 |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">mimeType</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">text/html</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">コンテンツの MIME タイプ（"text/html" または "application/xhtml+xml"）。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 指定した HTML 文字列を読み込み、表示します。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> メソッドを使用すると、<codeph class="+ topic/ph pr-d/codeph ">location</codeph> は "about:blank" とレポートされます。HTML 文字列内の URL には、標準の URI スキームのみを使用できます。AIR URI スキームの "app:" と "app-storage:" は使用できません。</p> |
| |
| <p class="- topic/p ">HTML コンテンツに、画像ファイルなどのローカルリソースを読み込むことはできません。XMLHttpRequests は使用できません。</p> |
| |
| <p class="- topic/p ">"text/html" および "application/xhtml+xml" MIME タイプのみがサポートされます。</p> |
| |
| </apiDesc><example conref="examples\StageWebView.loadString.1.as" class="- topic/example "> 次の例では、ステージを塗るために StageWebView オブジェクトを設定します。この例では、<codeph class="+ topic/ph pr-d/codeph ">loadString()</codeph> メソッドを使用して HTML ページをロードします。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var webView:StageWebView = new StageWebView(); |
| webView.stage = this.stage; |
| webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); |
| |
| var htmlString:String = "<!DOCTYPE HTML>" + |
| "<html>" + |
| "<body>" + |
| "<h1>Example</h1>" + |
| "<p>King Phillip cut open five green snakes.</p>" + |
| "</body>" + |
| "</html>"; |
| |
| webView.loadString( htmlString, "text/html" ); |
| </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 "> |
| 指定した URL のページを読み込みます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">url</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 指定した URL のページを読み込みます。 |
| |
| <p class="- topic/p ">URL に使用できる URL スキームは、http:、https:、file:、data: および javascript: です。file: スキームで読み込まれるコンテンツは、他のローカルリソースを読み込むことができます。</p> |
| |
| </apiDesc><example conref="examples\StageWebView.loadURL.1.as" class="- topic/example "> 次の例では、ステージを塗るために StageWebView オブジェクトを設定します。この例では、<codeph class="+ topic/ph pr-d/codeph ">loadURL()</codeph> メソッドを使用して Web サイトをロードします。 |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>Android では、リモート URL をロードするために、AIR アプリケーション記述子で INTERNET 権限を指定する必要があります。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var webView:StageWebView = new StageWebView(); |
| webView.stage = this.stage; |
| webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); |
| |
| webView.loadURL( "http://www.example.com" ); |
| |
| </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 "> |
| 現在のページを再読み込みします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 現在のページを再読み込みします。 |
| |
| </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 "> |
| 現在の読み込み操作を中止します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 現在の読み込み操作を中止します。 |
| |
| </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 "> |
| 参照履歴に前のページがあるかどうかをレポートします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 参照履歴に前のページがあるかどうかをレポートします。 |
| |
| </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 "> |
| 参照履歴に次のページがあるかどうかをレポートします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 参照履歴に次のページがあるかどうかをレポートします。 |
| |
| </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 "> |
| 現在のデバイスで StageWebView クラスがサポートされているかどうかをレポートします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在のデバイスで StageWebView クラスがサポートされているかどうかをレポートします。 |
| |
| </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 "> |
| 現在の場所の URL。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在の場所の URL。 |
| |
| </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 "> |
| この StageWebView オブジェクトを表示するステージ。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.display:Stage</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| この StageWebView オブジェクトを表示するステージ。 |
| |
| <p class="- topic/p ">この StageWebView オブジェクトを非表示にするには、<codeph class="+ topic/ph pr-d/codeph ">stage</codeph> を <codeph class="+ topic/ph pr-d/codeph ">null</codeph> に設定します。</p> |
| |
| </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 "> |
| 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 "> |
| HTML タイトル値。 |
| |
| </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 "> |
| StageWebView オブジェクトを表示するステージの領域。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Rectangle</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Rectangle 値が無効です。 |
| </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 "> |
| StageWebView オブジェクトを表示するステージの領域。 |
| |
| </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 "> |
| このクラスは、ビデオで可能なデコードレベルを説明する列挙を定義します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">ビデオで可能なデコードレベルを説明する列挙。 |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| このクラスは、ビデオで可能なデコードレベルを説明する列挙を定義します。 |
| </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 "> |
| ハードウェアアクセラレーションによる（GPU）ビデオデコードを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="(unsupported)" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">accelerated</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">ハードウェアアクセラレーションによる（GPU）ビデオデコードを示します。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ハードウェアアクセラレーションによる（GPU）ビデオデコードを示します。 |
| </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 "> |
| ソフトウェアビデオデコードを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">ソフトウェアビデオデコードを示します。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ソフトウェアビデオデコードを示します。 |
| </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 "> |
| ビデオデコードがサポートされていません。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">ビデオがサポートされていません。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ビデオデコードがサポートされていません。 |
| </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 "> |
| MediaPromise クラスは、メディアオブジェクトを配信するプロミスを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseInterface>flash.desktop:IFilePromise</apiBaseInterface><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| MediaPromise クラスは、メディアオブジェクトを配信するプロミスを示します。 |
| |
| <p class="- topic/p ">MediaEvent オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">data</codeph> プロパティは MediaPromise インスタンスです。MediaPromise メソッドを使用して、プロミス済みメディアオブジェクトにアクセスできます。ただし、サポートされるメディアフォーマットには画像とビデオが含まれます。</p> |
| |
| <p class="- topic/p ">MediaPromise オブジェクトを作成できません。<codeph class="+ topic/ph pr-d/codeph ">new MediaPromise()</codeph> を呼び出すとランタイムエラーが発生します。</p> |
| |
| </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 "> |
| MediaPromise オブジェクトは、すべてのデータが読み込まれたときに、complete イベントを送出します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| MediaPromise オブジェクトは、すべてのデータが読み込まれたときに、<codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントを送出します。このイベントは、基礎となるストリームで使用できるデータがなくなったことを示します。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントは、同期データソースから送出されません。</p> |
| |
| </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 "> |
| データが使用できるようになると、MediaPromise オブジェクトは progress イベントを送出します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ProgressEvent.PROGRESS</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ProgressEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| データが使用できるようになると、MediaPromise オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> イベントを送出します。 |
| |
| <p class="- topic/p ">最後を除くすべての progress イベントの <codeph class="+ topic/ph pr-d/codeph ">bytesTotal</codeph> プロパティ値は 0 です。すべてのデータを即時に使用できる場合、<codeph class="+ topic/ph pr-d/codeph ">progress</codeph> イベントは送出されません。同期データソースから <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> イベントは送出されません。</p> |
| |
| </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 "> |
| 基礎となるデータストリームを読み取るときにエラーが発生する場合、MediaPromise オブジェクトは ioError イベントを送出します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.IOErrorEvent.IOERROR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.IOErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 基礎となるデータストリームを読み取るときにエラーが発生する場合、MediaPromise オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">ioError</codeph> イベントを送出します。このイベントの送出後は、データを読み取ることはできません。 |
| |
| </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 "> |
| 基礎となるデータストリームが閉じられると、MediaPromise オブジェクトは close イベントを送出します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CLOSE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 基礎となるデータストリームが閉じられると、MediaPromise オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">close</codeph> イベントを送出します。 |
| |
| </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 "> |
| データソースを閉じます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| データソースを閉じます。 |
| |
| </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 "> |
| 基礎となるデータソースを開くと、IDataInput インスタンスが読み取り可能になります。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><returns>the underlying data source. |
| |
| </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 "> |
| 基礎となるデータソースを開くと、IDataInput インスタンスが読み取り可能になります。 |
| |
| <p class="- topic/p ">基礎となるデータソースが非同期の場合、MediaPromise オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> および <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントを送出し、データが読み取り可能かどうかを示します。データソースが同期している場合、すべてのデータは即時に使用可能なので、これらのイベントは送出されません。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>データを手動で読み取る代わりに、Loader クラスの <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> メソッドを使用して、MediaPromise オブジェクトを読み込むことができます。</p> |
| |
| </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 "> |
| エラーをレポートするためにランタイムで使用されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">送出するエラーイベント。 |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| エラーをレポートするためにランタイムで使用されます。 |
| |
| <p class="- topic/p ">アプリケーションコードでこのメソッドを呼び出さないでください。</p> |
| |
| </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 "> |
| メディアオブジェクトを示す File インスタンス（存在する場合）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.filesystem:File</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| メディアオブジェクトを示す File インスタンス（存在する場合）。 |
| |
| <p class="- topic/p ">基礎となるデータソースがファイルベースで、ファイルからアプリケーションにアクセス可能な場合、このプロパティは File オブジェクトを表します。それ以外の場合、プロパティは <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。</p> |
| |
| </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 "> |
| 基礎となるデータソースが非同期か同期しているかをレポートします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 基礎となるデータソースが非同期か同期しているかをレポートします。 |
| |
| <p class="- topic/p "/> |
| |
| </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 "> |
| メディアの一般的なタイプ（画像またはビデオ）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| メディアの一般的なタイプ（画像またはビデオ）。 |
| |
| <p class="- topic/p ">MediaType クラスの定数で、このプロパティに指定できる値を定義します。</p> |
| <ul class="- topic/ul "><li class="- topic/li ">MediaType.IMAGE</li><li class="- topic/li ">MediaType.VIDEO</li></ul> |
| |
| </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 "> |
| メディアオブジェクトのファイル名（存在する場合）。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| メディアオブジェクトのファイル名（存在する場合）。 |
| |
| <p class="- topic/p ">ファイル名を使用できるのは、基礎となるデータソースがファイルベースで、ファイルからアプリケーションにアクセス可能な場合です。それ以外の場合、プロパティは <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。</p> |
| |
| </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 "> |
| SoundLoaderContext クラスはサウンドをロードするファイルのセキュリティチェックを提供します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| SoundLoaderContext クラスはサウンドをロードするファイルのセキュリティチェックを提供します。SoundLoaderContext オブジェクトは、コンストラクターと Sound クラスの <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> メソッドにパラメーターとして渡されます。 |
| |
| <p class="- topic/p ">このクラスを使用するときは、次のセキュリティモデルを考慮してください。 </p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">呼び出し元ファイルがネットワークサンドボックスにあり、ロードするサウンドファイルがローカルにある場合、サウンドのロードおよび再生はできません。</li><li class="- topic/li ">呼び出し元がローカルにあり、リモートサウンドのロードおよび再生を試行する場合、デフォルトでは、サウンドのロードや再生ができません。これを行うには、ユーザーが明示的な許可を与える必要があります。</li><li class="- topic/li ">サウンドを処理する特定の操作が制限されます。ロードされたサウンドのデータには、URL ポリシーファイルを実装していない限り、別のドメインに存在する ファイルからアクセスできないことに注意してください。この制限の対象となるサウンド関連の API は <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> プロパティおよび <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph> メソッド、<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> メソッド、<codeph class="+ topic/ph pr-d/codeph ">SoundTransform()</codeph> メソッドです。</li></ul> |
| |
| <p class="- topic/p ">ただし、Adobe AIR では、<codeph class="+ topic/ph pr-d/codeph ">アプリケーション</codeph>セキュリティサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。</p> |
| |
| <p class="- topic/p ">セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：<xref href="http://www.adobe.com/go/devnet_security_jp" scope="external" class="- topic/xref ">セキュリティ</xref>を参照してください。</p> |
| |
| </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 "> |
| 新しいサウンドローダーコンテキストオブジェクトを作成します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">サウンドのストリーミングを開始するまでに、バッファーにストリーミングサウンドをプリロードする秒数です。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">checkPolicyFile</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">オブジェクトのロード時に URL ポリシーファイルの存在を確認するかどうかを指定します（確認する場合は <codeph class="+ topic/ph pr-d/codeph ">true</codeph>）。 |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 新しいサウンドローダーコンテキストオブジェクトを作成します。 |
| |
| </apiDesc><example conref="examples\SoundLoaderContextExample.as" class="- topic/example "> 次の例では、ロードされるサウンドのバッファーが 3 秒に設定されます。 |
| |
| <p class="- topic/p ">SoundLoaderContext オブジェクトの 1 つ目のパラメーター（<codeph class="+ topic/ph pr-d/codeph ">context</codeph>）を使用して、バッファーのデフォルト値（1 秒）を 3 秒に増やしています。 値はミリ秒単位です。SoundLoaderContext オブジェクトの 2 つ目のパラメーターが <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定されている場合、オブジェクトのロード時にクロスドメインポリシーファイルが調べられます。ここでは、デフォルト値の <codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定されているため、ポリシーファイルは調べられません。 サウンドオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> メソッドによってコンテキスト設定が使用され、サウンドがストリームを開始する前に、バッファーにストリーミングサウンドをプリロードするために 3 秒間待機します。アドビ システムズ社のポッドキャストである <codeph class="+ topic/ph pr-d/codeph ">URLRequest</codeph> オブジェクトによってファイルの位置が決定されます。サウンドファイルのロード中に <codeph class="+ topic/ph pr-d/codeph ">IOErrorEvent.IO_ERROR</codeph> エラーが発生すると、<codeph class="+ topic/ph pr-d/codeph ">errorHandler()</codeph> メソッドが呼び出されます。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.URLRequest; |
| import flash.media.Sound; |
| import flash.media.SoundLoaderContext; |
| import flash.events.IOErrorEvent; |
| |
| public class SoundLoaderContextExample extends Sprite { |
| |
| public function SoundLoaderContextExample() { |
| var snd:Sound = new Sound(); |
| var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"); |
| var context:SoundLoaderContext = new SoundLoaderContext(3000, false); |
| |
| snd.load(req, context); |
| snd.play(); |
| |
| snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); |
| } |
| |
| private function errorHandler(errorEvent:IOErrorEvent):void { |
| trace("The sound could not be loaded: " + errorEvent.text); |
| } |
| |
| } |
| } |
| </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 "> |
| サウンドのストリーミングを開始するまでに、バッファーにストリーミングサウンドをプリロードするミリ秒数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| サウンドのストリーミングを開始するまでに、バッファーにストリーミングサウンドをプリロードするミリ秒数です。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.bufferTime</codeph> の値を、グローバル <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> プロパティを設定してオーバーライドすることはできません。<ph class="- topic/ph "><codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> プロパティは SWF ファイルに埋め込まれたストリーミングサウンドのバッファー時間には影響しますが、動的に作成される Sound オブジェクト（ActionScript で作成される Sound オブジェクト）には影響しません。</ph></p> |
| |
| </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 "> |
| サウンドのロードを開始する前に、アプリケーションが、ロードされるサウンドのサーバーからの URL ポリシーファイルのダウンロードを試行するかどうかを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>: please review at same time: checkPolicyFile property in LoaderContext, NetStream |
| </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 "> |
| サウンドのロードを開始する前に、アプリケーションが、ロードされるサウンドのサーバーからの URL ポリシーファイルのダウンロードを試行するかどうかを指定します。このプロパティは、呼び出し元のファイル自体のドメインの外部から <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> メソッドを使用してロードされたサウンドに適用されます。 |
| |
| |
| |
| <p class="- topic/p ">呼び出し元のファイル自体のドメインの外部からサウンドをロードし、呼び出し元のファイルのコードがサウンドのデータに低レベルアクセスを必要とする場合は、このプロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定します。サウンドデータへの低レベルアクセスの例です。ID3Info オブジェクトを取得するための <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> プロパティへの参照、またはロードされたサウンドからサウンドサンプリングを取得する <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph> メソッドの呼び出しが含まれます。ロード時に <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> プロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定せずにサウンドデータにアクセスしようとした場合、必要なポリシーファイルがダウンロードされていないために SecurityError 例外を受け取る場合があります。</p> |
| |
| <p class="- topic/p ">ロードするサウンドデータへの低レベルのアクセスを必要としない場合は、<codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定しないでください。ポリシーファイルの確認はネットワーク帯域幅を消費し、ダウンロードの開始が遅れる場合があるため、必要な場合にのみ行ってください。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> を呼び出すときに <codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.checkPolicyFile</codeph> を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定すると、Flash Player または AIR は、関連する URL ポリシーファイルを正常にダウンロードするか、指定されたサウンドのダウンロードを開始する前に、そのようなポリシーファイルが存在しないことを判別する必要があります。ポリシーファイルの存在を確認するため、<ph class="- topic/ph ">Flash Player または</ph> AIR は次のアクションをこの順番で実行します。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Flash Player または AIR は、既にダウンロードされているポリシーファイルを考慮します。</li><li class="- topic/li ">Flash Player または AIR は、<codeph class="+ topic/ph pr-d/codeph ">Security.loadPolicyFile()</codeph> の呼び出しで指定された保留されているポリシーファイルのダウンロードを試行します。</li><li class="- topic/li ">Flash Player または AIR は、サウンドの URL に対応するデフォルトの場所、<codeph class="+ topic/ph pr-d/codeph ">/crossdomain.xml</codeph>（<codeph class="+ topic/ph pr-d/codeph ">URLRequest.url</codeph> と同じサーバー）からポリシーファイルをダウンロードしようとします。 サウンドの URL は URLRequest オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティで指定します。URLRequest オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> または Sound() コンストラクター関数に渡されます。</li></ul> |
| |
| <p class="- topic/p ">どのような場合でも、Flash Player または AIR では、適切なポリシーファイルがサウンドのサーバー上に存在していること、ポリシーファイルの場所に基づいて <codeph class="+ topic/ph pr-d/codeph ">URLRequest.url</codeph> にあるサウンドファイルへのアクセスが可能であること、およびポリシーファイルの <codeph class="+ topic/ph pr-d/codeph "><allow-access-from></codeph> タグによって呼び出し元ファイルのドメインによるサウンドへのアクセスが許可されていることが必要となります。 |
| </p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定した場合、Flash Player または AIR は、ポリシーファイルが検証されるまで待機してからサウンドをロードします。 サウンドデータに対する低レベルの操作（<codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> の呼び出しまたは <codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph> の呼び出しなど）は、Sound オブジェクトから <codeph class="+ topic/ph pr-d/codeph ">progress</codeph> イベントおよび <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントが送出されるまで待つ必要があります。 |
| </p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> を <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定していて、適切なポリシーファイルが見つからない場合は、ポリシーファイルを必要とする操作を実行するまでエラーは表示されません。ポリシーファイルが必要になると、Flash Player または AIR は <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph> 例外をスローします。 <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントを受け取ると、<codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> の値（<codeph class="+ topic/ph pr-d/codeph ">try</codeph> ブロック内）を取得して <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph> がスローされたかどうかを確認し、関連するポリシーファイルが見つかったかどうかをテストできます。</p> |
| |
| |
| <p class="- topic/p ">サーバーサイド HTTP リダイレクトを使用する URL からサウンドをダウンロードする場合は、<codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> に注意してください。Flash Player または AIR は、URLRequest オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティに対応するポリシーファイルを取得しようとします。URLRequest オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> に渡されます。 最終的なサウンドファイルが HTTP リダイレクトによって別の URL から取得される場合、最初にダウンロードされたポリシーファイルはサウンドの最終的な URL（セキュリティ判定においてはこの URL が重要となります）に適用できないことがあります。</p> |
| |
| <p class="- topic/p ">このような状況になった場合の解決方法が 1 つあります。<codeph class="+ topic/ph pr-d/codeph ">progress</codeph> イベントまたは <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントを受け取った後、<codeph class="+ topic/ph pr-d/codeph ">Sound.url</codeph> プロパティの値を調べることができます。ここには、サウンドの最終的な URL が格納されています。次に、サウンドの最終的な URL に基づいて算出したポリシーファイルの URL で <codeph class="+ topic/ph pr-d/codeph ">Security.loadPolicyFile()</codeph> メソッドを呼び出します。最後に、例外がスローされなくなるまで <codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> の値をポーリングします。</p> |
| |
| <p class="- topic/p ">これは、AIR アプリケーションサンドボックス内のコンテンツには適用されません。アプリケーションサンドボックス内のコンテンツは、起点に関係なく、常にプログラムによってサウンドコンテンツにアクセスします。</p> |
| |
| <p class="- topic/p ">セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：<xref href="http://www.adobe.com/go/devnet_security_jp" scope="external" class="- topic/xref ">セキュリティ</xref>を参照してください。</p> |
| |
| |
| </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 "> |
| SoundChannel クラスはアプリケーション内でサウンドを制御します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| SoundChannel クラスはアプリケーション内でサウンドを制御します。サウンドはすべてサウンドチャンネルに割り当てられます。アプリケーションでは、複数のチャンネルを組み合わせて使用することができます。 SoundChannel クラスには、<codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> メソッド、チャンネルの振幅（ボリューム）を監視するためのプロパティ、および SoundTransform オブジェクトをチャンネルに割り当てるためのプロパティがあります。 |
| |
| </apiDesc><example conref="examples\SoundChannelExample.as" class="- topic/example "> 次の例では MP3 ファイルがロードされて再生され、それによって発生するサウンドイベントに関する情報が表示されます。Timer オブジェクトによって、再生ヘッドの位置に関する更新情報が、50 ミリ秒ごとに提供されます。この例を実行するには、MySound.mp3 ファイルを SWF ファイルと同じディレクトリに配置します。 |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.events.*; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.net.URLRequest; |
| import flash.utils.Timer; |
| |
| public class SoundChannelExample extends Sprite { |
| private var url:String = "MySound.mp3"; |
| private var soundFactory:Sound; |
| private var channel:SoundChannel; |
| private var positionTimer:Timer; |
| |
| public function SoundChannelExample() { |
| var request:URLRequest = new URLRequest(url); |
| soundFactory = new Sound(); |
| soundFactory.addEventListener(Event.COMPLETE, completeHandler); |
| soundFactory.addEventListener(Event.ID3, id3Handler); |
| soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); |
| soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler); |
| soundFactory.load(request); |
| |
| channel = soundFactory.play(); |
| channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler); |
| |
| positionTimer = new Timer(50); |
| positionTimer.addEventListener(TimerEvent.TIMER, positionTimerHandler); |
| positionTimer.start(); |
| } |
| |
| |
| private function positionTimerHandler(event:TimerEvent):void { |
| trace("positionTimerHandler: " + channel.position.toFixed(2)); |
| } |
| |
| private function completeHandler(event:Event):void { |
| trace("completeHandler: " + event); |
| } |
| |
| private function id3Handler(event:Event):void { |
| trace("id3Handler: " + event); |
| } |
| |
| private function ioErrorHandler(event:Event):void { |
| trace("ioErrorHandler: " + event); |
| positionTimer.stop(); |
| } |
| |
| private function progressHandler(event:ProgressEvent):void { |
| trace("progressHandler: " + event); |
| } |
| |
| private function soundCompleteHandler(event:Event):void { |
| trace("soundCompleteHandler: " + event); |
| positionTimer.stop(); |
| } |
| } |
| } |
| </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 "> |
| サウンドの再生が終了したときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| サウンドの再生が終了したときに送出されます。 |
| </apiDesc><example conref="examples\SoundChannel_event_soundCompleteExample.as" class="- topic/example "> 次の例では、ユーザーが再生リストから曲を選択し、「再生」を選択して、選択した順序で曲を再生します。 |
| |
| <p class="- topic/p ">コンストラクターには、テキストフィールドが定義され、曲リスト、および再生を選択するための行が保持されます。（通常、曲の再生にはボタンが使用され、曲リストにはリストボックスが使用されます。）選択された曲の行の書式をイタリックに変更するテキストフォーマットオブジェクトが定義されます。ユーザーがテキストフィールドを選択すると、<codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドが呼び出されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドでは、テキストフィールドオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">getLineIndexAtPoint()</codeph> メソッドによってユーザーが選択した行のインデックスが返されます。 行のインデックスを使用して、<codeph class="+ topic/ph pr-d/codeph ">getLineText()</codeph> メソッドによってテキストの内容が取得されます。次に、if ステートメントで、ユーザーが曲の再生と再生リストへの追加のいずれを選択したかがチェックされます。 ユーザーが再生を選択し、曲が選択された場合、マウスのクリックに対するイベントリスナーが削除され、<codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> メソッドが呼び出されて、曲の再生が開始されます。ユーザーが曲のタイトルを選択した場合、行の内容が <codeph class="+ topic/ph pr-d/codeph ">songList</codeph> 配列に追加され、行の書式がイタリックに設定されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> メソッドによって配列リストが反復処理され、各曲がロードおよび再生されます。曲のサウンドチャンネルへの割り当ても行われます。曲の再生が終了し、<codeph class="+ topic/ph pr-d/codeph ">Event.SOUND_COMPLETE</codeph> イベントが送出されるときに応答するために、そのサウンドチャンネルに対するイベントリスナーが追加されます。次に、<codeph class="+ topic/ph pr-d/codeph ">soundCompleteHandler()</codeph> メソッドによって <codeph class="+ topic/ph pr-d/codeph ">playNext()</codeph> メソッドが呼び出され、次の曲が再生されます。この処理は、配列にリストされたすべての曲の再生が完了するまで続行します。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.MouseEvent; |
| import flash.text.TextFormat; |
| import flash.net.URLRequest; |
| import flash.events.Event; |
| import flash.events.IOErrorEvent; |
| |
| public class SoundChannel_event_soundCompleteExample extends Sprite { |
| private var channel:SoundChannel = new SoundChannel(); |
| private var songList:Array = new Array(); |
| private var listTextField:TextField = new TextField(); |
| private var songFormat:TextFormat = new TextFormat(); |
| private var arrayIndex:int = 0; |
| private var songSelected:Boolean = false; |
| |
| public function SoundChannel_event_soundCompleteExample() { |
| |
| listTextField.autoSize = TextFieldAutoSize.LEFT; |
| listTextField.border = true |
| listTextField.background = true; |
| listTextField.text = "Song1.mp3\n" + "Song2.mp3\n" |
| + "Song3.mp3\n" + "Song4.mp3\n" + "PLAY"; |
| |
| songFormat.italic = true; |
| |
| listTextField.addEventListener(MouseEvent.CLICK, clickHandler); |
| |
| addChild(listTextField); |
| } |
| |
| private function clickHandler(e:MouseEvent):void { |
| var index:int = listTextField.getLineIndexAtPoint(e.localX, e.localY); |
| var line:String = listTextField.getLineText(index); |
| var firstIndex:uint = listTextField.getLineOffset(index); |
| var playLine:uint = listTextField.numLines - 1; |
| |
| if((index == playLine) && (songSelected == true)) { |
| listTextField.removeEventListener(MouseEvent.CLICK, clickHandler); |
| playNext(); |
| |
| } else if (index != playLine) { |
| songList.push(line.substr(0, (line.length - 1))); |
| listTextField.setTextFormat(songFormat, firstIndex, |
| (firstIndex + listTextField.getLineLength(index))); |
| songSelected = true; |
| } |
| } |
| |
| private function playNext():void { |
| |
| if(arrayIndex < songList.length) { |
| var snd:Sound = new Sound(); |
| snd.load(new URLRequest(songList[arrayIndex])); |
| channel = snd.play(); |
| |
| channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler); |
| arrayIndex++; |
| |
| } else { |
| songSelected = false; |
| |
| while(arrayIndex > 0) { |
| songList.pop(); |
| arrayIndex--; |
| } |
| } |
| } |
| |
| private function soundCompleteHandler(e:Event):void { |
| playNext(); |
| } |
| |
| private function errorHandler(errorEvent:IOErrorEvent):void { |
| trace(errorEvent.text); |
| } |
| } |
| } |
| </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 "> |
| チャンネルで再生しているサウンドを停止します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 "> |
| チャンネルで再生しているサウンドを停止します。 |
| |
| </apiDesc><example conref="examples\SoundChannel_stopExample.as" class="- topic/example "> 次の例では、ユーザーがサウンドファイルを一時停止および再生できます。 |
| |
| <p class="- topic/p ">コンストラクターで、サウンドファイルがロードされます。（この例では、ファイルが SWF ファイルと同じディレクトリにあると想定しています。）ユーザーがサウンドの再生または一時停止を実行するボタンとして、テキストフィールドが使用されます。ユーザーが <codeph class="+ topic/ph pr-d/codeph ">button</codeph> テキストフィールドを選択すると、<codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドが呼び出されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドで、ユーザーが初めてテキストフィールドを選択したときに、サウンドが再生するように設定され、サウンドチャンネルに割り当てられます。 次に、ユーザーが一時停止するテキストフィールドを選択すると、サウンドが再生を停止します。 サウンドチャンネルの <codeph class="+ topic/ph pr-d/codeph ">position</codeph> プロパティは、停止時のサウンドの位置を記録します。このプロパティを使用して、ユーザーがテキストフィールドを選択して再生を再開した後、その位置でサウンドが再開されます。 <codeph class="+ topic/ph pr-d/codeph ">Sound.play()</codeph> メソッドが呼び出されるたびに、新しい SoundChannel オブジェクトが作成され、<codeph class="+ topic/ph pr-d/codeph ">channel</codeph> 変数に割り当てられます。サウンドチャンネルの <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> メソッドを使用してサウンドを一時停止するためには、Sound オブジェクトを SoundChannel オブジェクトに割り当てる必要があります。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.net.URLLoader; |
| import flash.net.URLRequest; |
| import flash.text.TextField; |
| import flash.events.MouseEvent; |
| import flash.text.TextFieldAutoSize; |
| |
| public class SoundChannel_stopExample extends Sprite { |
| private var snd:Sound = new Sound(); |
| private var channel:SoundChannel = new SoundChannel(); |
| private var button:TextField = new TextField(); |
| |
| public function SoundChannel_stopExample() { |
| var req:URLRequest = new URLRequest("MySound.mp3"); |
| snd.load(req); |
| |
| button.x = 10; |
| button.y = 10; |
| button.text = "PLAY"; |
| button.border = true; |
| button.background = true; |
| button.selectable = false; |
| button.autoSize = TextFieldAutoSize.CENTER; |
| |
| button.addEventListener(MouseEvent.CLICK, clickHandler); |
| |
| this.addChild(button); |
| } |
| |
| private function clickHandler(e:MouseEvent):void { |
| var pausePosition:int = channel.position; |
| |
| if(button.text == "PLAY") { |
| channel = snd.play(pausePosition); |
| button.text = "PAUSE"; |
| } |
| else { |
| channel.stop(); |
| button.text = "PLAY"; |
| } |
| } |
| } |
| } |
| </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 "> |
| 左チャンネルの現在の振幅（ボリューム）、0（無音）～ 1（完全な振幅）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| 左チャンネルの現在の振幅（ボリューム）、0（無音）～ 1（完全な振幅）です。 |
| |
| </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 "> |
| サウンドの再生中、position プロパティは、サウンドファイル内で再生されている現在のポイント（ミリ秒単位）を示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| サウンドの再生中、<codeph class="+ topic/ph pr-d/codeph ">position</codeph> プロパティは、サウンドファイル内で再生されている現在のポイント（ミリ秒単位）を示します。サウンドを停止または一時停止すると、<codeph class="+ topic/ph pr-d/codeph ">position</codeph> プロパティはサウンドファイル内で再生された最後のポイントを示します。 |
| |
| <p class="- topic/p ">一般的な使用方法は、サウンドを停止したときに <codeph class="+ topic/ph pr-d/codeph ">position</codeph> プロパティの値を保存することです。その保存した位置からサウンドを再起動して、後でサウンドを再開できます。 |
| </p> |
| |
| <p class="- topic/p ">サウンドをループしている場合、サウンド<codeph class="+ topic/ph pr-d/codeph ">位置</codeph>は各ループの最初に 0 にリセットされます。</p> |
| |
| </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 "> |
| 右チャンネルの現在の振幅（ボリューム）、0（無音）～ 1（完全な振幅）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "> |
| 右チャンネルの現在の振幅（ボリューム）、0（無音）～ 1（完全な振幅）です。 |
| |
| </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 "> |
| サウンドチャンネルに割り当てられた 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> |
| |
| </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 "> |
| サウンドチャンネルに割り当てられた SoundTransform オブジェクトです。SoundTransform オブジェクトには、ボリューム、パン、左スピーカーの割り当て、および右スピーカーの割り当てを設定するプロパティが含まれます。 |
| |
| </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 "> |
| SoundMixer クラスには、静的プロパティやアプリケーションのグローバルサウンドコントロールのメソッドが含まれます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| SoundMixer クラスには、静的プロパティやアプリケーションのグローバルサウンドコントロールのメソッドが含まれます。SoundMixer クラスは、アプリケーションに埋め込まれたストリーミングサウンドを制御します。動的に作成されるサウンド（つまり、<codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントを送出する Sound オブジェクトに応答して生成されるサウンド）は制御しません。 |
| |
| </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 "> |
| セキュリティ上の制限のためにサウンドが使用できないかどうかを調べます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 ">ブール値のストリング表現です。 |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| セキュリティ上の制限のためにサウンドが使用できないかどうかを調べます。例えば、このメソッドの呼び出し元コンテンツのドメイン以外のドメインからロードされたサウンドは、そのサウンドのサーバー上に、該当するドメインから自ドメインへのアクセスを許可する URL ポリシーファイルが存在していなければ、アクセスできません。サウンドをロードしたり、再生することはできますが、アクセス不可のサウンドに対して、サウンドの ID3 メタデータの取得などの低レベルの操作は実行できません。 |
| |
| <p class="- topic/p ">アプリケーションセキュリティサンドボックス内の AIR アプリケーションコンテンツでは、このメソッドを呼び出すと常に <codeph class="+ topic/ph pr-d/codeph ">false</codeph> が返されます。 すべてのサウンド（他のドメインからロードされたサウンドを含む）は、アプリケーションセキュリティサンドボックス内のコンテンツにアクセスできます。</p> |
| |
| </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 "> |
| 現在のサウンド波形からスナップショットを取得し、指定した ByteArray オブジェクトに配置します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>Should confirm if the floating point numbers are single- or double-precision. |
| |
| </internal></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">outputArray</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.utils:ByteArray</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">サウンドに関連する値を保持する ByteArray オブジェクトです。セキュリティ上の制限のためにサウンドが使用できない場合（<codeph class="+ topic/ph pr-d/codeph ">areSoundsInaccessible == true</codeph>）、<codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> オブジェクトは変更されません。すべてのサウンドが停止している場合、<codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> オブジェクトには 0 が詰められます。 |
| |
| </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 ">サウンドデータに対して最初にフーリエ変換を実行するかどうかを示すブール値です。このパラメーターを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定すると、このメソッドは未処理のサウンド波形ではなく周波数スペクトルを返します。周波数スペクトルでは、低い周波数は左側に、高い周波数は右側に表されます。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">stretchFactor</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">サウンドサンプリングの解像度です。例えば、<codeph class="+ topic/ph pr-d/codeph ">stretchFactor</codeph> 値に 0 を設定した場合、データは 44.1 KHz でサンプリングされ、1 の場合は 22.05 KHz、2 の場合は 11.025 KHz となります。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在のサウンド波形からスナップショットを取得し、指定した ByteArray オブジェクトに配置します。値の形式は正規化された浮動小数値で、範囲は -1.0 ～ 1.0 です。<codeph class="+ topic/ph pr-d/codeph ">outputArray</codeph> パラメーターに渡す ByteArray オブジェクトは、新しい値で上書きされます。作成される ByteArray オブジェクトのサイズは 512 に固定され（値は浮動小数値）、最初の 256 個は左チャンネルを表し、次の 256 個は右チャンネルを表します。 |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>このメソッドは、ローカルファイルのセキュリティ制限とドメイン間のデータロードに関する制限に従います。 ローカルファイルを操作する場合、または呼び出し元コンテンツとは異なるドメインに存在するサーバーからロードしたサウンドを操作する場合は、クロスドメインポリシーファイルを使用してサンドボックスの制限に対処しなければならないことがあります。 詳細については、Sound クラスの説明を参照してください。また、このメソッドは、RTMP サーバーと同じドメインに存在するコンテンツから呼び出された場合でも、RTMP ストリームからデータを抽出するために使用することはできません。</p> |
| |
| |
| <p class="- topic/p ">このメソッドは、Flash Player 9.0.115.0 以降と Adobe AIR の RTMP 上でサポートされています。サーバーサイドスクリプトで、Flash Media Server 上のストリームへのアクセスを制御することができます。詳細については、<codeph class="+ topic/ph pr-d/codeph ">Client.audioSampleAccess</codeph> プロパティおよび <codeph class="+ topic/ph pr-d/codeph ">Client.videoSampleAccess</codeph> プロパティのトピック（<xref href="http://www.adobe.com/go/documentation_jp" scope="external" class="- topic/xref ">『Server-Side ActionScript Language Reference for Adobe Flash Media Server』<i class="+ topic/ph hi-d/i "/></xref>）を参照してください。</p> |
| |
| </apiDesc><example conref="examples\SoundMixer_computeSpectrumExample.as" class="- topic/example "> 次の例では、<codeph class="+ topic/ph pr-d/codeph ">computeSpectrum()</codeph> メソッドを使用して、サウンド波形データのグラフィック表現を生成します。 |
| |
| <p class="- topic/p ">コンストラクターで、サウンドファイルがロードされ、再生に設定されます。この例では、エラー処理はありません。また、サウンドファイルが SWF ファイルと同じディレクトリにあると想定しています。この例では、サウンドの再生中に <codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> イベントを待機し、<codeph class="+ topic/ph pr-d/codeph ">onEnterFrame()</codeph> メソッドを繰り返しトリガーして、サウンドデータ値のグラフを描画します。サウンドの再生が終了すると、<codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> イベントのリスナーを削除することにより、<codeph class="+ topic/ph pr-d/codeph ">onPlaybackComplete()</codeph> メソッドによって描画処理が停止されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">onEnterFrame()</codeph> メソッドで、<codeph class="+ topic/ph pr-d/codeph ">computeSpectrum()</codeph> メソッドによって <codeph class="+ topic/ph pr-d/codeph ">bytes</codeph> バイト配列オブジェクトに生のサウンドが保存されます。データは 44.1 KHz でサンプリングされます。512 バイトのデータを含む各バイト配列には、-1 ～ 1 の浮動小数値が含まれます。前半の 256 バイトの値は左チャンネルを表し、後半の 256 バイトの値は右チャンネルを表します。1 つ目の for ループは、前半の 256 バイトのデータ値（左ステレオチャンネル）を読み取り、<codeph class="+ topic/ph pr-d/codeph ">Graphics.lineTo()</codeph> メソッドを使用して、各ポイントから次のポイントまでの間に線を描画します。サウンド波形のベクターグラフィック表示は、クラスの Sprite オブジェクトに直接記述されます。バイトストリームから 32 ビット浮動小数点数としてサウンドのバイトが読み取られ、グラフの垂直方向の範囲に適合するようにプロットの高さで乗算されます。幅はチャンネルの長さの 2 倍に設定されます。2 つ目の for ループは、後半の 256 バイトの値（右ステレオチャンネル）を読み取り、逆の順序で線を描画します。<codeph class="+ topic/ph pr-d/codeph ">g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT);</codeph> メソッドおよび <codeph class="+ topic/ph pr-d/codeph ">g.lineTo(0, PLOT_HEIGHT);</codeph> メソッドにより波形のベースラインが描画されます。生成される波形プロットから、鏡像効果が生まれます。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.display.Graphics; |
| import flash.events.Event; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.media.SoundMixer; |
| import flash.net.URLRequest; |
| import flash.utils.ByteArray; |
| import flash.text.TextField; |
| |
| public class SoundMixer_computeSpectrumExample extends Sprite { |
| |
| public function SoundMixer_computeSpectrumExample() { |
| var snd:Sound = new Sound(); |
| var req:URLRequest = new URLRequest("Song1.mp3"); |
| snd.load(req); |
| |
| var channel:SoundChannel; |
| channel = snd.play(); |
| addEventListener(Event.ENTER_FRAME, onEnterFrame); |
| channel.addEventListener(Event.SOUND_COMPLETE, onPlaybackComplete); |
| } |
| |
| private function onEnterFrame(event:Event):void { |
| var bytes:ByteArray = new ByteArray(); |
| const PLOT_HEIGHT:int = 200; |
| const CHANNEL_LENGTH:int = 256; |
| |
| SoundMixer.computeSpectrum(bytes, false, 0); |
| |
| var g:Graphics = this.graphics; |
| |
| g.clear(); |
| |
| g.lineStyle(0, 0x6600CC); |
| g.beginFill(0x6600CC); |
| g.moveTo(0, PLOT_HEIGHT); |
| |
| var n:Number = 0; |
| |
| for (var i:int = 0; i < CHANNEL_LENGTH; i++) { |
| n = (bytes.readFloat() * PLOT_HEIGHT); |
| g.lineTo(i * 2, PLOT_HEIGHT - n); |
| } |
| |
| g.lineTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT); |
| g.endFill(); |
| |
| g.lineStyle(0, 0xCC0066); |
| g.beginFill(0xCC0066, 0.5); |
| g.moveTo(CHANNEL_LENGTH * 2, PLOT_HEIGHT); |
| |
| for (i = CHANNEL_LENGTH; i > 0; i--) { |
| n = (bytes.readFloat() * PLOT_HEIGHT); |
| g.lineTo(i * 2, PLOT_HEIGHT - n); |
| } |
| |
| g.lineTo(0, PLOT_HEIGHT); |
| g.endFill(); |
| } |
| |
| private function onPlaybackComplete(event:Event):void { |
| removeEventListener(Event.ENTER_FRAME, onEnterFrame); |
| } |
| } |
| } |
| |
| </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 "> |
| 再生中のサウンドをすべて停止します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 再生中のサウンドをすべて停止します。 |
| |
| <p class="- topic/p ">Flash Professional では、このメソッドで再生ヘッドが停止することはありません。ストリーミングするために設定されたサウンドは、そのサウンドが置かれているフレームに再生ヘッドが移動すると再生を再開します。</p> |
| |
| <p class="- topic/p ">このプロパティを使用するときは、次のセキュリティモデルを考慮してください。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li "> デフォルトでは、<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> メソッドを呼び出すと、呼び出し元のオブジェクトと同じセキュリティサンドボックス内にあるサウンドのみを停止します。呼び出し元のオブジェクトと同じサンドボックスから再生を開始しなかったサウンドは、停止されません。</li><li class="- topic/li ">サウンドをロードするとき、Sound クラスの <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> メソッドを使用すると、SoundLoaderContext オブジェクトである <codeph class="+ topic/ph pr-d/codeph ">context</codeph> パラメーターを指定できます。SoundLoaderContext オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> プロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定した場合、<ph class="- topic/ph ">Flash Player または</ph> Adobe AIR は、サウンドのロード元のサーバー上にクロスドメインポリシーファイルがあるかどうかをチェックします。 サーバーにクロスドメインポリシーファイルが存在しており、そのファイルで呼び出し元コンテンツのドメインが許可されている場合、<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> メソッドを使用してロードされたサウンドを停止することができます。許可されていない場合は、停止できません。</li></ul> |
| |
| <p class="- topic/p ">ただし、Adobe AIR では、<codeph class="+ topic/ph pr-d/codeph ">アプリケーション</codeph>セキュリティサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。</p> |
| |
| <p class="- topic/p ">セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：<xref href="http://www.adobe.com/go/devnet_security_jp" scope="external" class="- topic/xref ">セキュリティ</xref>を参照してください。</p> |
| |
| </apiDesc><example conref="examples\SoundMixer_stopAllExample.as" class="- topic/example "> 次の例では、<codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> メソッドを使用して、同時に再生される 2 つのサウンドをミュートします。 |
| |
| <p class="- topic/p ">コンストラクターで、2 つの異なるサウンドファイルがロードされ、再生するように設定されます。1 つ目のサウンドは、ローカルにロードされ、サウンドチャンネルに割り当てられます。ファイルが SWF ファイルと同じディレクトリにあると想定しています。2 つ目のファイルは、アドビ システムズ社のサイトからロードされ、ストリームされます。<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.stopAll()</codeph> メソッドを使用するには、すべてのサウンドがアクセス可能である必要があります。SoundLoaderContext オブジェクトを使用して、クロスドメインポリシーファイルをチェックできます。それぞれのサウンドには、サウンドファイルのロード中に IO エラーが発生した場合に呼び出されるイベントリスナーもあります。<codeph class="+ topic/ph pr-d/codeph ">muteButton</codeph> テキストフィールドも作成されます。クリックイベントを待機し、<codeph class="+ topic/ph pr-d/codeph ">muteButtonClickHandler()</codeph> メソッドを呼び出します。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">muteButtonClickHandler()</codeph> メソッドで、テキストフィールドの内容が "MUTE" の場合、<codeph class="+ topic/ph pr-d/codeph ">areSoundsInaccessible()</codeph> メソッドにより、サウンドミキサーがファイルにアクセスできるかどうかがチェックされます。ファイルがアクセス可能の場合、<codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> メソッドによってサウンドが停止されます。テキストフィールドをもう一度選択すると、1 つ目のサウンドの再生が開始され、テキストフィールドの内容が再び "MUTE" に変わります。今度は、<codeph class="+ topic/ph pr-d/codeph ">stopAll()</codeph> メソッドによって、実行中の 1 つのサウンドがミュートされます。サウンドチャンネルの <codeph class="+ topic/ph pr-d/codeph ">stop()</codeph> メソッドを使用して、チャンネルに割り当てられた特定のサウンドを停止することもできます。チャンネルの機能を使用するには、<codeph class="+ topic/ph pr-d/codeph ">play()</codeph> メソッドを呼び出すたびに、サウンドをチャンネルに再割り当てする必要があります。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.URLRequest; |
| import flash.media.Sound; |
| import flash.media.SoundLoaderContext; |
| import flash.media.SoundChannel; |
| import flash.media.SoundMixer; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.MouseEvent; |
| import flash.events.IOErrorEvent; |
| |
| public class SoundMixer_stopAllExample extends Sprite { |
| private var firstSound:Sound = new Sound(); |
| private var secondSound:Sound = new Sound(); |
| private var muteButton:TextField = new TextField(); |
| private var channel1:SoundChannel = new SoundChannel(); |
| |
| public function SoundMixer_stopAllExample() { |
| firstSound.load(new URLRequest("mySound.mp3")); |
| secondSound.load(new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3")); |
| |
| firstSound.addEventListener(IOErrorEvent.IO_ERROR, firstSoundErrorHandler); |
| secondSound.addEventListener(IOErrorEvent.IO_ERROR, secondSoundErrorHandler); |
| |
| channel1 = firstSound.play(); |
| secondSound.play(); |
| |
| muteButton.autoSize = TextFieldAutoSize.LEFT; |
| muteButton.border = true; |
| muteButton.background = true; |
| muteButton.text = "MUTE"; |
| |
| muteButton.addEventListener(MouseEvent.CLICK, muteButtonClickHandler); |
| |
| this.addChild(muteButton); |
| } |
| |
| private function muteButtonClickHandler(event:MouseEvent):void { |
| |
| if(muteButton.text == "MUTE") { |
| |
| if(SoundMixer.areSoundsInaccessible() == false) { |
| SoundMixer.stopAll(); |
| muteButton.text = "click to play only one of sound."; |
| } |
| else { |
| muteButton.text = "The sounds are not accessible."; |
| } |
| } |
| else { |
| firstSound.play(); |
| muteButton.text = "MUTE"; |
| } |
| } |
| |
| private function firstSoundErrorHandler(errorEvent:IOErrorEvent):void { |
| trace(errorEvent.text); |
| } |
| |
| private function secondSoundErrorHandler(errorEvent:IOErrorEvent):void { |
| trace(errorEvent.text); |
| } |
| } |
| } |
| </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 "> |
| サウンドのストリーミングを開始するまでに、埋め込まれたストリーミングサウンドをバッファーにプリロードする秒数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 "> |
| サウンドのストリーミングを開始するまでに、埋め込まれたストリーミングサウンドをバッファーにプリロードする秒数です。ロードされたサウンドのデータ（バッファー時間も含む）には、クロスドメインポリシーファイルを実装していない限り、別のドメインに存在する SWF ファイルからアクセスできません。セキュリティとサウンドの詳細については、Sound クラスの説明を参照してください。<ph class="- topic/ph ">ロードされたサウンドのデータ（バッファー時間も含む）には、クロスドメインポリシーファイルを実装していない限り、別のドメインに存在するファイルのコードからはアクセスできません。ただし、AIR アプリケーションのアプリケーションサンドボックスでは、コードは任意のソースからのサウンドファイルにあるデータにアクセスできます。セキュリティとサウンドの詳細については、Sound クラスの説明を参照してください。</ph> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> プロパティは SWF に埋め込まれたストリーミングサウンドのバッファー時間のみに影響し、動的に作成される Sound オブジェクト（ActionScript で作成される Sound オブジェクト）には影響しません。<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph> の値は、<codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> メソッドに渡される SoundLoaderContext オブジェクトで指定されたバッファー時間のデフォルト値に対して、オーバーライドや設定はできません。</p> |
| |
| </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 "> |
| グローバルサウンドプロパティを制御する 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> |
| |
| </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 "> |
| グローバルサウンドプロパティを制御する SoundTransform オブジェクトです。SoundTransform オブジェクトには、ボリューム、パン、左スピーカーの割り当て、および右スピーカーの割り当てを設定するプロパティが含まれます。このプロパティで使用される SoundTransform オブジェクトは、個々のサウンド設定が適用された後にすべてのサウンドに適用される最終的なサウンド設定を提供します。 |
| |
| </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 "> |
| CameraUI クラスを使用すると、デバイスのデフォルトのカメラアプリケーションで静止画またはビデオをキャプチャできます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| CameraUI クラスを使用すると、デバイスのデフォルトのカメラアプリケーションで静止画またはビデオをキャプチャできます。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> メソッドでは、デバイスがデフォルトのカメラアプリケーションを開く必要があります。キャプチャされる画像またはビデオは、complete イベントに対して送出される MediaEvent オブジェクトで使用できます。デフォルトのカメラアプリケーションは多様なフォーマットの画像またはビデオを保存できるため、返されるメディアオブジェクトを読み込んで AIR ランタイムで表示できる保証はありません。 </p> |
| |
| <p class="- topic/p ">一部のプラットフォームでは、カメラから返されるメディアオブジェクトに、ファイルベースのメディアプロミスとしてアクセスできます。そうでないプラットフォームでは、メディアプロミスがファイルベースではなく、MediaPromise オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">file</codeph> および <codeph class="+ topic/ph pr-d/codeph ">relativePath</codeph> プロパティが <codeph class="+ topic/ph pr-d/codeph ">null</codeph> になっています。これらのプロパティは、複数種類のプラットフォームで実行されるコードでは使用しないようにしてください。</p> |
| |
| <p class="- topic/p ">一部のプラットフォームでは、メディアオブジェクトは自動的にデバイスのメディアライブラリに保存されます。デフォルトのカメラアプリケーションで画像やビデオの保存が自動的に行われないプラットフォームでは、CameraRoll <codeph class="+ topic/ph pr-d/codeph ">addBitmapData()</codeph> 関数を使用することでメディアオブジェクトを保存できます。</p> |
| |
| <p class="- topic/p ">Android では、外部ストレージカードが使用できない場合（ユーザーが USB 大容量ストレージデバイスとしてカードをマウントした場合など）、デフォルトのカメラアプリケーションは開きません。さらに、カメラを起動した AIR アプリケーションはフォーカスを失います。デバイスが少ないリソースで実行される場合、メディアのキャプチャが完了する前に、オペレーティングシステムによって AIR アプリケーションが停止される可能性があります。</p> |
| |
| <p class="- topic/p ">AIR プロファイルのサポート：<i class="+ topic/ph hi-d/i "/>この機能はモバイルデバイスでサポートされますが、デスクトップオペレーティングシステムまたはテレビ用 AIR デバイスではサポートされません。<codeph class="+ topic/ph pr-d/codeph ">CameraUI.isSupported</codeph> プロパティを使用して、サポートされているかどうかを実行時にテストすることができます。複数のプロファイル間での API サポートについて詳しくは、<xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR プロファイルのサポート</xref>を参照してください。</p> |
| |
| </apiDesc><example conref="examples\CameraUIExample.Still.1.as" class="- topic/example "> 次の例では、CameraUI クラスを使用して、デバイスのデフォルトのカメラアプリケーションを起動します。ユーザーが写真を撮ると、この例では表示リストに画像が配置されます。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.desktop.NativeApplication; |
| import flash.display.Loader; |
| import flash.display.MovieClip; |
| import flash.display.StageAlign; |
| import flash.display.StageScaleMode; |
| import flash.events.ErrorEvent; |
| import flash.events.Event; |
| import flash.events.IOErrorEvent; |
| import flash.events.MediaEvent; |
| import flash.media.CameraUI; |
| import flash.media.MediaPromise; |
| import flash.media.MediaType; |
| |
| public class CameraUIStillImage extends MovieClip{ |
| |
| private var deviceCameraApp:CameraUI = new CameraUI(); |
| private var imageLoader:Loader; |
| |
| public function CameraUIStillImage() { |
| this.stage.align = StageAlign.TOP_LEFT; |
| this.stage.scaleMode = StageScaleMode.NO_SCALE; |
| |
| if( CameraUI.isSupported ) |
| { |
| trace( "Initializing camera..." ); |
| |
| deviceCameraApp.addEventListener( MediaEvent.COMPLETE, imageCaptured ); |
| deviceCameraApp.addEventListener( Event.CANCEL, captureCanceled ); |
| deviceCameraApp.addEventListener( ErrorEvent.ERROR, cameraError ); |
| deviceCameraApp.launch( MediaType.IMAGE ); |
| } |
| else |
| { |
| trace( "Camera interface is not supported."); |
| } |
| } |
| |
| private function imageCaptured( event:MediaEvent ):void |
| { |
| trace( "Media captured..." ); |
| |
| var imagePromise:MediaPromise = event.data; |
| |
| if( imagePromise.isAsync ) |
| { |
| trace( "Asynchronous media promise." ); |
| imageLoader = new Loader(); |
| imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, asyncImageLoaded ); |
| imageLoader.addEventListener( IOErrorEvent.IO_ERROR, cameraError ); |
| |
| imageLoader.loadFilePromise( imagePromise ); |
| } |
| else |
| { |
| trace( "Synchronous media promise." ); |
| imageLoader.loadFilePromise( imagePromise ); |
| showMedia( imageLoader ); |
| } |
| } |
| |
| private function captureCanceled( event:Event ):void |
| { |
| trace( "Media capture canceled." ); |
| NativeApplication.nativeApplication.exit(); |
| } |
| |
| private function asyncImageLoaded( event:Event ):void |
| { |
| trace( "Media loaded in memory." ); |
| showMedia( imageLoader ); |
| } |
| |
| private function showMedia( loader:Loader ):void |
| { |
| this.addChild( loader ); |
| } |
| |
| private function cameraError( error:ErrorEvent ):void |
| { |
| trace( "Error:" + error.text ); |
| NativeApplication.nativeApplication.exit(); |
| } |
| } |
| } |
| </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, and the Camera</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 "> |
| ユーザーが画像またはビデオを保存せずに Camera UI を閉じると、cancel イベントが送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.CANCEL</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ユーザーが画像またはビデオを保存せずに Camera UI を閉じると、<codeph class="+ topic/ph pr-d/codeph ">cancel</codeph> イベントが送出されます。 |
| |
| </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 "> |
| デフォルトのカメラを開くことができない場合、error イベントが送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ErrorEvent.ERROR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| デフォルトのカメラを開くことができない場合、<codeph class="+ topic/ph pr-d/codeph ">error</codeph> イベントが送出されます。 |
| |
| </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 "> |
| ユーザーが静止画像またはビデオを Camera UI でキャプチャすると、complete イベントが送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.MediaEvent.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.MediaEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ユーザーが静止画像またはビデオを Camera UI でキャプチャすると、<codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントが送出されます。 |
| |
| </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 "> |
| 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 "> |
| CameraUI オブジェクトを作成します。 |
| |
| </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 "> |
| デバイスでデフォルトのカメラアプリケーションを起動します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">requestedMediaType</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">キャプチャするメディアオブジェクトのタイプ。このパラメーターの有効な値は MediaType クラスで定義されています。 |
| <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> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| デバイスでデフォルトのカメラアプリケーションを起動します。 |
| |
| <p class="- topic/p ">このクラスで静止画像またはビデオをキャプチャできます。ビデオキャプチャでは、デバイスの "Quality Low" camcorder プロファイルを使用します。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">launch()</codeph> メソッドを呼び出すと、デバイスのデフォルトのカメラアプリケーションが呼び出されます。AIR アプリケーションはフォーカスを失い、ユーザーが静止画像をキャプチャするまで、またはビデオのキャプチャが完了するまで待機します。ユーザーが目的のメディアをキャプチャすると、AIR アプリケーションがフォーカスを再取得し、この CameraUI オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントを送出します。ユーザーが操作をキャンセルすると、この CameraUI オブジェクトは代わりに <codeph class="+ topic/ph pr-d/codeph ">cancel</codeph> イベントを送出します。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>ユーザーが画像またはビデオをキャプチャするまでバックグラウンドで待機しているときに、Android オペレーティングシステムによって AIR アプリケーションがシャットダウンされる可能性があります。この場合、ユーザーはアプリケーションを再起動する必要があります。AIR アプリケーションは、前の画像キャプチャに対して media イベントを送出しません。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントに対して送出された MediaEvent オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">data</codeph> プロパティを使用して、キャプチャ済みメディアファイルにアクセスできます。プロパティは MediaPromise クラスのインスタンスであり、Loader クラスの <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> メソッドを使用して、アプリケーションに読み込むことができます。デバイスカメラは多様なフォーマットでキャプチャ済みメディアを保存する可能性があります。この点について、ビデオは特に問題があります。キャプチャ済みメディアを AIR で表示できない場合があります。</p> |
| |
| </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 ">メディアオブジェクトがキャプチャされるときに送出されます。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">メディアオブジェクトがキャプチャされるときに送出されます。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI:launch_cancel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cancel</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ユーザーがメディアオブジェクトをキャプチャせずにネイティブカメラを終了するときに送出されます。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">ユーザーがメディアオブジェクトをキャプチャせずにネイティブカメラを終了するときに送出されます。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI:launch_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">デフォルトのカメラアプリケーションが使用中の場合に送出されます。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">デフォルトのカメラアプリケーションが使用中の場合に送出されます。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraUI:launch_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">AIR アプリケーションがこの関数を呼び出すときにバックグラウンドで実行されている場合に送出されます。 |
| |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">AIR アプリケーションがこの関数を呼び出すときにバックグラウンドで実行されている場合に送出されます。</shortdesc></adobeApiEvent></apiOperation><apiValue id="flash.media:CameraUI:isSupported:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">isSupported</apiName><shortdesc class="- topic/shortdesc "> |
| 現在のデバイスで CameraUI クラスがサポートされているかどうかをレポートします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在のデバイスで CameraUI クラスがサポートされているかどうかをレポートします。 |
| |
| </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 "> |
| SoundCodec クラスは、Microphone クラスの codec プロパティの設定で使用される定数値の列挙です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| SoundCodec クラスは、<codeph class="+ topic/ph pr-d/codeph ">Microphone</codeph> クラスの <codeph class="+ topic/ph pr-d/codeph ">codec</codeph> プロパティの設定で使用される定数値の列挙です。 |
| |
| </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 "> |
| Nellymoser コーデックをオーディオ圧縮に使用するように指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">NellyMoser</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Nellymoser コーデックをオーディオ圧縮に使用するように指定します。この定数は <codeph class="+ topic/ph pr-d/codeph ">Microphone.codec</codeph> プロパティのデフォルト値です。 |
| |
| </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 "> |
| Speex コーデックをオーディオ圧縮に使用するように指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">Speex</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Speex コーデックをオーディオ圧縮に使用するように指定します。 |
| |
| </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 "> |
| CameraRoll クラスを使用すると、システムメディアライブラリまたは "camera roll" の画像データにアクセスできます。AIR プロファイルのサポート：この機能はモバイルデバイスでサポートされますが、デスクトップオペレーティングシステムまたは AIR for 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 "> |
| CameraRoll クラスを使用すると、システムメディアライブラリまたは "camera roll" の画像データにアクセスできます。 |
| |
| <p class="- topic/p ">AIR プロファイルのサポート：<i class="+ topic/ph hi-d/i "/>この機能はモバイルデバイスでサポートされますが、デスクトップオペレーティングシステムまたはテレビ用 AIR デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、<xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR プロファイルのサポート</xref>を参照してください。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> メソッドは、画像をデバイスの専用メディアライブラリに追加します。アプリケーションが <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> メソッドをサポートしているかどうかを実行時に調べるには、<codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsAddBitmapData</codeph> プロパティの値を確認します。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> メソッドは、ユーザーがメディアライブラリの画像を選択できる画像選択ダイアログを開きます。ユーザーが画像を選択すると、CameraRoll オブジェクトは <codeph class="+ topic/ph pr-d/codeph ">select</codeph> イベントを送出します。選択した画像にアクセスするには、このイベントに対して送出された MediaEvent オブジェクトを使用します。アプリケーションが <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> メソッドをサポートするかどうかをランタイムに確認するには、<codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsBrowseForImage</codeph> プロパティを確認します。</p> |
| |
| </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 "> |
| 画像を選択せずにユーザーが画像の参照操作をキャンセルすると送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 画像を選択せずにユーザーが画像の参照操作をキャンセルすると送出されます。 |
| |
| </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 "> |
| ユーザーがデバイスメディアライブラリの画像を選択するときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| ユーザーがデバイスメディアライブラリの画像を選択するときに送出されます。 |
| |
| <p class="- topic/p ">このイベントに対して送出される MediaEvent オブジェクトで、選択したメディアにアクセスできます。</p> |
| |
| </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 "> |
| エラーが発生したときに error イベントが送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.ErrorEvent.ERROR</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| エラーが発生したときに <codeph class="+ topic/ph pr-d/codeph ">error</codeph> イベントが送出されます。 |
| |
| <p class="- topic/p ">次のようなエラーの原因があります。</p> |
| <ul class="- topic/ul "><li class="- topic/li ">画像ブラウザーを開くことができません。</li><li class="- topic/li ">画像ブラウザーが使用中です。</li><li class="- topic/li ">AIR アプリケーションがバックグラウンドで実行されている場合、画像の参照が試行されます。</li><li class="- topic/li ">画像をメディアライブラリに追加できません。</li><li class="- topic/li ">デバイスでサポートされないメソッドが呼び出されました。</li></ul> |
| |
| </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 "> |
| addBitmapData() 操作が正常に完了したことを通知します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.Event.COMPLETE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| addBitmapData() 操作が正常に完了したことを通知します。 |
| |
| </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 "> |
| 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 "> |
| CameraRoll オブジェクトを作成します。 |
| |
| <p class="- topic/p ">ActionScript でサポートされるメディアライブラリは 1 つのみです。すべての CameraRoll オブジェクトは同じ画像リポジトリに保存されます。</p> |
| |
| </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 "> |
| デバイスカメラロールに画像を追加します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">bitmapData</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.display:BitmapData</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">カメラロールに転送する画像を含む BitmapData オブジェクト。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| デバイスカメラロールに画像を追加します。 |
| |
| |
| <p class="- topic/p ">アプリケーションが <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> メソッドをサポートしているかどうかを実行時に調べるには、<codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsAddBitmapData</codeph> プロパティの値を確認します。</p> |
| |
| </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 "> |
| ユーザーがデバイスカメラロールから既存のイメージを選択できるイメージブラウザーダイアログを開きます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| ユーザーがデバイスカメラロールから既存のイメージを選択できるイメージブラウザーダイアログを開きます。 |
| |
| <p class="- topic/p ">ユーザーがイメージを選択すると、CameraRoll インスタンスは MediaEvent オブジェクトを含む <codeph class="+ topic/ph pr-d/codeph ">select</codeph> イベントを送出します。MediaEvent オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">data</codeph> プロパティを使用して画像を読み込みます。<codeph class="+ topic/ph pr-d/codeph ">data</codeph> プロパティは MediaPromise オブジェクトであり、Loader クラスの <codeph class="+ topic/ph pr-d/codeph ">loadFilePromise()</codeph> メソッドを使用して読み込むことができます。</p> |
| |
| <p class="- topic/p ">アプリケーションが <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> メソッドをサポートするかどうかをランタイムに確認するには、<codeph class="+ topic/ph pr-d/codeph ">CameraRoll.supportsBrowseForImage</codeph> プロパティを確認します。</p> |
| |
| </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 |
| { |
| import flash.media.CameraRoll; |
| import flash.media.MediaPromise; |
| import flash.media.MediaType; |
| import flash.events.MediaEvent; |
| import flash.events.Event; |
| import flash.display.Loader; |
| import flash.display.Sprite; |
| import flash.events.IOErrorEvent; |
| import flash.display.StageAlign; |
| import flash.display.StageScaleMode; |
| |
| public class CameraRollTest extends Sprite{ |
| private var mediaSource:CameraRoll = new CameraRoll(); |
| |
| public function CameraRollTest() { |
| this.stage.align = StageAlign.TOP_LEFT; |
| this.stage.scaleMode = StageScaleMode.NO_SCALE; |
| |
| if( CameraRoll.supportsBrowseForImage ) |
| { |
| log( "Browsing for image..." ); |
| mediaSource.addEventListener( MediaEvent.SELECT, imageSelected ); |
| mediaSource.addEventListener( Event.CANCEL, browseCanceled ); |
| |
| mediaSource.browseForImage(); |
| } |
| else |
| { |
| log( "Browsing in camera roll is not supported."); |
| } |
| } |
| |
| private var imageLoader:Loader; |
| private function imageSelected( event:MediaEvent ):void |
| { |
| log( "Image selected..." ); |
| |
| var imagePromise:MediaPromise = event.data; |
| |
| imageLoader = new Loader(); |
| if( imagePromise.isAsync ) |
| { |
| log( "Asynchronous media promise." ); |
| imageLoader.contentLoaderInfo.addEventListener( Event.COMPLETE, imageLoaded ); |
| imageLoader.contentLoaderInfo.addEventListener( IOErrorEvent.IO_ERROR, imageLoadFailed ); |
| imageLoader.loadFilePromise( imagePromise ); |
| } |
| else |
| { |
| log( "Synchronous media promise." ); |
| imageLoader.loadFilePromise( imagePromise ); |
| this.addChild( imageLoader ); |
| } |
| } |
| |
| private function browseCanceled( event:Event ):void |
| { |
| log( "Image browse canceled." ); |
| } |
| |
| private function imageLoaded( event:Event ):void |
| { |
| log( "Image loaded asynchronously." ); |
| this.addChild( imageLoader ); |
| } |
| |
| private function imageLoadFailed( event:Event ):void |
| { |
| log( "Image load failed." ); |
| } |
| |
| private function log( text:String ):void |
| { |
| trace( text ); |
| } |
| |
| } |
| |
| } |
| </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 ">ユーザーが画像を選択すると送出されます。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">ユーザーが画像を選択すると送出されます。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll:browseForImage_cancel" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">cancel</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:Event</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ユーザーが参照操作をキャンセルすると送出されます。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">ユーザーが参照操作をキャンセルすると送出されます。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll:browseForImage_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">デフォルトの画像ブラウザーアプリケーションが使用中の場合に送出されます。 |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">デフォルトの画像ブラウザーアプリケーションが使用中の場合に送出されます。</shortdesc></adobeApiEvent><adobeApiEvent id="flash.media:CameraRoll:browseForImage_error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">error</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:ErrorEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">AIR アプリケーションがこの関数を呼び出すときにバックグラウンドで実行されている場合に送出されます。 |
| |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">AIR アプリケーションがこの関数を呼び出すときにバックグラウンドで実行されている場合に送出されます。</shortdesc></adobeApiEvent></apiOperation><apiValue id="flash.media:CameraRoll:supportsAddBitmapData:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">supportsAddBitmapData</apiName><shortdesc class="- topic/shortdesc "> |
| CameraRoll.addBitmapData() メソッドがサポートされているかどうか。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.addBitmapData()</codeph> メソッドがサポートされているかどうか。現在のところ、この機能はモバイルデバイスの AIR アプリケーションでのみサポートされます。 |
| |
| </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 "> |
| CameraRoll.browseForImage() メソッドがサポートされるかどうかをレポートします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">CameraRoll.browseForImage() メソッドがサポートされるかどうかをレポートします。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| <codeph class="+ topic/ph pr-d/codeph ">CameraRoll.browseForImage()</codeph> メソッドがサポートされるかどうかをレポートします。現在のところ、この機能はモバイルデバイスの AIR アプリケーションでのみサポートされます。 |
| |
| </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 "> |
| 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 |
| </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 "> |
| Microphone クラスを使用すると、マイクからのオーディオを監視またはキャプチャできます。 |
| |
| <p class="- topic/p "> |
| Microphone インスタンスへの参照を取得するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> メソッドまたは <codeph class="+ topic/ph pr-d/codeph ">Microphone getEnhancedMicrophone()</codeph> メソッドを使用します。拡張された Microphone インスタンスは、音声エコー除去機能を実行できます。ヘッドセットを必要としないリアルタイムオーディオ／ビデオアプリケーションを作成するには、音声エコー除去機能を使用します。 |
| </p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">リアルタイムチャットアプリケーションの作成</b></p> |
| <p class="- topic/p ">リアルタイムチャットアプリケーションを作成するには、オーディをキャプチャして、Flash Media Server に送信します。NetConnection クラスと NetStream クラスを使用して、オーディオストリームを Flash Media Server に送信します。Flash Media Server はオーディオを他のクライアントにブロードキャストできます。ヘッドセットを必要としないチャットアプリケーションを作成するには、音声エコー除去機能を使用します。音声エコー除去機能によって、マイクから入ったオーディオがスピーカーに到達し出力され、もう一度マイクに入ってきた場合に発生するフィードバックループが防止されます。音声エコー除去機能を使用するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> メソッドを呼び出して、Microphone インスタンスへの参照を取得します。<codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> クラスのインスタンスに <codeph class="+ topic/ph pr-d/codeph ">Microp one.enhancedOptions</codeph> を設定して、設定を構成します。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">マイク音声のローカルでの再生</b></p> |
| <p class="- topic/p ">ローカルのコンピューターまたはデバイスの音声出力に対してマイク音声を直接ルーティングするには、<codeph class="+ topic/ph pr-d/codeph ">setLoopback()</codeph> メソッドを呼び出します。制御されていないオーディオフィードバックは危険な可能性があり、マイク入力で音声出力が取得できる場合は常に発生する可能性があります。<codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> によってフィードバックの増幅のリスクは軽減されますが、なくなりません。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">マイク音声のキャプチャ（ローカルでの記録または処理用）</b></p> |
| <p class="- topic/p ">マイク音声をキャプチャするには、Microphone インスタンスによって送出される <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントを監視します。このイベントに対して送出される SampleDataEvent オブジェクトには、音声データが含まれます。</p> |
| |
| <p class="- topic/p ">ビデオのキャプチャについて詳しくは、Camera クラスのトピックを参照してください。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">ランタイムマイクのサポート</b></p> |
| <p class="- topic/p ">Microphone クラスは、モバイルブラウザーで実行される Flash Player ではサポートされません。</p> |
| |
| <p class="- topic/p ">AIR プロファイルのサポート：<i class="+ topic/ph hi-d/i "/>Microphone クラスはデスクトップオペレーティングシステムではサポートされますが、モバイルデバイスの種類によってはサポートされません。また、テレビ用 AIR デバイスではサポートされません。複数のプロファイル間での API サポートについて詳しくは、<xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR プロファイルのサポート</xref>を参照してください。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Microphone.isSupported</codeph> プロパティを使用すると、サポートされているかどうかを実行時にテストすることができます。ただし、テレビ用 AIR デバイスでは、<codeph class="+ topic/ph pr-d/codeph ">Microphone.isSupported</codeph> は <codeph class="+ topic/ph pr-d/codeph ">true</codeph> ですが <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> が返す値は常に <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">プライバシーコントロール</b></p> |
| <p class="- topic/p "> |
| ユーザーがマイクへのアクセスを許可するか拒否するかを選択できるように、Flash Player でプライバシーダイアログボックスが表示されます。アプリケーションのウィンドウサイズは 215 × 138 ピクセル（ダイアログボックスの表示に必要な最小サイズ）以上にする必要があります。そのサイズ未満では自動的に拒否されます。 |
| </p> |
| <p class="- topic/p ">AIR アプリケーションサンドボックスで実行されるコンテンツには、マイクにアクセスする権限が必要ないため、ダイアログは表示されません。アプリケーションサンドボックス以外で実行されている AIR コンテンツには権限が必要なので、Privacy ダイアログが表示されます。</p> |
| |
| </apiDesc><example conref="examples\MicrophoneExample.as" class="- topic/example "> 次の例では、コンピューターのマイクへのアクセスを許可した後に、エコー抑制を使用してマイクからサウンドをキャプチャします。<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> メソッドは、ユーザーのマイクにアクセス許可を要求する Flash Player ダイアログボックスを表示します。<codeph class="+ topic/ph pr-d/codeph ">setLoopBack(true)</codeph> を呼び出すと、入力をローカルスピーカーに切り替えるため、例を実行中にサウンドを聴くことができます。 |
| |
| <p class="- topic/p ">2 つのリスナーは、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> および <codeph class="+ topic/ph pr-d/codeph ">status</codeph> のイベントを受け取ります。<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントはセッションの開始時と終了時（存在する場合）に送出され、<codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> メソッドによって捕捉されます。このメソッドはイベントの情報をトレースします。<codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベントは、関連付けられた Microphone オブジェクトがステータス情報をレポートした場合に送出され、<codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph> メソッドを使用して捕捉、トレースされます。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>この例を正しく機能させるには、コンピューターにマイクを接続しておく必要があります。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| import flash.events.*; |
| import flash.media.Microphone; |
| import flash.system.Security; |
| |
| public class MicrophoneExample extends Sprite { |
| public function MicrophoneExample() { |
| var mic:Microphone = Microphone.getMicrophone(); |
| Security.showSettings("2"); |
| mic.setLoopBack(true); |
| |
| if (mic != null) { |
| mic.setUseEchoSuppression(true); |
| mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler); |
| mic.addEventListener(StatusEvent.STATUS, statusHandler); |
| } |
| } |
| |
| private function activityHandler(event:ActivityEvent):void { |
| trace("activityHandler: " + event); |
| } |
| |
| private function statusHandler(event:StatusEvent):void { |
| trace("statusHandler: " + event); |
| } |
| } |
| } |
| </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：Implementing Acoustic Echo Suppression in Flash/Flex applications</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：Voice Notes for 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, and the 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 "> |
| マイクがそのステータスをレポートしたときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| マイクがそのステータスをレポートしたときに送出されます。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Muted"</codeph> である場合、SWF ファイルのマイクへのアクセスをユーザーが拒否しています。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Unmuted"</codeph> である場合、SWF ファイルのマイクへのアクセスをユーザーが許可しています。 |
| |
| <p class="- topic/p ">ステータスイベントは Adobe AIR アプリケーションで送出されません。マイクへのアクセスは動的に変更できません。ほとんどのプラットフォームでは、AIR アプリケーションから常にマイクにアクセスできます。Android では、アプリケーションでアプリケーション記述子に Android RECORD_AUDIO 権限を指定する必要があります。指定していない場合、Android はマイクへのアクセスも拒否します。</p> |
| |
| </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 "> |
| マイクのバッファーにサウンドデータがある場合に送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| マイクのバッファーにサウンドデータがある場合に送出されます。 |
| <p class="- topic/p "> |
| <codeph class="+ topic/ph pr-d/codeph ">Microphone.rate</codeph> プロパティにより、秒単位で生成されるサンプル数が決まります。 イベント別のサンプル数は秒単位のサンプル数の倍数で、イベントコール間のレーテンシーです。 |
| </p> |
| |
| </apiDesc><example conref="examples\Microphone.sampleDataEvent.1.as" class="- topic/example "> 次の例ではデフォルトのマイクから 4 秒間の音声サンプルをキャプチャして再生します。マイクが接続されていることを確認してください。<codeph class="+ topic/ph pr-d/codeph ">micSampleDataHandler()</codeph> は Microphone オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントのイベントリスナーです。<codeph class="+ topic/ph pr-d/codeph ">micSampleDataHandler()</codeph> メソッドはサンプルが利用可能になるとサンプルを取得し、その値を ByteArray オブジェクトに付加します。Timer オブジェクトは 4 秒間設定されます。Timer は、Microphone オブジェクトイベントリスナーの <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントを削除し、Sound オブジェクトを作成し、Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントリスナーを追加します。Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントリスナー、<codeph class="+ topic/ph pr-d/codeph ">playbackSampleHandler()</codeph> メソッドは Sound オブジェクトで再生する音声サンプルを提供します。これらの音声サンプルは、Microphone サンプルを保存した ByteArray オブジェクトから取得されます。Microphone サンプルはモノラルサウンドで録音され、Sound オブジェクトはステレオペアのサンプルを要求するので、サンプルは Sound オブジェクトで 2 回書き込まれます。Microphone オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">rate</codeph> プロパティは、Sound オブジェクトで使用される 44-kHz サンプルレートに一致するように 44 に設定されます。 |
| |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| const DELAY_LENGTH:int = 4000; |
| |
| var mic:Microphone = Microphone.getMicrophone(); |
| mic.setSilenceLevel(0, DELAY_LENGTH); |
| mic.gain = 100; |
| mic.rate = 44; |
| mic.addEventListener(SampleDataEvent.SAMPLE_DATA, micSampleDataHandler); |
| |
| var timer:Timer = new Timer(DELAY_LENGTH); |
| timer.addEventListener(TimerEvent.TIMER, timerHandler); |
| timer.start(); |
| |
| var soundBytes:ByteArray = new ByteArray(); |
| |
| function micSampleDataHandler(event:SampleDataEvent):void |
| { |
| while(event.data.bytesAvailable) |
| { |
| var sample:Number = event.data.readFloat(); |
| soundBytes.writeFloat(sample); |
| } |
| } |
| |
| function timerHandler(event:TimerEvent):void |
| { |
| mic.removeEventListener(SampleDataEvent.SAMPLE_DATA, micSampleDataHandler); |
| timer.stop(); |
| soundBytes.position = 0; |
| var sound:Sound = new Sound(); |
| sound.addEventListener(SampleDataEvent.SAMPLE_DATA, playbackSampleHandler); |
| sound.play(); |
| } |
| |
| function playbackSampleHandler(event:SampleDataEvent):void |
| { |
| for (var i:int = 0; i < 8192 && soundBytes.bytesAvailable > 0; i++) |
| { |
| var sample:Number = soundBytes.readFloat(); |
| event.data.writeFloat(sample); |
| event.data.writeFloat(sample); |
| } |
| } |
| </codeblock></example><example conref="examples\MicrophoneExample.as" class="- topic/example "> 次の例では、コンピューターのマイクへのアクセスを許可した後に、エコー抑制を使用してマイクからサウンドをキャプチャします。<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> メソッドは、ユーザーのマイクにアクセス許可を要求する Flash Player ダイアログボックスを表示します。<codeph class="+ topic/ph pr-d/codeph ">setLoopBack(true)</codeph> を呼び出すと、入力をローカルスピーカーに切り替えるため、例を実行中にサウンドを聴くことができます。 |
| |
| <p class="- topic/p ">2 つのリスナーは、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> および <codeph class="+ topic/ph pr-d/codeph ">status</codeph> のイベントを受け取ります。<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントはセッションの開始時と終了時（存在する場合）に送出され、<codeph class="+ topic/ph pr-d/codeph ">activityHandler()</codeph> メソッドによって捕捉されます。このメソッドはイベントの情報をトレースします。<codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベントは、関連付けられた Microphone オブジェクトがステータス情報をレポートした場合に送出され、<codeph class="+ topic/ph pr-d/codeph ">statusHandler()</codeph> メソッドを使用して捕捉、トレースされます。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>この例を正しく機能させるには、コンピューターにマイクを接続しておく必要があります。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| import flash.events.*; |
| import flash.media.Microphone; |
| import flash.system.Security; |
| |
| public class MicrophoneExample extends Sprite { |
| public function MicrophoneExample() { |
| var mic:Microphone = Microphone.getMicrophone(); |
| Security.showSettings("2"); |
| mic.setLoopBack(true); |
| |
| if (mic != null) { |
| mic.setUseEchoSuppression(true); |
| mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler); |
| mic.addEventListener(StatusEvent.STATUS, statusHandler); |
| } |
| } |
| |
| private function activityHandler(event:ActivityEvent):void { |
| trace("activityHandler: " + event); |
| } |
| |
| private function statusHandler(event:StatusEvent):void { |
| trace("statusHandler: " + event); |
| } |
| } |
| } |
| </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 "> |
| マイクの録音が開始されたとき、または無音が検出されたために録音が停止されたときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| マイクの録音が開始されたとき、または無音が検出されたために録音が停止されたときに送出されます。 |
| |
| <p class="- topic/p "> |
| <codeph class="+ topic/ph pr-d/codeph ">activating</codeph> プロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定して、このイベントをトリガーするために必要な音量を指定するか、<codeph class="+ topic/ph pr-d/codeph ">activating</codeph> プロパティを <codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定して、このイベントをトリガーするためにサウンドなしで経過する必要がある時間を指定するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> を使用します。 |
| </p> |
| <p class="- topic/p ">activity イベントを送信する Microphone オブジェクトの場合、<codeph class="+ topic/ph pr-d/codeph ">setLoopback( true )</codeph> を呼び出すか、sampleData イベントを監視するか、マイクを NetStream オブジェクトにアタッチして、アプリケーションで入力を監視する必要があります。</p> |
| |
| </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 "> |
| 音声エコー除去機能を実行できる拡張された Microphone オブジェクトへの参照を返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.3" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2.7" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">オーディオをキャプチャする Microphone オブジェクトの参照です。拡張オーディオが初期化に失敗すると、<codeph class="+ topic/ph pr-d/codeph ">null</codeph> が返されます。 |
| </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 ">マイクのインデックス値です。 |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 音声エコー除去機能を実行できる拡張された Microphone オブジェクトへの参照を返します。ヘッドセットを必要としないオーディオ／ビデオチャットアプリケーションを作成するには、音声エコー除去機能を使用します。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> メソッドおよび <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> メソッドの <codeph class="+ topic/ph pr-d/codeph ">index</codeph> パラメーターは同様に動作します。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">重要：</b>どの時点においても、存在できる拡張マイクデバイスのインスタンスは 1 つのみです。その他すべての Microphone インスタンスでは、オーディオデータの供給が停止され、<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティが <codeph class="+ topic/ph pr-d/codeph ">Microphone.Unavailable</codeph> の <codeph class="+ topic/ph pr-d/codeph ">StatusEvent</codeph> が発生します。拡張オーディオが初期化に失敗すると、このメソッドの呼び出しに <codeph class="+ topic/ph pr-d/codeph ">null</codeph> が返され、<codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> の値の設定は効果を持たず、既存の Microphone インスタンスはすべて従来と同様に機能します。</p> |
| |
| <p class="- topic/p ">拡張された Microphone オブジェクトを設定するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> プロパティを設定します。次のコードでは、拡張された Microphone オブジェクトと、全二重の音声エコー除去機能をローカルテストで使用します。</p> |
| |
| <pre xml:space="preserve" class="- topic/pre "> |
| var mic:Microphone = Microphone.getEnhancedMicrophone(); |
| var options:MicrophoneEnhancedOptions = new MicrophoneEnhancedOptions(); |
| options.mode = MicrophoneEnhancedMode.FULL_DUPLEX; |
| mic.enhancedOptions = options; |
| mic.setLoopBack(true); |
| </pre> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> メソッドは、音声エコー除去機能を使用する場合は無視されます。 |
| </p> |
| |
| <p class="- topic/p "> |
| SWF ファイルで <codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> メソッドから返されたマイクにアクセスしようとすると（<codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph> を呼び出すなど）プライバシーダイアログボックスが表示され、そのマイクへのアクセスを許可するか拒否するかをユーザーが選択できます。ステージのサイズは必ず 215 × 138 ピクセル以上に設定してください。これは、ダイアログボックスを表示するために必要な最小サイズです。 |
| </p> |
| |
| |
| </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 "> |
| |
| オーディオをキャプチャする Microphone オブジェクトの参照を返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, Microphone.getMicropone, getMicrophone |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">オーディオをキャプチャする Microphone オブジェクトの参照です。 |
| |
| </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 ">マイクのインデックス値です。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| |
| オーディオをキャプチャする Microphone オブジェクトの参照を返します。オーディオのキャプチャを開始するには、Microphone オブジェクトを NetStream オブジェクトに接続する必要があります。<codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph> のトピックを参照してください。 |
| |
| <p class="- topic/p "> |
| <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> を複数回呼び出すと、同じマイクが参照されます。したがって、コードに <codeph class="+ topic/ph pr-d/codeph ">mic1 = Microphone.getMicrophone()</codeph> および <codeph class="+ topic/ph pr-d/codeph ">mic2 = Microphone.getMicrophone()</codeph> という行が含まれている場合、<codeph class="+ topic/ph pr-d/codeph ">mic1</codeph> と <codeph class="+ topic/ph pr-d/codeph ">mic2</codeph> は両方とも同じデフォルトのマイクを参照します。</p> |
| |
| <p class="- topic/p "> |
| 通常は、<codeph class="+ topic/ph pr-d/codeph ">index</codeph> の値を渡さないでください。デフォルトのマイクを参照するには、単に <codeph class="+ topic/ph pr-d/codeph ">air.Microphone.getMicrophone()</codeph> を呼び出します。Flash Player 設定パネルの「マイク」セクションを使用して、アプリケーションで使用するデフォルトのマイクを指定できます。 （Flash Player 設定パネルには、Web ブラウザーで実行している Flash Player コンテンツを右クリックしてアクセスします。）<codeph class="+ topic/ph pr-d/codeph ">index</codeph> で値を渡すと、ユーザーが使用するのとは異なるマイクが参照される可能性があります。<codeph class="+ topic/ph pr-d/codeph ">index</codeph> を使用できるのは、アプリケーションで 2 つのマイクから同時にオーディオをキャプチャする場合など、特殊な場合です。Adobe AIR で実行されるコンテンツも Flash Player のデフォルトのマイクの設定を使用します。</p> |
| |
| <p class="- topic/p "> |
| 現在の Microphone オブジェクトのインデックス値を取得するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.index</codeph> プロパティを使用します。次に、Microphone クラスの他のメソッドにこの値を渡します。 |
| </p> |
| |
| <p class="- topic/p "> |
| SWF ファイルで <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> メソッドから返されたマイクにアクセスしようとすると（<codeph class="+ topic/ph pr-d/codeph ">NetStream.attachAudio()</codeph> を呼び出すなど）、プライバシーダイアログボックスが表示され、そのマイクへのアクセスを許可するか拒否するかをユーザーが選択できます。ステージのサイズは必ず 215 × 138 ピクセル以上に設定してください。これは、ダイアログボックスを表示するために必要な最小サイズです。 |
| </p> |
| |
| <p class="- topic/p "> |
| ユーザーがこのダイアログボックスに応答すると、ユーザーの応答を示す <codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベントが送出されます。<codeph class="+ topic/ph pr-d/codeph ">Microphone.muted</codeph> プロパティを確認して、ユーザーがマイクへのアクセスを許可したか、拒否したかを判別することもできます。 |
| </p> |
| |
| <p class="- topic/p "> |
| <codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> が <codeph class="+ topic/ph pr-d/codeph ">null</codeph> を返した場合は、マイクが別のアプリケーションで使用されているか、そのシステムにマイクがインストールされていません。マイクがインストールされているかどうかを調べるには、<codeph class="+ topic/ph pr-d/codeph ">Microphones.names.length</codeph> を使用します。Flash Player の [マイク] パネルを表示して、<codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone</codeph> で参照するマイクをユーザーが選択できるようにするには、<codeph class="+ topic/ph pr-d/codeph ">Security.showSettings()</codeph> を使用します。 |
| |
| </p> |
| |
| </apiDesc><example conref="examples\Microphone_getMicrophone.as" class="- topic/example "> 次の例は、静的 Microphone.getMicrophone() メソッドを使用し、ステータスイベントを待機して、ユーザーのマイクへのアクセスを要求する方法を示しています。<xref href="http://actionscriptexamples.com/2008/12/04/detecting-the-microphone-in-flash-using-actionscript-30/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref> で作成された例。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var mic:Microphone = Microphone.getMicrophone(); |
| mic.setLoopBack(); |
| mic.addEventListener(StatusEvent.STATUS, mic_status); |
| |
| var tf:TextField = new TextField(); |
| tf.autoSize = TextFieldAutoSize.LEFT; |
| tf.text = "Detecting microphone..."; |
| addChild(tf); |
| |
| function mic_status(evt:StatusEvent):void { |
| tf.text = "Microphone is muted?: " + mic.muted; |
| switch (evt.code) { |
| case "Microphone.Unmuted": |
| tf.appendText("\n" + "Microphone access was allowed."); |
| break; |
| case "Microphone.Muted": |
| tf.appendText("\n" + "Microphone access was denied."); |
| break; |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/event:status" class="- topic/link "><linktext class="- topic/linktext ">Microphone.status</linktext></link><link href="flash.net.xml#NetStream/attachAudio()" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.attachAudio()</linktext></link><link href="flash.system.xml#Security/showSettings()" class="- topic/link "><linktext class="- topic/linktext ">flash.system.Security.showSettings()</linktext></link></related-links><adobeApiEvent id="flash.media:Microphone:getMicrophone_status" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">status</apiName><prolog class="- topic/prolog "/><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events:StatusEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc ">マイクがそのステータスをレポートしたときに送出されます。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Muted"</codeph> である場合、SWF ファイルのマイクへのアクセスをユーザーが拒否しています。<codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">"Microphone.Unmuted"</codeph> である場合、SWF ファイルのマイクへのアクセスをユーザーが許可しています。 |
| |
| </apiDesc></adobeApiEventDetail><shortdesc class="- topic/shortdesc ">マイクがそのステータスをレポートしたときに送出されます。</shortdesc></adobeApiEvent></apiOperation><apiOperation id="flash.media:Microphone:setLoopBack" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setLoopBack</apiName><shortdesc class="- topic/shortdesc "> |
| マイクによってキャプチャされたオーディオをローカルスピーカーに転送します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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. |
| </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 "> |
| マイクによってキャプチャされたオーディオをローカルスピーカーに転送します。 |
| |
| </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 "> |
| サウンドと見なす最小入力レベルと、実際に無音状態が始まったと見なすまでの無音時間の長さを設定します。後者は省略可能です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">silenceLevel</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">マイクを有効化したり、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントを送出するために必要な音量です。使用可能な値の範囲は 0 ～ 100 です。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">timeout</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">-1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">アクティビティがない場合に、サウンドが停止したと Flash Player または Adobe AIR が判定し <codeph class="+ topic/ph pr-d/codeph ">dispatch</codeph> イベントを送出するまでの時間（ミリ秒単位）です。 デフォルト値は 2000（2 秒）です。（<b class="+ topic/ph hi-d/b ">注意：</b>シグネチャで示されたデフォルト値（-1）は、2000 を使用することを Flash Player または Adobe AIR に伝える内部値です。） |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| サウンドと見なす最小入力レベルと、実際に無音状態が始まったと見なすまでの無音時間の長さを設定します。後者は省略可能です。 |
| <ul class="- topic/ul "><li class="- topic/li ">マイクがサウンドをまったく検知しないようにするには、<codeph class="+ topic/ph pr-d/codeph ">silenceLevel</codeph> に値 100 を渡します。こうすると、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントが送出されることはありません。 </li><li class="- topic/li ">マイクが現在検知している音量を調べるには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.activityLevel</codeph> を使用します。 </li></ul> |
| |
| <p class="- topic/p ">Speex には Voice Activity Detection（VAD）が搭載されており、音声が検出されない場合は自動的に帯域幅を減らします。Speex コーデックを使用する場合は、サイレンスレベルを 0 に設定することをお勧めします。</p> |
| |
| <p class="- topic/p ">アクティビティ検知とは、人が話していることをオーディオレベルに基づいて検知する機能のことです。誰も話していないときは、関連付けられているオーディオストリームを送信する必要がないので、帯域幅を節約できます。この情報を利用して、ユーザー（または他の誰か）が話していないことを視覚的なフィードバックとして示すこともできます。</p> |
| |
| <p class="- topic/p ">サイレンス値はアクティビティ値に直接対応します。完全なサイレンスのアクティビティ値は 0 です。継続的な大音量（現在のゲイン設定に基づく最大の音量）のアクティビティ値は 100 です。ゲイン（増幅率）を適切に調整すると、話していないときにはアクティビティ値がサイレンス値よりも小さくなります。話しているときには、アクティビティ値はサイレンス値よりも大きくなります。</p> |
| |
| <p class="- topic/p ">このメソッドは <codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> に似ています。どちらのメソッドも、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントの送出タイミングを指定するために使用します。ただし、パブリッシュするストリームに対する影響という点では、この 2 つのメソッドは大きく異なります。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Camera.setMotionLevel()</codeph> はモーションを検知し、使用する帯域幅には影響しないように設計されています。ビデオストリームでモーションが検知されない間も、ビデオは送信されます。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> は帯域幅を最適化するように設計されています。オーディオストリームが無音と考えられる場合には、オーディオデータは送信されません。代わりに、無音状態が始まったことを示すメッセージが送信されます。 </li></ul> |
| |
| </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 "> |
| オーディオコーデックのエコー抑制機能を使用するかどうかを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 ">エコー抑制を使用するか（<codeph class="+ topic/ph pr-d/codeph ">true</codeph>）、使用しないか（<codeph class="+ topic/ph pr-d/codeph ">false</codeph>）を示すブール値。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| オーディオコーデックのエコー抑制機能を使用するかどうかを指定します。Flash Player 設定パネルの「マイク」でユーザーが「エコーを減らす」を選択していない限り、デフォルト値は <codeph class="+ topic/ph pr-d/codeph ">false</codeph> です。 |
| |
| <p class="- topic/p ">エコー抑制とは、スピーカーから出たサウンドが同じシステムのマイクによって拾われるオーディオフィードバックの影響を減らす機能のことです。（これは、フィードバックを完全に除去する音声エコー除去機能とは異なります。<codeph class="+ topic/ph pr-d/codeph ">setUseEchoSuppression()</codeph> メソッドは、<codeph class="+ topic/ph pr-d/codeph ">getEnhancedMicrophone()</codeph> メソッドを呼び出して音声エコー除去機能を使用する場合は無視されます）。</p> |
| |
| <p class="- topic/p ">一般に、キャプチャするサウンドをヘッドセットではなくスピーカーで再生する場合には、エコー抑制機能を使用することが推奨されます。サウンド出力デバイスをユーザーが選択できるようにした SWF ファイルでは、ユーザーがスピーカーを選択し、マイクも使用する場合に <codeph class="+ topic/ph pr-d/codeph ">Microphone.setUseEchoSuppression(true)</codeph> を呼び出すことをお勧めします。 </p> |
| |
| <p class="- topic/p ">ユーザーは、Flash Player 設定パネルの「マイク」でこれらの設定を調整することもできます。</p> |
| |
| </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 "> |
| マイクが検知している音量です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| マイクが検知している音量です。値の範囲は 0（サウンドが検知されていない）～ 100（非常に大音量が検知されている）です。このプロパティ値に基づいて、<codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> メソッドに渡す適切な値を判断できます。 |
| |
| <p class="- topic/p ">マイクの <codeph class="+ topic/ph pr-d/codeph ">muted</codeph> プロパティが <codeph class="+ topic/ph pr-d/codeph ">true</codeph> の場合、このプロパティの値は常に -1 です。</p> |
| |
| </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 "> |
| 音声を圧縮するために使用するコーデックです。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| 音声を圧縮するために使用するコーデックです。使用できるコーデックは、Nellymoser（デフォルト）と Speex です。列挙クラス <codeph class="+ topic/ph pr-d/codeph ">SoundCodec</codeph> は、<codeph class="+ topic/ph pr-d/codeph ">codec</codeph> プロパティに対して有効な各値を含みます。 |
| |
| <p class="- topic/p ">Nellymoser コーデックを使用する場合、<codeph class="+ topic/ph pr-d/codeph ">Microphone.rate()</codeph> を使用してサンプルレートを設定できます。Speex コーデックを使用する場合、サンプルレートは 16 kHz に設定されます。</p> |
| |
| <p class="- topic/p ">Speex には Voice Activity Detection（VAD）が搭載されており、音声が検出されない場合は自動的に帯域幅を減らします。Speex コーデックを使用する場合は、サイレンスレベルを 0 に設定することをお勧めします。サイレンスレベルを設定するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> メソッドを使用します。</p> |
| |
| |
| |
| </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 "> |
| 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, |
| </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 "> |
| Speex の音声アクティビティ検知機能を有効にします。 |
| |
| </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 "> |
| Speex コーデックを使用する場合の、エンコードされた音質です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, |
| </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 "> |
| Speex コーデックを使用する場合の、エンコードされた音質です。指定できる値は、0 ～ 10 です。デフォルト値は 6 です。次の表に示すとおり、値が大きいほど質は高くなりますが、必要な帯域幅も増えます。リストされたビットレートの値はネットのビットレートを表し、パケットのオーバーヘッドは含まれません。 |
| <p class="- topic/p "> |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">質の値</entry><entry class="- topic/entry ">必要なビットレート（1 秒あたりのキロビット数）</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> |
| </p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/codec" class="- topic/link "><linktext class="- topic/linktext ">コーデック</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 "> |
| 拡張マイクのオプションを制御します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 拡張マイクのオプションを制御します。詳しくは、<codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> クラスを参照してください。このプロパティは、拡張された Microphone インスタンスに対してではない場合、無視されます。 |
| |
| </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 "> |
| 1 パケット（メッセージ）で送信される Speex 音声フレームの数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, |
| </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 "> |
| 1 パケット（メッセージ）で送信される Speex 音声フレームの数です。各フレームの長さは 20 ミリ秒です。デフォルト値は、1 パケットあたり 2 フレームです。 |
| |
| <p class="- topic/p ">メッセージ内の Speex フレームが増えるほど、必要な帯域幅は減りますが、メッセージの送信が遅れます。Speex フレームが少ないほど、必要な帯域幅は増えますが、遅延が軽減されます。</p> |
| |
| </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 "> |
| マイクが信号を増強する量です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| マイクが信号を増強する量です。指定できる値は 0 ～ 100 です。デフォルト値は 50 です。 |
| |
| |
| </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 "> |
| マイクのインデックスです。これは、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 |
| </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 "> |
| マイクのインデックスです。これは、<codeph class="+ topic/ph pr-d/codeph ">Microphone.names</codeph> から返される配列のインデックスと同じです。 |
| |
| |
| </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 "> |
| 現在のプラットフォームで Microphone クラスがサポートされている場合、isSupported プロパティは true に設定されます。サポートされていない場合は、false に設定されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10.1" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 現在のプラットフォームで Microphone クラスがサポートされている場合、<codeph class="+ topic/ph pr-d/codeph ">isSupported</codeph> プロパティは <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定されます。サポートされていない場合は、<codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定されます。 |
| |
| </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 "> |
| ユーザーがマイクへのアクセスを拒否している（true）か、許可している（false）かを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.muted, muted |
| </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 "> |
| ユーザーがマイクへのアクセスを拒否しているか（<codeph class="+ topic/ph pr-d/codeph ">true</codeph>）、許可しているか（<codeph class="+ topic/ph pr-d/codeph ">false</codeph>）を指定します。この値が変わると、<codeph class="+ topic/ph pr-d/codeph ">status</codeph> イベントが送出されます。詳細については、<codeph class="+ topic/ph pr-d/codeph ">Microphone.getMicrophone()</codeph> を参照してください。 |
| |
| |
| </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 "> |
| サウンドキャプチャハードウェアから返される現在のサウンドキャプチャデバイスの名前です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| サウンドキャプチャハードウェアから返される現在のサウンドキャプチャデバイスの名前です。 |
| |
| |
| </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 "> |
| 使用可能なすべてのサウンドキャプチャデバイスの名前を含むストリングの配列です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 |
| </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 "> |
| 使用可能なすべてのサウンドキャプチャデバイスの名前を含むストリングの配列です。この名前は、ユーザーに Flash Player 設定パネルの「プライバシー」を表示せずに返されます。この配列により、各サウンドキャプチャデバイスの 0 から始まるインデックスと、システム上の各サウンドキャプチャデバイスの数（<codeph class="+ topic/ph pr-d/codeph ">Microphone.names.length</codeph> プロパティ）を調べることができます。詳細については、Array クラスのエントリを参照してください。 |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Microphone.names</codeph> プロパティを呼び出すと、ハードウェアを広範囲にわたって調べる必要があり、配列を作成するまでに数秒間かかることがあります。ほとんどの場合は、デフォルトのマイクをそのまま使用できます。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>現在のマイクの名前を調べるには、<codeph class="+ topic/ph pr-d/codeph ">name</codeph> プロパティを使用します。</p> |
| |
| </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 "> |
| Speex エンコーダーで使用されるノイズの最大減衰（dB （負数））です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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, |
| </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 "> |
| Speex エンコーダーで使用されるノイズの最大減衰（dB （負数））です。有効になっている場合、Speex 圧縮の前に Microphone からキャプチャされるサウンドにノイズ抑制が適用されます。ノイズ抑制を無効にするには、0 に設定します。ノイズ抑制は、デフォルトでは -30 dB の最大減衰で有効になっています。 Nellymoser コーデックが選択されると無視されます。 |
| |
| </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 "> |
| マイクがサウンドをキャプチャしているレート（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 |
| </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 "> |
| マイクがサウンドをキャプチャしているレート（kHz）です。使用できる値は 5、8、11、22、および 44 です。デフォルト値は 8 kHz ですが、サウンドキャプチャデバイスがこの値に対応している必要があります。対応していない場合、デフォルト値はそのサウンドキャプチャデバイスが対応している 8 kHz よりも高いレートのうち、8 kHz に最も近い値になります。通常は 11 kHz です。 |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b> 実際のレートは次の表に記載されているように <codeph class="+ topic/ph pr-d/codeph ">rate</codeph> 値とは少し異なります。</p> |
| |
| <adobetable class="+ topic/table adobe-d/adobetable "><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">rate</codeph> 値</entry><entry class="- topic/entry ">実際の周波数</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">44</entry><entry class="- topic/entry ">44,100 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">22</entry><entry class="- topic/entry ">22,050 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">11</entry><entry class="- topic/entry ">11,025 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">8</entry><entry class="- topic/entry ">8,000 Hz</entry></row><row class="- topic/row "><entry class="- topic/entry ">5</entry><entry class="- topic/entry ">5,512 Hz</entry></row></tbody></tgroup></adobetable> |
| |
| |
| |
| </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 "> |
| マイクを有効化したり、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 |
| </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 "> |
| マイクを有効化したり、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントを送出するために必要な音量です。デフォルト値は 10 です。 |
| |
| </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 "> |
| マイクがサウンド検知を停止してから activity イベントが送出されるまでの時間（ミリ秒単位）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.silenceTimeout, silenceTimeout |
| </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 "> |
| マイクがサウンド検知を停止してから、<codeph class="+ topic/ph pr-d/codeph ">activity</codeph> イベントが送出されるまでの時間（ミリ秒単位）です。デフォルト値は 2000（2 秒）です。 |
| |
| <p class="- topic/p ">この値を設定するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.setSilenceLevel()</codeph> メソッドを使用します。</p> |
| |
| |
| </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 "> |
| loopback モードになっているとき、この 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 "><internal>Document this better with examples. |
| </internal></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.media:SoundTransform</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| loopback モードになっているとき、この microphone オブジェクトのサウンドを制御します。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Microphone:useEchoSuppression:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">useEchoSuppression</apiName><shortdesc class="- topic/shortdesc "> |
| エコー抑制が有効になっている場合は true、それ以外の場合は false に設定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Microphone, audio, sound, Microphone.useEchoSuppression, useEchoSuppression |
| </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 "> |
| エコー抑制が有効になっている場合は <codeph class="+ topic/ph pr-d/codeph ">true</codeph>、それ以外の場合は <codeph class="+ topic/ph pr-d/codeph ">false</codeph> に設定します。Flash Player 設定パネルの「マイク」でユーザーが「エコーを減らす」を選択していない限り、デフォルト値は <codeph class="+ topic/ph pr-d/codeph ">false</codeph> です。 |
| |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/setUseEchoSuppression()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.setUseEchoSuppression()</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:StageVideo" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">StageVideo</apiName><shortdesc class="- topic/shortdesc "> |
| ライブビデオまたは録画されたビデオをアプリケーション内に表示するとき、StageVideo オブジェクトでは、デバイスのハードウェアアクセラレーション機能が使用可能な場合は使用されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ライブビデオまたは録画されたビデオをアプリケーション内に表示するとき、StageVideo オブジェクトでは、デバイスのハードウェアアクセラレーション機能が使用可能な場合は使用されます。ハードウェアアクセラレーション機能は大半のデバイスに搭載されています。StageVideo オブジェクトは Video オブジェクトと同じビデオ形式をサポートしています。これらの形式について詳しくは、flash.net.NetStream クラスを参照してください。 |
| |
| <p class="- topic/p ">AIR プロファイルのサポート：<i class="+ topic/ph hi-d/i "/>AIR 2.5 では、この機能はテレビ用 AIR を実行するデバイスでのみサポートされています。複数のプロファイル間での API サポートについて詳しくは、<xref href="http://help.adobe.com/en_US/air/build/WS144092a96ffef7cc16ddeea2126bb46b82f-8000.html" class="- topic/xref ">AIR プロファイルのサポート</xref>を参照してください。 |
| </p> |
| |
| <p class="- topic/p ">StageVideo オブジェクトによるビデオは、常に、どの Flash 表示リストオブジェクトよりも背面にある長方形の領域に表示されます。これにより StageVideo オブジェクトでは、ハードウェアアクセラレーションを利用しつつ、ビデオの最も一般的な表示方法（ビデオコントロールがオーバーレイ表示される長方形の表示領域）をサポートすることができます。</p> |
| |
| |
| <p class="- topic/p ">Video オブジェクトではなく StageVideo オブジェクトを使用することには次のようなメリットがあります。</p> |
| |
| <p class="- topic/p "><ul class="- topic/ul "><li class="- topic/li ">ハードウェアアクセラレーションを使用することでビデオ再生のパフォーマンスが最適化されます。</li><li class="- topic/li ">プロセッサーおよび電力の使用量が減少します。</li><li class="- topic/li ">ビデオコントロールなどを StageVideo オブジェクトの前面に表示できるので、より柔軟でクリエイティブなコンテンツ開発ができます。</li></ul></p> |
| |
| <p class="- topic/p ">StageVideo オブジェクトはデバイスハードウェアの機能を使用するので、StageVideo オブジェクトには、Video オブジェクトと比較して次の制限があります。</p> |
| |
| <p class="- topic/p "><ul class="- topic/ul "><li class="- topic/li ">ビデオ表示領域の形は長方形のみです。楕円形や不規則な形などの複雑な領域に表示することはできません。</li><li class="- topic/li ">StageVideo オブジェクトは回転できません。</li><li class="- topic/li ">StageVideo オブジェクトはビットマップキャッシュできません。</li><li class="- topic/li ">BitmapData を使用してビデオデータにアクセスすることはできません。</li><li class="- topic/li ">SWF ファイルにビデオを埋め込めません。StageVideo オブジェクトは NetStream オブジェクトと共に使用する場合のみ使用できます。</li><li class="- topic/li ">StageVideo オブジェクトにはフィルター、ブレンドモードまたはアルファ値を適用できません。</li><li class="- topic/li ">StageVideo オブジェクトにはカラー変換、3D 変形またはマトリックス変換を適用できません。</li><li class="- topic/li ">StageVideo オブジェクトにはマスクまたは scale9Grid を適用できません。</li><li class="- topic/li ">StageVideo オブジェクトの前面にある表示オブジェクトに適用したブレンドモードは、StageVideo オブジェクトに対しては適用されません。</li><li class="- topic/li ">StageVideo オブジェクトを配置できる位置は、フルピクセル境界のみです。</li><li class="- topic/li ">各 SWF ファイルについて、同時にビデオを表示できる StageVideo オブジェクトの数は、Flash Player により 4 に制限されています。ただし、デバイスのハードウェアリソースによっては、実際のオブジェクト数がより少ない数に制限される場合があります。テレビ用 AIR デバイスでは、一度に 1 つの StageVideo オブジェクトでのみビデオを再生できます。</li><li class="- topic/li ">ビデオのタイミングが、ランタイムにより表示される Flash コンテンツのタイミングと同期しません。</li><li class="- topic/li ">指定されたデバイスハードウェアにおいて、ビデオ表示は最も適した手段ではありますが、デバイス間で完全なピクセル整合性が保たれているわけではありません。ドライバーやハードウェアにより、些細な不整合が発生する場合があります。</li><li class="- topic/li ">デバイスの中には、必要なすべてのカラースペースをサポートしていないものもあります。たとえば、H.264 標準の BT.709 をサポートしていないデバイスもいくつかあります。このような場合には、表示速度を速めるため、BT.601 を使用することができます。</li><li class="- topic/li ">ステージビデオを <codeph class="+ topic/ph pr-d/codeph ">normal</codeph>、<codeph class="+ topic/ph pr-d/codeph ">opaque</codeph>、<codeph class="+ topic/ph pr-d/codeph ">transparent</codeph> などの WMODE 設定と共に使用することはできません。フルスクリーンモードにない場合、ステージビデオでサポートされているのは <codeph class="+ topic/ph pr-d/codeph ">WMODE=direct</codeph> のみです。WMODE は、Safari 4 またはそれ以降、IE 9 またはそれ以降、テレビ用 AIR では何の影響もありません。</li></ul></p> |
| |
| <p class="- topic/p ">StageVideo オブジェクトを使用してビデオを再生する手順の要約を次に示します。</p> |
| |
| <p class="- topic/p "><ol class="- topic/ol "><li class="- topic/li ">Stage.stageVideos ベクターが変更されたタイミングを知るために、StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY イベントをリッスンします（テレビ用 AIR 2.5 ではサポートされません）。 </li><li class="- topic/li ">StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY イベントによりステージビデオが使用可能であることがレポートされると、そのイベントハンドラー内の <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> ベクターオブジェクトを使用して StageVideo オブジェクトにアクセスします。テレビ用 AIR 2.5 では、最初の SWF フレームがレンダリングされた後、<codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> にアクセスします。<b class="+ topic/ph hi-d/b ">注意：</b>StageVideo オブジェクトを作成することはできません。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">StageVideo.attachNetStream()</codeph> を使用して NetStream オブジェクトを添付します。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> を使用してビデオを再生します。</li><li class="- topic/li ">ビデオ再生のステータスを知るために、StageVideo オブジェクト上の <codeph class="+ topic/ph pr-d/codeph ">StageVideoEvent.RENDER_STATE</codeph> イベントをリッスンします。また、このイベントの受領は、ビデオの width および height プロパティが初期化または変更されたことも示します。 </li><li class="- topic/li ">Video オブジェクト上の <codeph class="+ topic/ph pr-d/codeph ">VideoEvent.RENDER_STATE</codeph> イベントをリッスンします。このイベントは、StageVideoEvent.RENDER_STATE と同じステータスを提供します。したがって、このイベントを使用して GPU アクセラレーションが使用可能かどうかを判断することができます。また、このイベントの受領は、ビデオの width および height プロパティが初期化または変更されたことも示します（テレビ用 AIR 2.5 ではサポートされません）。</li></ol></p> |
| |
| |
| <p class="- topic/p ">ビデオを再生できないことが <codeph class="+ topic/ph pr-d/codeph ">StageVideoEvent.RENDER_STATE</codeph> イベントによって示された場合は、StageVideo オブジェクトではなく Video オブジェクトを使用する従来の方法に切り替えることもできます。このイベントは、ビデオが NetStream オブジェクトにアタッチされ、再生された後に送出されます。また、プラットフォームによっては、再生ステータスに何らかの変化が生じるたびにこのイベントが送出されることもあります。<codeph class="+ topic/ph pr-d/codeph ">StageVideoEvent.RENDER_STATE</codeph> イベントを使用して、アプリケーションのビデオが確実に再生されるよう、または再生されないようにします。 |
| </p> |
| |
| <p class="- topic/p ">ビデオの実行がステージビデオをサポートしていない WMODE からフルスクリーンモードに移行すると、ステージビデオが使用できるようになります。同様に、ユーザーがフルスクリーンモードを終了すると、ステージビデオは使用できなくなります。このような場合、Stage.stageVideos ベクターが変更されます。この変更の通知を取得するには、StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABITY イベントをリッスンします。<b class="+ topic/ph hi-d/b ">注意：</b>この通知は、テレビ用 AIR 2.5 では使用できません。</p> |
| </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.events.xml#StageVideoEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.StageVideoEvent</linktext></link><link href="flash.events.xml#StageVideoAvailabilityEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.StageVideoAvailabilityEvent</linktext></link><link href="flash.events.xml#VideoEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.VideoEvent</linktext></link><link href="flash.display.xml#Stage/stageVideos" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Stage.stageVideos</linktext></link><link href="flash.media.xml#Video" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Video</linktext></link><link href="flash.net.xml#NetStream" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream</linktext></link><link href="http://www.adobe.com/go/learn_as3_stageVideo_en" class="- topic/link "><linktext class="- topic/linktext ">StageVideo クラスを使用してハードウェアアクセラレーションによるレンダリングを実行する方法</linktext></link></related-links><adobeApiEvent id="flash.media:StageVideo_flash.events.StageVideoEvent.RENDER_STATE_renderState" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">renderState</apiName><shortdesc class="- topic/shortdesc "> |
| StageVideo オブジェクトのレンダリング状態が変化したときに、StageVideo オブジェクトによって送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><adobeApiEventDetail class="- topic/body reference/refbody apiRef/apiDetail adobeApiEvent/adobeApiEventDetail "><adobeApiEventDef class="- topic/section reference/section apiRef/apiDef adobeApiEvent/adobeApiEventDef "><apiEventType class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiEventType ">flash.events.StageVideoEvent.RENDER_STATE</apiEventType><adobeApiEventClassifier class="- topic/xref reference/xref apiRef/apiRelation adobeApiEvent/adobeApiEventClassifier ">flash.events.StageVideoEvent</adobeApiEventClassifier><apiGeneratedEvent class="- topic/state reference/state apiRef/apiQualifier adobeApiEvent/apiGeneratedEvent "/></adobeApiEventDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| StageVideo オブジェクトのレンダリング状態が変化したときに、StageVideo オブジェクトによって送出されます。 |
| |
| </apiDesc></adobeApiEventDetail></adobeApiEvent><apiOperation id="flash.media:StageVideo:attachNetStream" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attachNetStream</apiName><shortdesc class="- topic/shortdesc "> |
| アプリケーション内の StageVideo オブジェクトの境界内に表示するビデオストリームを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">netStream</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.net:NetStream</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">NetStream オブジェクトです。StageVideo オブジェクトへの接続を閉じるには、<codeph class="+ topic/ph pr-d/codeph ">null</codeph> を渡します。 |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| アプリケーション内の StageVideo オブジェクトの境界内に表示するビデオストリームを指定します。ビデオストリームは、NetStream.play() で再生されるビデオファイルか、または <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。ビデオファイルはローカルファイルシステムまたは Flash Media Server に保存できます。<codeph class="+ topic/ph pr-d/codeph ">netStream</codeph> 引数の値に <codeph class="+ topic/ph pr-d/codeph ">null</codeph> を指定すると、StageVideo オブジェクト内でビデオが再生されなくなります。 |
| |
| |
| <p class="- topic/p ">再度 <codeph class="+ topic/ph pr-d/codeph ">attachNetStream()</codeph> を呼び出す場合は、その前に、現在添付されている NetStream オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">close()</codeph> メソッドを呼び出してください。<codeph class="+ topic/ph pr-d/codeph ">close()</codeph> を呼び出すと、そのビデオの再生に関係するハードウェアデコーダーなどのリソースがすべて解放されます。これで、別の NetStream オブジェクトまたは <codeph class="+ topic/ph pr-d/codeph ">null</codeph> を指定して <codeph class="+ topic/ph pr-d/codeph ">attachNetStream()</codeph> を呼び出せるようになります。</p> |
| |
| <p class="- topic/p "> |
| ビデオファイルにオーディオしか含まれない場合、このメソッドを使用する必要はありません。ビデオファイルのオーディオ部分は、<codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> を呼び出すと自動的に再生されます。ビデオファイルに関連付けられたオーディオを制御するには、ビデオファイルを再生する NetStream オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">soundTransform</codeph> プロパティを使用します。 |
| </p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="flash.media:StageVideo:colorSpaces:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">colorSpaces</apiName><shortdesc class="- topic/shortdesc "> |
| そのビデオ画面に使用できるカラースペースの名前のリストを返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiType value="Vector$String" name="type" class="- topic/state reference/state apiRef/apiType "/></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| そのビデオ画面に使用できるカラースペースの名前のリストを返します。普通、このリストには「BT.601」と「BT.709」が含まれていますが、構成によっては「BT.601」のみサポートされていることがあります。その場合、ビデオが正しいカラースペースでレンダリングされない可能性があります。 |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>テレビ用 AIR デバイスでは、「BT.601」の値はソフトウェア再生を、「BT.709」の値はハードウェア再生を示します。 </p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideo:depth:set" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">depth</apiName><shortdesc class="- topic/shortdesc "> |
| その StageVideo オブジェクトが配置された深さレベルを、他の StageVideo オブジェクトとの相対値で示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">その StageVideo オブジェクトの深さを示す他の StageVideo オブジェクトとの相対値。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| その StageVideo オブジェクトが配置された深さレベルを、他の StageVideo オブジェクトとの相対値で示します。 |
| |
| <p class="- topic/p ">StageVideo オブジェクトは常にステージ上の他のオブジェクトの背面に表示されます。プラットフォームが複数の StageVideo オブジェクトをサポートしている場合、<codeph class="+ topic/ph pr-d/codeph ">depth</codeph> プロパティは StageVideo オブジェクトの深さレベルを表します。最背面にある StageVideo オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">depth</codeph> プロパティが最も小さい値になります。複数の StageVideo オブジェクトに同じ深さが設定されている場合、それらのオブジェクトの相対的な順序は、<codeph class="+ topic/ph pr-d/codeph ">stageVideos</codeph> Vector オブジェクト内に配置されている順序によって決まります。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>テレビ用 AIR デバイスでサポートされる StageVideo オブジェクトの数は 1 つだけです。したがって、このプロパティはテレビ用 AIR デバイスでは使用できません。他のデバイスでの将来のサポートに備えたプレースホルダーになっています。</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Stage/stageVideos" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Stage.stageVideos</linktext></link></related-links></apiValue><apiValue id="flash.media:StageVideo:pan:set" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">pan</apiName><shortdesc class="- topic/shortdesc "> |
| Point オブジェクトの座標として指定される、ビデオ表示のパン設定です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Point</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Point 値が無効です。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">ズームされたビデオのどの長方形が表示されているかを判別します。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Point オブジェクトの座標として指定される、ビデオ表示のパン設定です。 |
| |
| <p class="- topic/p ">デフォルトでは、<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> の値は <codeph class="+ topic/ph pr-d/codeph ">(0,0)</codeph> です。このデフォルトの状態では、<codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> で指定される長方形の中央にビデオが表示されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 値は、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> プロパティにデフォルトの <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> 以外の値が設定されている場合にのみ意味を持ちます。デフォルトの <codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> 値を使用して <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 長方形内にビデオを表示すると、ビデオのサイズは、その長方形にちょうど合うように調整されます。したがって、ビデオの画像全体が表示されます。ズーム値を指定するとビデオの画像全体は表示されません。その場合に <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 値を設定すると、どの部分を <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> の長方形領域に表示するかを指定できます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">pan</codeph> プロパティに設定できる有効な値の範囲は、<codeph class="+ topic/ph pr-d/codeph ">(-1.0, -1.0)</codeph> ～ <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> です。設定値には次のような意味があります。</p> |
| |
| <p class="- topic/p "><ul class="- topic/ul "><li class="- topic/li "> |
| <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">(-1.0, -1.0)</codeph> の場合は、ビデオの左上隅ピクセルが <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域の左上隅に表示されます。 |
| </li><li class="- topic/li "> |
| <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> の場合は、ビデオの右下隅ピクセルが <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域の右下隅に表示されます。 |
| </li><li class="- topic/li "> |
| <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">(1.0, -1.0)</codeph> の場合は、ビデオの右上隅ピクセルが <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域の右上隅に表示されます。 |
| </li><li class="- topic/li "> |
| <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">(-1.0, 1.0)</codeph> の場合は、ビデオの左下隅ピクセルが <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域の左下隅に表示されます。 |
| </li></ul> |
| </p> |
| |
| <p class="- topic/p ">-1.0 と 1.0 の間の値を指定すると、拡大率に応じて表示がパンされます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">pan</codeph> プロパティに有効範囲外の値を設定すると、<codeph class="+ topic/ph pr-d/codeph ">RangeError</codeph> 例外がスローされます。値はその前に設定されていた有効な値に戻されます。</p> |
| |
| <p class="- topic/p ">また、StageVideo オブジェクトの使用時には <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> Vector オブジェクトの要素を StageVideo 変数に代入して使用しているという点も考慮する必要があります。StageVideo 変数の <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> プロパティを設定すると、該当する <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> Vector オブジェクトの要素も変更されます。後で、別の StageVideo 変数に同じ要素を代入してビデオを再生する場合には、<codeph class="+ topic/ph pr-d/codeph ">pan</codeph> プロパティを設定し直す必要があります。</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#StageVideo/zoom" class="- topic/link "><linktext class="- topic/linktext ">zoom</linktext></link></related-links></apiValue><apiValue id="flash.media:StageVideo:videoHeight:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">videoHeight</apiName><shortdesc class="- topic/shortdesc "> |
| ビデオストリームの高さをピクセル単位で指定する整数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ビデオストリームの高さをピクセル単位で指定する整数です。 |
| |
| <p class="- topic/p ">このプロパティは、<codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> の長方形領域のサイズとは関係なく、キャプチャしたのと同じ高さでユーザーに対してビデオを表示する場合などに使用します。</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideo:videoWidth:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">videoWidth</apiName><shortdesc class="- topic/shortdesc "> |
| ビデオストリームの幅をピクセル単位で指定する整数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ビデオストリームの幅をピクセル単位で指定する整数です。 |
| |
| <p class="- topic/p ">このプロパティは、<codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> の長方形領域のサイズとは関係なく、キャプチャしたのと同じ幅でユーザーに対してビデオを表示する場合などに使用します。</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideo: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 "> |
| ビデオ表示領域の絶対位置とサイズ（ピクセル単位）です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Rectangle</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Rectangle 値が無効です。 |
| </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 "> |
| ビデオ表示領域の絶対位置とサイズ（ピクセル単位）です。 |
| |
| <p class="- topic/p ">ビデオの位置は、ステージの左上隅を基準とする相対位置です。</p> |
| |
| <p class="- topic/p "> |
| <codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> Rectangle オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">x</codeph> および <codeph class="+ topic/ph pr-d/codeph ">y</codeph> プロパティに設定できる値の有効範囲は -8192 ～ 8191 です。つまり、ビデオの一部または全体をステージの外に出すこともできます。また、<codeph class="+ topic/ph pr-d/codeph ">viewPort</codeph> プロパティの <codeph class="+ topic/ph pr-d/codeph ">width</codeph> および <codeph class="+ topic/ph pr-d/codeph ">height</codeph> プロパティをステージよりも大きくすれば、ビデオのサイズをステージよりも大きくすることができます。</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:StageVideo:zoom:set" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">zoom</apiName><shortdesc class="- topic/shortdesc "> |
| Point オブジェクトとして指定される、ビデオのズーム設定です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="AIR" version="2.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="10.2" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">flash.geom:Point</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Point 値が無効です。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">ビデオのズーム設定です。 |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Point オブジェクトとして指定される、ビデオのズーム設定です。 |
| |
| <p class="- topic/p ">ズームの Point オブジェクトが拡大倍率を表します。デフォルトでは、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> の値は <codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> です。このデフォルトの状態では、<codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 長方形領域にビデオの画像全体が表示されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> プロパティに設定できる有効な値の範囲は、<codeph class="+ topic/ph pr-d/codeph ">(1.0, 1.0)</codeph> ～ <codeph class="+ topic/ph pr-d/codeph ">(16.0, 16.0)</codeph> です。ズームの Point オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">x</codeph> プロパティによって水平方向ピクセルのズーム値を指定し、y プロパティによって垂直方向ピクセルのズーム値を指定します。</p> |
| |
| <p class="- topic/p ">例えば、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">(2.0, 2.0)</codeph> の場合は、水平ピクセルの半数と垂直ピクセルの半数だけが <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> の長方形領域内に表示されます。<codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域全体がビデオで占められますが、ビデオの半分だけが見える 2 倍ズーム表示になります。同じように、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">(16.0, 16.0)</codeph> の場合は、水平ピクセルの 1/16 と垂直ピクセルの 1/16 だけが <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> の長方形領域内に表示され、最大倍率である 16 倍ズーム表示になります。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> プロパティを設定する場合は、ビデオ内の適切な部分が <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域内に表示されるように <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> プロパティを設定してください。</p> |
| |
| <p class="- topic/p ">ここで、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> Point オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">x</codeph> および <codeph class="+ topic/ph pr-d/codeph ">y</codeph> プロパティに異なる値を設定することが有用な場合の例を挙げます。デフォルトの <codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> 値を使用して <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 長方形内にビデオを表示すると、ビデオのサイズは、その長方形にちょうど合うように調整されます。ビデオの長方形が <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> の長方形に合わせて拡大されないと、ビデオの表示がゆがむ場合があります。つまり、ビデオのアスペクト比が <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> と異なる場合には、ビデオの表示がゆがむ可能性があります。例えば、<codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> プロパティに正方形のサイズを指定して、幅と高さが異なるビデオを再生するような場合が該当します。こうした状況で表示のゆがみを解消するには、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> Point オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">x</codeph> および <codeph class="+ topic/ph pr-d/codeph ">y</codeph> プロパティに異なる値を設定します。さらに、ビデオ内の適切な部分が <codeph class="+ topic/ph pr-d/codeph ">StageVideo.viewPort</codeph> 領域内に表示されるように <codeph class="+ topic/ph pr-d/codeph ">pan</codeph> プロパティを設定します。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> プロパティに有効範囲外の値を設定すると、<codeph class="+ topic/ph pr-d/codeph ">RangeError</codeph> 例外がスローされます。値はその前に設定されていた有効な値に戻されます。</p> |
| |
| <p class="- topic/p ">また、StageVideo オブジェクトの使用時には <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> Vector オブジェクトの要素を StageVideo 変数に代入して使用しているという点も考慮する必要があります。StageVideo 変数の <codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> プロパティを設定すると、該当する <codeph class="+ topic/ph pr-d/codeph ">Stage.stageVideos</codeph> Vector オブジェクトの要素も変更されます。後で、別の StageVideo 変数に同じ要素を代入してビデオを再生する場合には、<codeph class="+ topic/ph pr-d/codeph ">zoom</codeph> プロパティを設定し直す必要があります。</p> |
| |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#StageVideo/pan" class="- topic/link "><linktext class="- topic/linktext ">pan</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:MicrophoneEnhancedOptions" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">MicrophoneEnhancedOptions</apiName><shortdesc class="- topic/shortdesc "> |
| MicrophoneEnhancedOptions クラスは、拡張オーディオの設定オプション（音声エコー除去機能）を提供します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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><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 "> |
| MicrophoneEnhancedOptions クラスは、拡張オーディオの設定オプション（音声エコー除去機能）を提供します。音声エコー除去機能を使用すると、ヘッドセットを使用しないで、複数のユーザーがオーディオ／ビデオチャットアプリケーションで通信できます。 |
| |
| <p class="- topic/p ">音声エコー除去機能を使用するには、<codeph class="+ topic/ph pr-d/codeph ">Microphone.getEnhancedMicrophone()</codeph> を呼び出して、拡張された Microphone オブジェクトへの参照を取得します。<codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> クラスのインスタンスに <codeph class="+ topic/ph pr-d/codeph ">Microphone.enhancedOptions</codeph> プロパティを設定します。 |
| </p> |
| |
| </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Microphone/enhancedOptions" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.enhancedOptions</linktext></link><link href="flash.media.xml#Microphone/getEnhancedMicrophone()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Microphone.getEnhancedMicrophone()</linktext></link></related-links><apiValue id="flash.media:MicrophoneEnhancedOptions:autoGain: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 ">autoGain</apiName><shortdesc class="- topic/shortdesc "> |
| 自動ゲイン制御を有効にします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 自動ゲイン制御を有効にします。時間領域の自動ゲイン制御アルゴリズムがノイズゲートと組み合わせて使用されます。デフォルト値はオフです。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedOptions:echoPath: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 ">echoPath</apiName><shortdesc class="- topic/shortdesc "> |
| 音声エコー除去機能に対して使用されるエコーパス（ミリ秒単位）を指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 音声エコー除去機能に対して使用されるエコーパス（ミリ秒単位）を指定します。エコーパスを長くするほど、エコー除去で良い結果が得られます。また、エコーパスは長くするほど遅延が大きくなり、複雑な計算処理が必要となります。デフォルト値は 128（推奨値）です。このほかに設定できる値は 256 です。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedOptions:isVoiceDetected: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 ">isVoiceDetected</apiName><shortdesc class="- topic/shortdesc "> |
| マイク入力で音声が検出されたかどうかを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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="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 "> |
| マイク入力で音声が検出されたかどうかを示します。 |
| |
| <p class="- topic/p "> 取りうる値は、<codeph class="+ topic/ph pr-d/codeph ">-1</codeph>（無効）、<codeph class="+ topic/ph pr-d/codeph ">0</codeph>（音声を未検出）、<codeph class="+ topic/ph pr-d/codeph ">1</codeph>（音声を検出）です。 |
| </p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedOptions:mode: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 ">mode</apiName><shortdesc class="- topic/shortdesc "> |
| 拡張マイクモードを制御します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 拡張マイクモードを制御します。USB 以外のすべてのマイクのデフォルト値は、<codeph class="+ topic/ph pr-d/codeph ">FULL_DUPLEX</codeph> です。USB マイクのデフォルト値は、<codeph class="+ topic/ph pr-d/codeph ">HALF_DUPLEX</codeph> です。設定できる値とその説明については、<codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedMode</codeph> を参照してください。 |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#MicrophoneEnhancedMode" class="- topic/link "><linktext class="- topic/linktext ">flash.media.MicrophoneEnhancedMode</linktext></link></related-links></apiValue><apiValue id="flash.media:MicrophoneEnhancedOptions:nonLinearProcessing: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 ">nonLinearProcessing</apiName><shortdesc class="- topic/shortdesc "> |
| ノンリニア処理を有効にします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ノンリニア処理を有効にします。ノンリニア処理は、1 人の話者が話す状況で残余エコーを低減します。時間領域のノンリニア処理テクニックが使用されます。音楽ソースの場合、ノンリニア処理を無効にします。デフォルト値は <codeph class="+ topic/ph pr-d/codeph ">true</codeph> で、ノンリニア処理は有効になります。 |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:Sound" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">Sound</apiName><shortdesc class="- topic/shortdesc "> |
| Sound クラスを使用すると、アプリケーション内のサウンドを処理することができます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.events:EventDispatcher</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sound クラスを使用すると、アプリケーション内のサウンドを処理することができます。Sound クラスを使用すると、Sound オブジェクトの作成や、外部 MP3 ファイルのオブジェクトへのロードと再生ができます。また、サウンドストリームを閉じたり、サウンド関連のデータ（ストリームおよび ID3 メタデータのバイト数などの情報）にアクセスしたりできます。サウンドのサウンドソース（SoundChannel オブジェクトまたは Microphone オブジェクト）と、コンピューターのスピーカーへのサウンド出力を制御する SoundTransform クラスのプロパティを使用して、サウンドを詳細に制御できます。 |
| |
| <p class="- topic/p ">Flash Player 10 以降と AIR 1.5以降では、このクラスを使用して、動的に生成されたサウンドを処理することもできます。この場合、サウンドデータのポーリングには、<codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントハンドラーに割り当てられた関数が使用されます。サウンドは、サウンドデータに設定された ByteArray オブジェクトから取得され、再生されます。<codeph class="+ topic/ph pr-d/codeph ">Sound.extract()</codeph> を使用すると、Sound オブジェクトからサウンドデータを抽出できます。抽出したサウンドデータは、ストリームに書き戻して再生する前に処理できます。</p> |
| |
| <p class="- topic/p ">SWF ファイルに埋め込まれたサウンドを制御するには、SoundMixer クラスのプロパティを使用します。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>ActionScript 3.0 の Sound API は、ActionScript 2.0 とは異なります。ActionScript 3.0 では、取得して階層内に配置した Sound オブジェクトのプロパティを制御することができません。</p> |
| |
| <p class="- topic/p ">このクラスを使用するときは、次のセキュリティモデルを考慮してください。 </p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">呼び出し元ファイルがネットワークサンドボックスにあり、ロードするサウンドファイルがローカルにある場合、サウンドのロードおよび再生はできません。</li><li class="- topic/li ">呼び出し元 ファイルがローカルにあり、リモートサウンドのロードおよび再生を試行する場合、デフォルトでは、サウンドのロードや再生ができません。この種のアクセスを許可するには、ユーザーが明示的な許可を与える必要があります。</li><li class="- topic/li ">サウンドを処理する特定の操作が制限されます。ロードされたサウンドのデータには、クロスドメインポリシーファイルを実装していない限り、別のドメインに存在するファイルからアクセスできないことに注意してください。この制限の対象となるサウンド関連の API は、<codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph>、<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.computeSpectrum()</codeph>、<codeph class="+ topic/ph pr-d/codeph ">SoundMixer.bufferTime</codeph>、および <codeph class="+ topic/ph pr-d/codeph ">SoundTransform</codeph> クラスです。</li></ul> |
| |
| <p class="- topic/p ">ただし、Adobe AIR では、<codeph class="+ topic/ph pr-d/codeph ">アプリケーション</codeph>セキュリティサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。</p> |
| |
| <p class="- topic/p ">セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：<xref href="http://www.adobe.com/go/devnet_security_jp" scope="external" class="- topic/xref ">セキュリティ</xref>を参照してください。</p> |
| |
| </apiDesc><example conref="examples\SoundExample.as" class="- topic/example "> 次の例では、MP3 ファイルを開い再生すると発生するサウンドイベントに関する情報が表示されます。この例を実行するには、MySound.mp3 ファイルを SWF ファイルと同じディレクトリに配置します。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.events.*; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.net.URLRequest; |
| |
| public class SoundExample extends Sprite { |
| private var url:String = "MySound.mp3"; |
| private var song:SoundChannel; |
| |
| public function SoundExample() { |
| var request:URLRequest = new URLRequest(url); |
| var soundFactory:Sound = new Sound(); |
| soundFactory.addEventListener(Event.COMPLETE, completeHandler); |
| soundFactory.addEventListener(Event.ID3, id3Handler); |
| soundFactory.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); |
| soundFactory.addEventListener(ProgressEvent.PROGRESS, progressHandler); |
| soundFactory.load(request); |
| song = soundFactory.play(); |
| } |
| |
| private function completeHandler(event:Event):void { |
| trace("completeHandler: " + event); |
| } |
| |
| private function id3Handler(event:Event):void { |
| trace("id3Handler: " + event); |
| } |
| |
| private function ioErrorHandler(event:Event):void { |
| trace("ioErrorHandler: " + event); |
| } |
| |
| private function progressHandler(event:ProgressEvent):void { |
| trace("progressHandler: " + event); |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.net.xml#NetStream" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream</linktext></link><link href="flash.media.xml#Microphone" class="- topic/link "><linktext class="- topic/linktext ">Microphone</linktext></link><link href="flash.media.xml#SoundChannel" class="- topic/link "><linktext class="- topic/linktext ">SoundChannel</linktext></link><link href="flash.media.xml#SoundMixer" class="- topic/link "><linktext class="- topic/linktext ">SoundMixer</linktext></link><link href="flash.media.xml#SoundTransform" class="- topic/link "><linktext class="- topic/linktext ">SoundTransform</linktext></link></related-links><adobeApiEvent id="flash.media:Sound_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 "> |
| ロード処理の実行中にデータを受信したときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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.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 "> |
| ロード処理の実行中にデータを受信したときに送出されます。 |
| </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/load()" class="- topic/link "><linktext class="- topic/linktext ">load()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Sound_flash.events.Event.OPEN_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 adobeApiEvent/adobeApiEvent "><apiName class="- topic/title reference/title apiRef/apiName ">open</apiName><shortdesc class="- topic/shortdesc "> |
| ロード操作が開始したときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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.OPEN</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 "> |
| ロード操作が開始したときに送出されます。 |
| </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/load()" class="- topic/link "><linktext class="- topic/linktext ">load()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Sound_flash.events.IOErrorEvent.IO_ERROR_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 "> |
| 入出力エラーが発生してロード操作が失敗したときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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.IOErrorEvent.IO_ERROR</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 "> |
| 入出力エラーが発生してロード操作が失敗したときに送出されます。 |
| </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/load()" class="- topic/link "><linktext class="- topic/linktext ">load()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Sound_flash.events.Event.ID3_id3" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">id3</apiName><shortdesc class="- topic/shortdesc "> |
| MP3 サウンドで ID3 データを使用できる場合に、Sound オブジェクトによって送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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.ID3</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 "> |
| MP3 サウンドで ID3 データを使用できる場合に、Sound オブジェクトによって送出されます。 |
| </apiDesc></adobeApiEventDetail><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></adobeApiEvent><adobeApiEvent id="flash.media:Sound_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 "> |
| データが正常にロードされたときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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.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 "> |
| データが正常にロードされたときに送出されます。 |
| </apiDesc></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/load()" class="- topic/link "><linktext class="- topic/linktext ">load()</linktext></link></related-links></adobeApiEvent><adobeApiEvent id="flash.media:Sound_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 "> |
| ランタイムが新しいオーディオデータを要求するときに送出されます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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><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 "> |
| ランタイムが新しいオーディオデータを要求するときに送出されます。 |
| |
| </apiDesc><example conref="examples\Sound_SampleDataExample.as" class="- topic/example "> 次の例は、単純な正弦波を再生します。 |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var mySound:Sound = new Sound(); |
| function sineWaveGenerator(event:SampleDataEvent):void { |
| for ( var c:int=0; c<8192; c++ ) { |
| event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25); |
| event.data.writeFloat(Math.sin((Number(c+event.position)/Math.PI/2))*0.25); |
| } |
| } |
| |
| mySound.addEventListener(SampleDataEvent.SAMPLE_DATA,sineWaveGenerator); |
| mySound.play(); |
| </codeblock></example></adobeApiEventDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/extract()" class="- topic/link "><linktext class="- topic/linktext ">extract()</linktext></link><link href="flash.media.xml#Sound/play()" class="- topic/link "><linktext class="- topic/linktext ">play()</linktext></link><link href="flash.events.xml#SampleDataEvent" class="- topic/link "><linktext class="- topic/linktext ">flash.events.SampleDataEvent</linktext></link></related-links></adobeApiEvent><apiConstructor id="flash.media:Sound:Sound" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">Sound</apiName><shortdesc class="- topic/shortdesc "> |
| 新しい Sound オブジェクトを作成します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 ">stream</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.net:URLRequest</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 外部の MP3 ファイルを指定する URL です。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">context</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:SoundLoaderContext</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc "> オプションの SoundLoader コンテクストオブジェクト。バッファー時間（Sound オブジェクトのバッファー内に保持する MP3 データの最小ミリ秒数）を定義でき、サウンドをロードする前にクロスドメインポリシーファイルをチェックするかどうかを指定できます。 |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 新しい Sound オブジェクトを作成します。Sound コンストラクターに有効な URLRequest オブジェクトを渡すと、コンストラクターは自動的に Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 関数を呼び出します。Sound コンストラクターに有効な URLRequest オブジェクトを渡さない場合は、ユーザー自身が Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> 関数を呼び出す必要があります。呼び出さないと、ストリームがロードされません。 |
| |
| <p class="- topic/p ">Sound オブジェクトで <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> が呼び出された後は、その Sound オブジェクトに別のサウンドファイルをロードすることはできません。別のサウンドファイルをロードするには、新しい Sound オブジェクトを作成します。</p> |
| |
| Flash Player 10 以降と AIR 1.5 以降では、<codeph class="+ topic/ph pr-d/codeph ">load()</codeph> の代わりに <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントハンドラーを使用して、サウンドを Sound オブジェクトに動的にロードできます。 |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="flash.media:Sound: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 "> |
| ストリームを閉じて、データのダウンロードを中止します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ストリームを閉じることができないか、またはストリームが開いていません。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</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></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| ストリームを閉じて、データのダウンロードを中止します。<codeph class="+ topic/ph pr-d/codeph ">close()</codeph> メソッドの呼び出し後は、ストリームからデータを読み込みません。 |
| |
| </apiDesc><example conref="examples\Sound_closeExample.as" class="- topic/example "> 次の例では、ユーザーが「停止」ボタンをクリックしたときに、<codeph class="+ topic/ph pr-d/codeph ">Sound.close()</codeph> メソッドが呼び出され、サウンドがストリーミングを停止します。 |
| |
| <p class="- topic/p ">コンストラクターで、「開始」ボタンおよび「停止」ボタン用のテキストフィールドが作成されます。ユーザーがテキストフィールドをクリックすると、<codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドが呼び出されます。このメソッドは、サウンドファイルの開始と停止を処理します。ネットワーク接続によって、またはユーザーが「停止」ボタンを押したときにファイルの多くがロードされてしまっているため、サウンドファイルの再生を停止するのにしばらく時間がかかる場合があります。ストリームを閉じている間に発生する可能性のある IO エラーをキャッチするために、<codeph class="+ topic/ph pr-d/codeph ">try...catch</codeph> ブロックが使用されます。例えば、サウンドがローカルディレクトリからロードされ、ストリームされない場合、エラー 2029 がキャッチされ、"この URLStream オブジェクトには開いているストリームがありません" というメッセージが表示されます。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.URLRequest; |
| import flash.media.Sound; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.MouseEvent; |
| import flash.errors.IOError; |
| import flash.events.IOErrorEvent; |
| |
| public class Sound_closeExample extends Sprite { |
| private var snd:Sound = new Sound(); |
| private var button:TextField = new TextField(); |
| private var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"); |
| |
| public function Sound_closeExample() { |
| button.x = 10; |
| button.y = 10; |
| button.text = "START"; |
| button.border = true; |
| button.background = true; |
| button.selectable = false; |
| button.autoSize = TextFieldAutoSize.LEFT; |
| |
| button.addEventListener(MouseEvent.CLICK, clickHandler); |
| |
| this.addChild(button); |
| } |
| |
| private function clickHandler(e:MouseEvent):void { |
| |
| if(button.text == "START") { |
| |
| snd.load(req); |
| snd.play(); |
| |
| snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); |
| |
| button.text = "STOP"; |
| } |
| else if(button.text == "STOP") { |
| |
| try { |
| snd.close(); |
| button.text = "Wait for loaded stream to finish."; |
| } |
| catch (error:IOError) { |
| button.text = "Couldn't close stream " + error.message; |
| } |
| } |
| } |
| |
| private function errorHandler(event:IOErrorEvent):void { |
| button.text = "Couldn't load the file " + event.text; |
| } |
| } |
| } |
| |
| |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.media:Sound:extract" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">extract</apiName><shortdesc class="- topic/shortdesc "> |
| Sound オブジェクトから生のサウンドデータを抽出します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><refpath> |
| |
| </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 "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">target</codeph> パラメーターに指定されている ByteArray に書き込まれるサンプルの数です。 |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">target</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.utils:ByteArray</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">抽出されるサウンドサンプリングの配置先の ByteArray オブジェクトです。 |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">length</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">抽出するサウンドサンプリングの数です。サンプルには、2 つの 32 ビット浮動小数点数を意味する左チャンネルと右チャンネルがあります。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startPosition</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 ">抽出を開始するサンプルです。値を指定しない場合、<codeph class="+ topic/ph pr-d/codeph ">Sound.extract()</codeph> の最初の呼び出しはサウンドの先頭から開始され、<codeph class="+ topic/ph pr-d/codeph ">startPosition</codeph> の値が設定されていない後続の呼び出しでは、ファイル全体が順に処理されます。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sound オブジェクトから生のサウンドデータを抽出します。 |
| |
| <p class="- topic/p ">このメソッドは、動的に生成されたオーディオを処理する場合に、別の Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントに割り当てられた関数を使って使用するように設計されています。つまり、このメソッドを使用して Sound オブジェクトからサウンドデータを抽出できます。次に、別の Sound オブジェクトによってダイナミックオーディオのストリーミングに使用されているバイト配列に、そのデータを書き込むことができます。</p> |
| |
| <p class="- topic/p ">オーディオデータは、対象のバイト配列に、現在の位置から配置されます。オーディオデータは、通常、44,100 Hz ステレオで公開されます。サンプルの型は 32 ビット浮動小数値で、<codeph class="+ topic/ph pr-d/codeph ">ByteArray.readFloat()</codeph> を使用して Number に変換できます。 </p> |
| |
| </apiDesc><example conref="examples\Sound_extractExample.as" class="- topic/example "> 次の例では、mp3 ファイルをロードし、Sound クラスの <codeph class="+ topic/ph pr-d/codeph ">extract()</codeph> メソッドを使用してオーディオデータにアクセスします。 |
| <p class="- topic/p ">mp3 データは <codeph class="+ topic/ph pr-d/codeph ">sourceSnd</codeph> Sound オブジェクト内にロードされます。アプリケーションが mp3 データをロードすると、<codeph class="+ topic/ph pr-d/codeph ">loaded()</codeph> 関数が呼び出されます。この関数は、<codeph class="+ topic/ph pr-d/codeph ">sourceSnd</codeph> オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">complete</codeph> イベントのイベントハンドラーです。2 番目の Sound オブジェクト <codeph class="+ topic/ph pr-d/codeph ">outputSound</codeph> を使用して、変更されたオーディオが再生されます。<codeph class="+ topic/ph pr-d/codeph ">outputSound</codeph> オブジェクトには <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントリスナーがあり、オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">play()</codeph> メソッドを呼び出すと、この <codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントが定期的に送出されます。<codeph class="+ topic/ph pr-d/codeph ">upOctave()</codeph> メソッドは、ソースのオーディオデータに基づいて、変更されたオーディオデータのバイト配列を返します。ソースデータのオーディオサンプルを 1 つおきにスキップすることにより、1 オクターブ高いオーディオが返されます。<codeph class="+ topic/ph pr-d/codeph ">sampleData</codeph> イベントのイベントハンドラーによって、返されたバイト配列が <codeph class="+ topic/ph pr-d/codeph ">outoputSound</codeph> オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">data</codeph> プロパティに書き込まれます。<codeph class="+ topic/ph pr-d/codeph ">data</codeph> バイト配列は <codeph class="+ topic/ph pr-d/codeph ">outputSound</codeph> オブジェクトの出力オーディオデータに追加されます。</p> |
| <p class="- topic/p ">この例をテストするには、test.mp3 ファイルを SWF ファイルと同じディレクトリに追加してください。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var sourceSnd:Sound = new Sound(); |
| var outputSnd:Sound = new Sound(); |
| var urlReq:URLRequest = new URLRequest("test.mp3"); |
| |
| sourceSnd.load(urlReq); |
| sourceSnd.addEventListener(Event.COMPLETE, loaded); |
| |
| function loaded(event:Event):void |
| { |
| outputSnd.addEventListener(SampleDataEvent.SAMPLE_DATA, processSound); |
| outputSnd.play(); |
| } |
| |
| function processSound(event:SampleDataEvent):void |
| { |
| var bytes:ByteArray = new ByteArray(); |
| sourceSnd.extract(bytes, 4096); |
| event.data.writeBytes(upOctave(bytes)); |
| } |
| |
| function upOctave(bytes:ByteArray):ByteArray |
| { |
| var returnBytes:ByteArray = new ByteArray(); |
| bytes.position = 0; |
| while(bytes.bytesAvailable > 0) |
| { |
| returnBytes.writeFloat(bytes.readFloat()); |
| returnBytes.writeFloat(bytes.readFloat()); |
| if (bytes.bytesAvailable > 0) |
| { |
| bytes.position += 8; |
| } |
| } |
| return returnBytes; |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/play()" class="- topic/link "><linktext class="- topic/linktext ">play()</linktext></link><link href="flash.media.xml#Sound/event:sampleData" class="- topic/link "><linktext class="- topic/linktext ">sampleData</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Sound:load" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">load</apiName><shortdesc class="- topic/shortdesc "> |
| 指定した URL から外部 MP3 ファイルのロードを開始します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">このロードの失敗原因であるネットワークエラーです。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">信頼されていないローカルファイルはインターネットへの接続を許可されません。この問題は、このファイルを <ph class="- topic/ph ">local-with-networking</ph> または trusted として分類し直すことで回避できます。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">SecurityError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">SecurityError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">一般的な予約ポートには接続できません。遮断されたポートの詳しいリストについては、『ActionScript 3.0 開発ガイド<i class="+ topic/ph hi-d/i "/>』の「ネットワーク API の制限」を参照してください。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">SecurityError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">SecurityError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">stream</codeph> オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">digest</codeph> プロパティが <codeph class="+ topic/ph pr-d/codeph ">null</codeph> ではありません。URLRequest オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">digest</codeph> プロパティを設定できるのは、<codeph class="+ topic/ph pr-d/codeph ">URLLoader.load()</codeph> メソッドを呼び出して SWZ ファイル（Adobe プラットフォームコンポーネント）を読み込む場合のみです。 |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">IOError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.errors:IOError</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 ">stream</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.net:URLRequest</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc "> 外部の MP3 ファイルを指定する URL です。 |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">context</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:SoundLoaderContext</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc "> オプションの SoundLoader コンテクストオブジェクト。バッファー時間（Sound オブジェクトのバッファー内に保持する MP3 データの最小ミリ秒数）を定義でき、サウンドをロードする前にクロスドメインポリシーファイルをチェックするかどうかを指定できます。 |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 指定した URL から外部 MP3 ファイルのロードを開始します。Sound コンストラクターに有効な URLRequest オブジェクトを渡すと、コンストラクターは <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> を呼び出します。ユーザー自身で <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> を呼び出す必要があるのは、Sound コンストラクターに有効な URLRequest オブジェクトを渡さない場合、または <codeph class="+ topic/ph pr-d/codeph ">null</codeph> 値を渡す場合のみです。 |
| |
| <p class="- topic/p ">Sound オブジェクトで <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> が呼び出された後は、その Sound オブジェクトに別のサウンドファイルをロードすることはできません。別のサウンドファイルをロードするには、新しい Sound オブジェクトを作成します。</p> |
| |
| <p class="- topic/p ">このメソッドを使用するときは、次のセキュリティモデルを考慮してください。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">呼び出し元ファイルが local-with-file-system サンドボックスにあり、サウンドがネットワークサンドボックスにある場合、<codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> を呼び出すことはできません。</li><li class="- topic/li ">信頼できるローカルのサンドボックスまたはネットワーク接続したローカルのサンドボックスからアクセスするには、URL ポリシーファイルを使用して Web サイトで許可する必要があります。</li><li class="- topic/li ">一般的な予約ポートには接続できません。遮断されたポートの詳しいリストについては、『ActionScript 3.0 開発ガイド<i class="+ topic/ph hi-d/i "/>』の「ネットワーク API の制限」を参照してください。</li><li class="- topic/li ">SWF ファイルがこのメソッドを使用しないようにするには、<codeph class="+ topic/ph pr-d/codeph ">allowNetworking</codeph> パラメーター（SWF コンテンツを含んでいる HTML ページの <codeph class="+ topic/ph pr-d/codeph ">object</codeph> タグおよび <codeph class="+ topic/ph pr-d/codeph ">embed</codeph> タグのパラメーター）を設定します。</li></ul> |
| |
| <p class="- topic/p "> Flash Player 10 以降では、"multipart/form-data" などのマルチパート Content-Type にアップロードが含まれていると（アップロードが含まれているかどうかは POST ボディ内の "content-disposition" ヘッダーの "filename" パラメーターで示されます）、そのアップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。</p> |
| <ul class="- topic/ul "><li class="- topic/li ">POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。</li><li class="- topic/li ">POST 処理がクロスドメインである（POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない）場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。</li></ul> |
| <p class="- topic/p ">また、すべてのマルチパート Content-Type では、RFC2046 標準に準拠した有効なシンタックスを使用する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。</p> |
| <p class="- topic/p ">Adobe AIR では、<codeph class="+ topic/ph pr-d/codeph ">application</codeph> セキュリティサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。</p> |
| |
| <p class="- topic/p ">セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：<xref href="http://www.adobe.com/go/devnet_security_jp" scope="external" class="- topic/xref ">セキュリティ</xref>を参照してください。</p> |
| |
| </apiDesc><example conref="examples\Sound_loadExample.as" class="- topic/example "> 次の例では、サウンドファイルのロードの進行状況を表示します。 |
| |
| <p class="- topic/p ">コンストラクターで、アドビ システムズ社のポッドキャストであるサウンドファイルの位置を識別する <codeph class="+ topic/ph pr-d/codeph ">URLRequest</codeph> オブジェクトが作成されます。ファイルのロード中に発生する可能性のあるエラーをキャッチするために、ファイルが <codeph class="+ topic/ph pr-d/codeph ">try...catch</codeph> ブロックにロードされます。IO エラーが発生すると、<codeph class="+ topic/ph pr-d/codeph ">errorHandler()</codeph> メソッドも呼び出され、進行状況をレポートするテキストフィールドにエラーメッセージが書き出されます。ロード操作が進行している間に、<codeph class="+ topic/ph pr-d/codeph ">ProgressEvent.PROGRESS</codeph> イベントが送出され、<codeph class="+ topic/ph pr-d/codeph ">progressHandler()</codeph> メソッドが呼び出されます。ここでは、<codeph class="+ topic/ph pr-d/codeph ">ProgressEvent.PROGRESS</codeph> イベントがロードの進行状況を計算するタイマとして使用されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">progressHandler()</codeph> メソッドによって、<codeph class="+ topic/ph pr-d/codeph ">ProgressEvent</codeph> オブジェクトで渡される <codeph class="+ topic/ph pr-d/codeph ">bytesLoaded</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">bytesTotal</codeph> 値で除算され、ロードされるサウンドデータの割合（パーセント）が算出されます。次に、これらの値がテキストフィールドに表示されます。ファイルが小さいか、キャッシュされているか、ローカルディレクトリにある場合、進行状況が目立たない場合があります。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.URLRequest; |
| import flash.media.Sound; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.ProgressEvent; |
| import flash.events.IOErrorEvent; |
| |
| public class Sound_loadExample extends Sprite { |
| private var snd:Sound = new Sound(); |
| private var statusTextField:TextField = new TextField(); |
| |
| public function Sound_loadExample(){ |
| |
| statusTextField.autoSize = TextFieldAutoSize.LEFT; |
| var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"); |
| |
| try { |
| snd.load(req); |
| |
| snd.play(); |
| } |
| catch (err:Error) { |
| trace(err.message); |
| } |
| |
| snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); |
| snd.addEventListener(ProgressEvent.PROGRESS, progressHandler); |
| |
| this.addChild(statusTextField); |
| } |
| |
| private function progressHandler(event:ProgressEvent):void { |
| var loadTime:Number = event.bytesLoaded / event.bytesTotal; |
| var LoadPercent:uint = Math.round(100 * loadTime); |
| |
| statusTextField.text = "Sound file's size in bytes: " + event.bytesTotal + "\n" |
| + "Bytes being loaded: " + event.bytesLoaded + "\n" |
| + "Percentage of sound file that is loaded " + LoadPercent + "%.\n"; |
| } |
| |
| private function errorHandler(errorEvent:IOErrorEvent):void { |
| statusTextField.text = "The sound could not be loaded: " + errorEvent.text; |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="flash.media:Sound:play" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">play</apiName><shortdesc class="- topic/shortdesc "> |
| サウンドを再生する SoundChannel オブジェクトを新しく作成します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath> |
| |
| </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 "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">サウンドの制御に使用する SoundChannel オブジェクトです。このメソッドは、サウンドカードがない場合、または使用できるサウンドチャンネルが不足した場合は <codeph class="+ topic/ph pr-d/codeph ">null</codeph> を返します。一度に使用できるサウンドチャンネルの最大数は 32 チャネルです。 |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:SoundChannel</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startTime</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 ">再生を開始する初期位置（ミリ秒単位）です。 |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">loops</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">サウンドチャネルの再生が停止するまで <codeph class="+ topic/ph pr-d/codeph ">startTime</codeph> 値に戻ってサウンドの再生を繰り返す回数を定義します。 |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">sndTransform</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:SoundTransform</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">サウンドチャンネルに割り当てられた初期 SoundTransform オブジェクトです。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| サウンドを再生する SoundChannel オブジェクトを新しく作成します。このメソッドは SoundChannel オブジェクトを返します。このオブジェクトにアクセスして、サウンドの停止、およびボリュームの監視を行います。ボリュームの制御、パン、バランスの設定を行うには、サウンドチャンネルに割り当てられた SoundTransform オブジェクトにアクセスします。 |
| |
| </apiDesc><example conref="examples\Sound_playExample1.as" class="- topic/example "> 次の例では、ファイルがロードされると、グラフィックバーを使用するユーザーは、サウンドファイルの開始位置（開始時点）を選択できます。 |
| |
| <p class="- topic/p ">コンストラクターが <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> メソッドを呼び出して、サウンドデータのロードを開始します。次に、<codeph class="+ topic/ph pr-d/codeph ">Sound.play()</codeph> メソッドを呼び出して、十分なデータがロードされ次第、サウンドの再生を開始します。<codeph class="+ topic/ph pr-d/codeph ">Sound.play()</codeph> メソッドによって、サウンドの再生を制御するために使用される SoundChannel オブジェクトが返されます。テキストフィールドにはユーザーに対する説明が表示されます。ユーザーが再生を開始しようとしているサウンドの内容が確実にロードされているようにするため、ファイルのロードが完了してから <codeph class="+ topic/ph pr-d/codeph ">bar</codeph> Sprite オブジェクトが作成され、表示されます。ファイルが正常にロードされると、<codeph class="+ topic/ph pr-d/codeph ">Event.COMPLETE</codeph> イベントが送出され、そのイベントによって <codeph class="+ topic/ph pr-d/codeph ">completeHandler()</codeph> メソッドがトリガーされます。次に、<codeph class="+ topic/ph pr-d/codeph ">completeHandler()</codeph> メソッドによってバーが作成され、表示リストに追加されます。インタラクティブ機能をサポートするために、Shape オブジェクトの代わりに Sprite オブジェクトが使用されます。ユーザーがバーをクリックすると、<codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドがトリガーされます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドで、ユーザーがクリックした x 座標の位置 <codeph class="+ topic/ph pr-d/codeph ">event.localX</codeph> を使用して、ユーザーがファイルの開始を指定した場所が特定されます。バーは 100 ピクセルであり、x 座標の 100 ピクセルの位置から開始するので、位置の割合（パーセント）は簡単に特定されます。また、ファイルがロードされるため、サウンドファイルの <codeph class="+ topic/ph pr-d/codeph ">length</codeph> プロパティに、完全なファイルの長さ（ミリ秒単位）が設定されます。サウンドファイルの長さと行内の位置を使用して、サウンドファイルの開始位置が特定されます。サウンドの再生を停止した後は、<codeph class="+ topic/ph pr-d/codeph ">startTime</codeph> パラメーターとして <codeph class="+ topic/ph pr-d/codeph ">play()</codeph> メソッドに渡される選択した開始位置からサウンドファイルの再生が再開されます。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.display.Graphics; |
| import flash.events.MouseEvent; |
| import flash.media.Sound;; |
| import flash.net.URLRequest; |
| import flash.media.SoundChannel; |
| import flash.events.ProgressEvent; |
| import flash.events.Event; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.IOErrorEvent; |
| |
| public class Sound_playExample1 extends Sprite { |
| private var snd:Sound = new Sound(); |
| private var channel:SoundChannel = new SoundChannel(); |
| private var infoTextField:TextField = new TextField(); |
| |
| public function Sound_playExample1() { |
| |
| var req:URLRequest = new URLRequest("MySound.mp3"); |
| |
| infoTextField.autoSize = TextFieldAutoSize.LEFT; |
| infoTextField.text = "Please wait for the file to be loaded.\n" |
| + "Then select from the bar to decide where the file should start."; |
| |
| snd.load(req); |
| channel = snd.play(); |
| |
| snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); |
| snd.addEventListener(Event.COMPLETE, completeHandler); |
| |
| |
| this.addChild(infoTextField); |
| } |
| |
| private function completeHandler(event:Event):void { |
| infoTextField.text = "File is ready."; |
| |
| var bar:Sprite = new Sprite(); |
| |
| bar.graphics.lineStyle(5, 0xFF0000); |
| bar.graphics.moveTo(100, 100); |
| bar.graphics.lineTo(200, 100); |
| |
| bar.addEventListener(MouseEvent.CLICK, clickHandler); |
| |
| this.addChild(bar); |
| } |
| |
| private function clickHandler(event:MouseEvent):void { |
| |
| var position:uint = event.localX; |
| var percent:uint = Math.round(position) - 100; |
| var cue:uint = (percent / 100) * snd.length; |
| |
| channel.stop(); |
| channel = snd.play(cue); |
| } |
| |
| private function errorHandler(errorEvent:IOErrorEvent):void { |
| infoTextField.text = "The sound could not be loaded: " + errorEvent.text; |
| } |
| } |
| } |
| </codeblock></example><example conref="examples\Sound_playExample2.as" class="- topic/example "> 次の例では、ユーザーがボタンをシングルクリックするか、ダブルクリックするかに応じて、サウンドを 1 回または 2 回再生します。 |
| |
| <p class="- topic/p ">コンストラクターで、サウンドがロードされ、単純な矩形の <codeph class="+ topic/ph pr-d/codeph ">button</codeph> Sprite オブジェクトが作成されます。インタラクティブ機能をサポートするために、Shape オブジェクトの代わりに Sprite オブジェクトが使用されます。ここでは、サウンドファイルが SWF ファイルと同じディレクトリにあると想定しています。この例には、エラー処理コードはありません。</p> |
| |
| <p class="- topic/p ">マウスのシングルクリックとダブルクリックに応答するために、2 つのイベントリスナーが設定されます。ユーザーがボタンをシングルクリックすると、<codeph class="+ topic/ph pr-d/codeph ">clickHandler()</codeph> メソッドが呼び出され、サウンドが再生されます。ユーザーがボタンをダブルクリックすると、<codeph class="+ topic/ph pr-d/codeph ">doubleClickHandler()</codeph> メソッドが呼び出され、サウンドファイルが 2 回再生されます。<codeph class="+ topic/ph pr-d/codeph ">play()</codeph> メソッドの 2 番目の引数が <codeph class="+ topic/ph pr-d/codeph ">1</codeph> に設定されます。これは、サウンドが開始時点に 1 回ループバックされ、再び再生されることを意味します。1 つ目の引数（開始時点）は <codeph class="+ topic/ph pr-d/codeph ">0</codeph> に設定されます。これは、ファイルが最初から再生されることを意味します。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.events.MouseEvent; |
| import flash.media.Sound; |
| import flash.net.URLRequest; |
| |
| public class Sound_playExample2 extends Sprite { |
| private var button:Sprite = new Sprite(); |
| private var snd:Sound = new Sound(); |
| |
| public function Sound_playExample2() { |
| |
| var req:URLRequest = new URLRequest("click.mp3"); |
| snd.load(req); |
| |
| button.graphics.beginFill(0x00FF00); |
| button.graphics.drawRect(10, 10, 50, 30); |
| button.graphics.endFill(); |
| |
| button.addEventListener(MouseEvent.CLICK, clickHandler); |
| button.addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler); |
| |
| this.addChild(button); |
| } |
| |
| private function clickHandler(event:MouseEvent):void { |
| snd.play(); |
| } |
| |
| private function doubleClickHandler(event:MouseEvent):void { |
| snd.play(0, 2); |
| } |
| } |
| } |
| </codeblock></example><example conref="examples\Sound_playExample3.as" class="- topic/example "> 次の例では、サウンドファイルのロードと再生の進行状況を表示します。 |
| |
| <p class="- topic/p ">コンストラクターで、ファイルのロード中に発生する可能性のあるエラーをキャッチするために、ファイルが <codeph class="+ topic/ph pr-d/codeph ">try...catch</codeph> ブロックにロードされます。リスナーが <codeph class="+ topic/ph pr-d/codeph ">errorHandler()</codeph> メソッドを呼び出すことで <codeph class="+ topic/ph pr-d/codeph ">IOErrorEvent</codeph> イベントに応答するサウンドオブジェクトに追加されます。もう 1 つのリスナーが <codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> イベントに応答するメインアプリケーションに追加されます。このイベントは、再生の進行状況を表示するタイミング制御メカニズムとして使用されます。最後に、3 番目のリスナーが <codeph class="+ topic/ph pr-d/codeph ">soundCompleteHandler()</codeph> メソッドを呼び出すことで <codeph class="+ topic/ph pr-d/codeph ">Event.SOUND_COMPLETE</codeph> イベントに（サウンドの再生が終了したときに）応答するサウンドチャンネルに追加されます。<codeph class="+ topic/ph pr-d/codeph ">soundCompleteHandler()</codeph> メソッドによって、<codeph class="+ topic/ph pr-d/codeph ">Event.ENTER_FRAME</codeph> イベントのイベントリスナーの削除も実行されます。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">enterFrameHandler()</codeph> メソッドによって、<codeph class="+ topic/ph pr-d/codeph ">ProgressEvent</codeph> オブジェクトで渡される <codeph class="+ topic/ph pr-d/codeph ">bytesLoaded</codeph> 値が <codeph class="+ topic/ph pr-d/codeph ">bytesTotal</codeph> 値で除算され、ロードされるサウンドデータの割合（パーセント）が算出されます。再生されるサウンドデータの割合（パーセント）は、サウンドチャンネルの <codeph class="+ topic/ph pr-d/codeph ">position</codeph> プロパティの値をサウンドデータの長さで除算することで算出される場合があります。ただし、サウンドデータが完全にロードされていない場合、サウンドオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">length</codeph> プロパティは、現在ロードされているサウンドデータのみのサイズを表示します。完全なサウンドファイルの最終的なサイズの推定値は、現在のサウンドオブジェクトの <codeph class="+ topic/ph pr-d/codeph ">length</codeph> の値を <codeph class="+ topic/ph pr-d/codeph ">bytesLoaded</codeph> プロパティの値で除算してから、<codeph class="+ topic/ph pr-d/codeph ">bytesTotal</codeph> プロパティの値で除算することで算出されます。</p> |
| |
| <p class="- topic/p ">ファイルが小さいか、キャッシュされているか、ローカルディレクトリにある場合、ロードの進行状況が目立たない場合があります。また、サウンドデータのロードが開始されてから、ロードされたデータの再生が開始されるまでの遅延時間は、<codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.buffertime</codeph> プロパティの値によって指定されます。この値は、デフォルトで 1000 ミリ秒であり、リセットできます。</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.URLRequest; |
| import flash.media.Sound; |
| import flash.media.SoundChannel; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.Event; |
| import flash.events.IOErrorEvent; |
| |
| public class Sound_playExample3 extends Sprite { |
| private var snd:Sound = new Sound(); |
| private var channel:SoundChannel; |
| private var statusTextField:TextField = new TextField(); |
| |
| public function Sound_playExample3(){ |
| |
| statusTextField.autoSize = TextFieldAutoSize.LEFT; |
| |
| var req:URLRequest = new URLRequest("http://av.adobe.com/podcast/csbu_dev_podcast_epi_2.mp3"); |
| |
| try { |
| snd.load(req); |
| |
| channel = snd.play(); |
| } |
| catch (err:Error) { |
| trace(err.message); |
| } |
| |
| snd.addEventListener(IOErrorEvent.IO_ERROR, errorHandler); |
| addEventListener(Event.ENTER_FRAME, enterFrameHandler); |
| channel.addEventListener(Event.SOUND_COMPLETE, soundCompleteHandler); |
| |
| this.addChild(statusTextField); |
| } |
| |
| private function enterFrameHandler(event:Event):void { |
| var loadTime:Number = snd.bytesLoaded / snd.bytesTotal; |
| var loadPercent:uint = Math.round(100 * loadTime); |
| var estimatedLength:int = Math.ceil(snd.length / (loadTime)); |
| var playbackPercent:uint = Math.round(100 * (channel.position / estimatedLength)); |
| |
| statusTextField.text = "Sound file's size is " + snd.bytesTotal + " bytes.\n" |
| + "Bytes being loaded: " + snd.bytesLoaded + "\n" |
| + "Percentage of sound file that is loaded " + loadPercent + "%.\n" |
| + "Sound playback is " + playbackPercent + "% complete."; |
| } |
| |
| private function errorHandler(errorEvent:IOErrorEvent):void { |
| statusTextField.text = "The sound could not be loaded: " + errorEvent.text; |
| } |
| |
| private function soundCompleteHandler(event:Event):void { |
| statusTextField.text = "The sound has finished playing."; |
| removeEventListener(Event.ENTER_FRAME, enterFrameHandler); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#SoundChannel/stop()" class="- topic/link "><linktext class="- topic/linktext ">SoundChannel.stop()</linktext></link><link href="flash.media.xml#SoundMixer/stopAll()" class="- topic/link "><linktext class="- topic/linktext ">SoundMixer.stopAll()</linktext></link></related-links></apiOperation><apiValue id="flash.media:Sound:bytesLoaded: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 ">bytesLoaded</apiName><shortdesc class="- topic/shortdesc "> |
| この Sound オブジェクトで現在利用できるデータのバイト数を返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| この Sound オブジェクトで現在利用できるデータのバイト数を返します。このプロパティは、通常、外部から読み込むファイルのみに使用します。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Sound:bytesTotal: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 ">bytesTotal</apiName><shortdesc class="- topic/shortdesc "> |
| この Sound オブジェクトの合計バイト数を返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| </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 ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| この Sound オブジェクトの合計バイト数を返します。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Sound:id3: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 ">id3</apiName><shortdesc class="- topic/shortdesc "> |
| MP3 ファイルの一部であるメタデータに対するアクセスを提供します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">sound, Sound.id3, id3, mp3 |
| </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 ">flash.media:ID3Info</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| MP3 ファイルの一部であるメタデータに対するアクセスを提供します。 |
| |
| <p class="- topic/p ">MP3 サウンドファイルには、ファイルについてのメタデータを示す ID3 タグを含めることができます。<codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> メソッドを使用してロードした MP3 サウンドに ID3 タグが含まれる場合は、これらのプロパティを調べることができます。サポートされているのは、UTF-8 文字セットを使用する ID3 タグだけです。</p> |
| |
| <p class="- topic/p "><ph class="- topic/ph ">Flash Player 9 以降および AIR</ph> では ID3 2.0（厳密には 2.3 および 2.4）のタグをサポートしています。次の表に、標準の ID3 2.0 タグと、そのタグが表すコンテンツタイプを示します。<codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> プロパティは <codeph class="+ topic/ph pr-d/codeph ">my_sound.id3.COMM</codeph>、<codeph class="+ topic/ph pr-d/codeph ">my_sound.id3.TIME</codeph> などの形式を使用してこれらのタグにアクセスできます。最初の表は、ID3 2.0 プロパティ名または ActionScript プロパティ名のいずれかを使用してアクセスできるタグを示します。2 番目の表は、サポートされているものの、ActionScript に定義済みのプロパティが存在しない ID3 タグを示します。 </p> |
| |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><b class="+ topic/ph hi-d/b ">ID3 2.0 タグ</b></entry><entry class="- topic/entry "><b class="+ topic/ph hi-d/b ">対応する Sound クラスプロパティ</b></entry></row><row class="- topic/row "><entry class="- topic/entry ">COMM</entry><entry class="- topic/entry ">Sound.id3.comment</entry></row><row class="- topic/row "><entry class="- topic/entry ">TALB</entry><entry class="- topic/entry ">Sound.id3.album </entry></row><row class="- topic/row "><entry class="- topic/entry ">TCON</entry><entry class="- topic/entry ">Sound.id3.genre</entry></row><row class="- topic/row "><entry class="- topic/entry ">TIT2</entry><entry class="- topic/entry ">Sound.id3.songName </entry></row><row class="- topic/row "><entry class="- topic/entry ">TPE1</entry><entry class="- topic/entry ">Sound.id3.artist</entry></row><row class="- topic/row "><entry class="- topic/entry ">TRCK</entry><entry class="- topic/entry ">Sound.id3.track </entry></row><row class="- topic/row "><entry class="- topic/entry ">TYER</entry><entry class="- topic/entry ">Sound.id3.year </entry></row></tbody></tgroup></adobetable> |
| |
| <p class="- topic/p ">次の表は、サポートされているものの、Sound クラスに定義済みのプロパティが存在しない ID3 タグを示します。これらのタグにアクセスするには、<codeph class="+ topic/ph pr-d/codeph ">mySound.id3.TFLT</codeph>、<codeph class="+ topic/ph pr-d/codeph ">mySound.id3.TIME</codeph> などを呼び出します。<b class="+ topic/ph hi-d/b ">注意：</b>これらのタグはいずれも、Flash Lite 4 ではサポートされません。</p> |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><b class="+ topic/ph hi-d/b ">プロパティ</b></entry><entry class="- topic/entry "><b class="+ topic/ph hi-d/b ">説明</b></entry></row><row class="- topic/row "><entry class="- topic/entry ">TFLT</entry><entry class="- topic/entry ">ファイル形式</entry></row><row class="- topic/row "><entry class="- topic/entry ">TIME</entry><entry class="- topic/entry ">時刻</entry></row><row class="- topic/row "><entry class="- topic/entry ">TIT1</entry><entry class="- topic/entry ">内容の属するグループの説明</entry></row><row class="- topic/row "><entry class="- topic/entry ">TIT2</entry><entry class="- topic/entry ">タイトル/曲名/内容の説明</entry></row><row class="- topic/row "><entry class="- topic/entry ">TIT3</entry><entry class="- topic/entry ">サブタイトル/説明の追加情報</entry></row><row class="- topic/row "><entry class="- topic/entry ">TKEY</entry><entry class="- topic/entry ">最初の調</entry></row><row class="- topic/row "><entry class="- topic/entry ">TLAN</entry><entry class="- topic/entry ">言語</entry></row><row class="- topic/row "><entry class="- topic/entry ">TLEN</entry><entry class="- topic/entry ">長さ</entry></row><row class="- topic/row "><entry class="- topic/entry ">TMED</entry><entry class="- topic/entry ">メディアタイプ</entry></row><row class="- topic/row "><entry class="- topic/entry ">TOAL</entry><entry class="- topic/entry ">オリジナルのアルバム/ムービー/ショーのタイトル</entry></row><row class="- topic/row "><entry class="- topic/entry ">TOFN</entry><entry class="- topic/entry ">オリジナルのファイル名</entry></row><row class="- topic/row "><entry class="- topic/entry ">TOLY</entry><entry class="- topic/entry ">オリジナルの作詞家/文書作成者</entry></row><row class="- topic/row "><entry class="- topic/entry ">TOPE</entry><entry class="- topic/entry ">オリジナルのアーティスト/演奏者</entry></row><row class="- topic/row "><entry class="- topic/entry ">TORY</entry><entry class="- topic/entry ">オリジナルのリリース年</entry></row><row class="- topic/row "><entry class="- topic/entry ">TOWN</entry><entry class="- topic/entry ">ファイルの所有者/ライセンス保持者</entry></row><row class="- topic/row "><entry class="- topic/entry ">TPE1</entry><entry class="- topic/entry ">主な演奏者/ソリスト</entry></row><row class="- topic/row "><entry class="- topic/entry ">TPE2</entry><entry class="- topic/entry ">バンド/オーケストラ/伴奏</entry></row><row class="- topic/row "><entry class="- topic/entry ">TPE3</entry><entry class="- topic/entry ">指揮者/演奏者詳細情報</entry></row><row class="- topic/row "><entry class="- topic/entry ">TPE4</entry><entry class="- topic/entry ">翻訳、リミックス、その他の修正を行った人</entry></row><row class="- topic/row "><entry class="- topic/entry ">TPOS</entry><entry class="- topic/entry ">セット中の位置</entry></row><row class="- topic/row "><entry class="- topic/entry ">TPUB</entry><entry class="- topic/entry ">発行者</entry></row><row class="- topic/row "><entry class="- topic/entry ">TRCK</entry><entry class="- topic/entry ">トラック番号/セット内の位置</entry></row><row class="- topic/row "><entry class="- topic/entry ">TRDA</entry><entry class="- topic/entry ">録音日</entry></row><row class="- topic/row "><entry class="- topic/entry ">TRSN</entry><entry class="- topic/entry ">インターネットラジオ局の名前</entry></row><row class="- topic/row "><entry class="- topic/entry ">TRSO</entry><entry class="- topic/entry ">インターネットラジオ局の所有者</entry></row><row class="- topic/row "><entry class="- topic/entry ">TSIZ</entry><entry class="- topic/entry ">サイズ</entry></row><row class="- topic/row "><entry class="- topic/entry ">TSRC</entry><entry class="- topic/entry ">ISRC（国際標準録音資料コード）</entry></row><row class="- topic/row "><entry class="- topic/entry ">TSSE</entry><entry class="- topic/entry ">エンコードに使用したソフトウェア/ハードウェアと設定</entry></row><row class="- topic/row "><entry class="- topic/entry ">TYER</entry><entry class="- topic/entry ">年</entry></row><row class="- topic/row "><entry class="- topic/entry ">WXXX</entry><entry class="- topic/entry ">URL リンクフレーム</entry></row></tbody></tgroup></adobetable> |
| |
| |
| <p class="- topic/p ">このプロパティを使用するときは、Flash Player セキュリティモデルを考慮してください。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> プロパティは、サウンドファイルと同じセキュリティサンドボックス内にある SWF ファイルで常に使用できます。他のサンドボックス内のファイルには、セキュリティチェックがあります。</li><li class="- topic/li ">サウンドをロードするとき、Sound クラスの <codeph class="+ topic/ph pr-d/codeph ">load()</codeph> メソッドを使用すると、SoundLoaderContext オブジェクトである <codeph class="+ topic/ph pr-d/codeph ">context</codeph> パラメーターを指定できます。SoundLoaderContext オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">checkPolicyFile</codeph> プロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定した場合、Flash Player は、サウンドがロードされるサーバー上に URL ポリシーファイルがあるかどうかをチェックします。ポリシーファイルが存在しており、そのファイルでロード元 SWF ファイルのドメインからのアクセスが許可されている場合、Sound オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> プロパティにアクセスできます。それ以外の場合は、アクセスできません。</li></ul> |
| |
| <p class="- topic/p ">ただし、Adobe AIR では、<codeph class="+ topic/ph pr-d/codeph ">アプリケーション</codeph>セキュリティサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。</p> |
| |
| <p class="- topic/p ">セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：<xref href="http://www.adobe.com/go/devnet_security_jp" scope="external" class="- topic/xref ">セキュリティ</xref>を参照してください。</p> |
| |
| </apiDesc><example conref="examples\Sound_id3Example.as" class="- topic/example "> 次の例では、サウンドファイルから ID3 情報を読み取り、テキストフィールドに表示します。 |
| |
| <p class="- topic/p ">コンストラクターで、サウンドファイルがロードされますが、再生するように設定されていません。ここでは、ファイルが SWF ディレクトリにあると想定しています。ロードされるサウンドファイルの ID3 タグを読み取るために、システムにアクセス権がある必要があります。ファイル内に ID3 情報が存在し、プログラムに読み取ることが許可されている場合、<codeph class="+ topic/ph pr-d/codeph ">Event.ID3</codeph> イベントが送出され、サウンドファイルの <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> プロパティに値が設定されます。<codeph class="+ topic/ph pr-d/codeph ">id3</codeph> プロパティには、すべての ID3 情報を持つ <codeph class="+ topic/ph pr-d/codeph ">ID3Info</codeph> オブジェクトが格納されています。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">id3Handler()</codeph> メソッドで、ファイルの ID3 タグが ID3Info クラスのオブジェクトである <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> に保存されます。テキストフィールドがインスタンス化され、ID3 タグの一覧が表示されます。for ループによってすべての ID3 2.0 タグが繰り返し処理され、テキストフィールドの内容に名前と値が追加されます。ID3 info（<codeph class="+ topic/ph pr-d/codeph ">ID3Info</codeph>）プロパティを使用して、アーティスト、曲名、およびアルバムも追加されます。ActionScript 3.0 および Flash Player 9 以降では、ID3 2.0 タグ、特に 2.3 と 2.4 がサポートされます。この for ループのようにプロパティの反復処理を実行すると、ID3 2.0 タグだけが表示されます。ただし、以前のバージョンからのデータも曲の <codeph class="+ topic/ph pr-d/codeph ">id3</codeph> プロパティに保存され、ID3 info クラスのプロパティを使用してアクセスできます。ID3 1.0 のタグはファイルに末尾にあります。一方、ID3 2.0 タグはファイルの先頭にあります。以前のバージョンと最新バージョンのタグがファイルの同じ場所にある場合があります。ファイルが、ファイルの先頭と末尾にあるバージョン 1.0 タグと 2.0 タグの両方でエンコードされている場合、<codeph class="+ topic/ph pr-d/codeph ">id3Handler()</codeph> メソッドが 2 回呼び出されます。最初にバージョン 2.0 が読み込まれ、次にバージョン 1.0 が読み込まれます。ID3 1.0 タグだけが使用できる場合、<codeph class="+ topic/ph pr-d/codeph ">id3.songname</codeph> などと記述して、ID3 info プロパティを介して情報にアクセスできます。ID3 2.0 では、新しいタグ（TITS）を使用して <codeph class="+ topic/ph pr-d/codeph ">id3.TITS</codeph> プロパティによって曲名が取得されます。</p> |
| |
| <p class="- topic/p ">この例にはエラー処理の記述がないため、ID3 の内容が長い場合、結果が表示可能領域を超える場合があります。</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.media.Sound; |
| import flash.net.URLRequest; |
| import flash.media.ID3Info; |
| import flash.text.TextField; |
| import flash.text.TextFieldAutoSize; |
| import flash.events.Event; |
| |
| public class Sound_id3Example extends Sprite { |
| private var snd:Sound = new Sound(); |
| private var myTextField:TextField = new TextField(); |
| |
| public function Sound_id3Example() { |
| snd.addEventListener(Event.ID3, id3Handler); |
| snd.load(new URLRequest("mySound.mp3")); |
| } |
| |
| private function id3Handler(event:Event):void { |
| var id3:ID3Info = snd.id3; |
| |
| myTextField.autoSize = TextFieldAutoSize.LEFT; |
| myTextField.border = true; |
| |
| myTextField.appendText("Received ID3 Info: \n"); |
| |
| for (var propName:String in id3) { |
| myTextField.appendText(propName + " = " + id3[propName] + "\n"); |
| } |
| |
| myTextField.appendText("\n" + "Artist: " + id3.artist + "\n"); |
| myTextField.appendText("Song name: " + id3.songName + "\n"); |
| myTextField.appendText("Album: " + id3.album + "\n\n"); |
| |
| this.addChild(myTextField); |
| } |
| } |
| } |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#SoundLoaderContext/checkPolicyFile" class="- topic/link "><linktext class="- topic/linktext ">SoundLoaderContext.checkPolicyFile</linktext></link></related-links></apiValue><apiValue id="flash.media:Sound:isBuffering: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 ">isBuffering</apiName><shortdesc class="- topic/shortdesc "> |
| 外部 MP3 ファイルのバッファリング状態を返します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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> |
| |
| |
| </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 ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 外部 MP3 ファイルのバッファリング状態を返します。値が <codeph class="+ topic/ph pr-d/codeph ">true</codeph> の場合、再生は現在中断され、オブジェクトがデータを待機しています。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Sound:isURLInaccessible: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 ">isURLInaccessible</apiName><shortdesc class="- topic/shortdesc "> |
| Sound.url プロパティが切り詰められているかどうかを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="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 "/><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 "> |
| <codeph class="+ topic/ph pr-d/codeph ">Sound.url</codeph> プロパティが切り詰められているかどうかを示します。<codeph class="+ topic/ph pr-d/codeph ">isURLInaccessible</codeph> の値が <codeph class="+ topic/ph pr-d/codeph ">true</codeph> の場合、<codeph class="+ topic/ph pr-d/codeph ">Sound.url</codeph> の値は、サウンドのロード元となる最終的な URL のドメイン部分のみになります。例えば、サウンドが <codeph class="+ topic/ph pr-d/codeph ">http://www.adobe.com/assets/hello.mp3</codeph> からロードされ、<codeph class="+ topic/ph pr-d/codeph ">Sound.url</codeph> プロパティの値が <codeph class="+ topic/ph pr-d/codeph ">http://www.adobe.com</codeph> の場合、このプロパティは切り詰められています。<codeph class="+ topic/ph pr-d/codeph ">isURLInaccessible</codeph> の値は、以下の値もすべて true の場合のみ <codeph class="+ topic/ph pr-d/codeph ">true</codeph> になります。 |
| |
| <ul class="- topic/ul "><li class="- topic/li ">サウンドファイルのロード中に HTTP リダイレクトが発生しました。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> の呼び出し元の SWF ファイルが、サウンドファイルの最終的な URL とは別のドメインからのファイルです。</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> の呼び出し元の SWF ファイルに、サウンドファイルにアクセスする許可がありません。サウンドファイルへのアクセス許可は、<codeph class="+ topic/ph pr-d/codeph ">Sound.id3</codeph> プロパティへアクセスする場合と同じ方法で許可されます。つまり、ポリシーファイルを作成して、<codeph class="+ topic/ph pr-d/codeph ">SoundLoaderContext.checkPolicyFile</codeph> プロパティを使用します。</li></ul> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b><codeph class="+ topic/ph pr-d/codeph ">isURLInaccessible</codeph> プロパティは Flash Player 10.1 および AIR 2.0 用に追加されました。ただし、Flash ランタイムでサポートされている場合、このプロパティはすべてのバージョンの SWF ファイルで使用できます。このため、オーサリングツールを「strict モード」で使用するとコンパイルエラーが発生します。このエラーを回避するには、間接構文 <codeph class="+ topic/ph pr-d/codeph ">mySound["isURLInaccessible"]</codeph> を使用するか、strict モードを無効にします。Flash Professional CS5 または Flex SDK 4.1 を使用している場合、Flash Player 10.1 および AIR 2 以前にリリースされたランタイム向けに、この API を使用してコンパイルすることができます。</p> |
| |
| <p class="- topic/p ">AIR のアプリケーションコンテンツの場合、このプロパティの値は常に <codeph class="+ topic/ph pr-d/codeph ">false</codeph> です。</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/url" class="- topic/link "><linktext class="- topic/linktext ">url</linktext></link><link href="flash.media.xml#Sound/id3" class="- topic/link "><linktext class="- topic/linktext ">id3</linktext></link><link href="flash.media.xml#SoundLoaderContext/checkPolicyFile" class="- topic/link "><linktext class="- topic/linktext ">flash.media.SoundLoaderContext.checkPolicyFile</linktext></link></related-links></apiValue><apiValue id="flash.media:Sound:length: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 ">length</apiName><shortdesc class="- topic/shortdesc "> |
| 現在のサウンドの継続時間を示すミリ秒数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "> |
| 現在のサウンドの継続時間を示すミリ秒数です。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Sound:url: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 ">url</apiName><shortdesc class="- topic/shortdesc "> |
| サウンドがロードされる URL です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></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 "> |
| サウンドがロードされる URL です。このプロパティは <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> メソッドを使用してロードされた Sound オブジェクトにのみ適用できます。SWF ファイルのライブラリのサウンドアセットに関連付けられた Sound オブジェクトでは、<codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティの値は <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。 |
| |
| <p class="- topic/p ">初めて <codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> を呼び出す際は最終的な URL が不明なため、<codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティの初期値は <codeph class="+ topic/ph pr-d/codeph ">null</codeph> になります。<codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティは、Sound オブジェクトから <codeph class="+ topic/ph pr-d/codeph ">open</codeph> イベントが送出されると同時に、null 以外の値になります。</p> |
| |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティには、サウンドがロードされる元の最終的な絶対 URL が格納されます。<codeph class="+ topic/ph pr-d/codeph ">url</codeph> の値は、通常 <codeph class="+ topic/ph pr-d/codeph ">stream</codeph> パラメーター（<codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph>）に渡される値と同じです。ただし、<codeph class="+ topic/ph pr-d/codeph ">Sound.load()</codeph> に相対 URL を渡しても、<codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティの値は絶対 URL を表します。また、元の URL 要求が HTTP サーバーによってリダイレクトされると、<codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティの値はサウンドファイルが実際にダウンロードされた URL を示します。この最終的な絶対 URL の報告は、<codeph class="+ topic/ph pr-d/codeph ">LoaderInfo.url</codeph> の動作と同じです。</p> |
| <p class="- topic/p ">場合によっては、<codeph class="+ topic/ph pr-d/codeph ">url</codeph> プロパティの値が切り詰められていることがあります。詳しくは、<codeph class="+ topic/ph pr-d/codeph ">isURLInaccessible</codeph> プロパティを参照してください。</p> |
| |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Sound/load()" class="- topic/link "><linktext class="- topic/linktext ">load()</linktext></link><link href="flash.display.xml#LoaderInfo/url" class="- topic/link "><linktext class="- topic/linktext ">flash.display.LoaderInfo.url</linktext></link><link href="flash.media.xml#Sound/isURLInaccessible" class="- topic/link "><linktext class="- topic/linktext ">isURLInaccessible</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media:MicrophoneEnhancedMode" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">MicrophoneEnhancedMode</apiName><shortdesc class="- topic/shortdesc "> |
| MicrophoneEnhancedMode クラスは、MicrophoneEnhancedOptions クラスの mode プロパティの設定で使用される定数値の列挙です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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><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 "> |
| MicrophoneEnhancedMode クラスは、<codeph class="+ topic/ph pr-d/codeph ">MicrophoneEnhancedOptions</codeph> クラスの <codeph class="+ topic/ph pr-d/codeph ">mode</codeph> プロパティの設定で使用される定数値の列挙です。 |
| |
| </apiDesc></apiClassifierDetail><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 id="flash.media:MicrophoneEnhancedMode:FULL_DUPLEX" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">FULL_DUPLEX</apiName><shortdesc class="- topic/shortdesc "> |
| このモードを使用すると、両方の話者が同時に話すことができます。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><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 ">fullDuplex</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| このモードを使用すると、両方の話者が同時に話すことができます。音声エコー除去機能は全二重モードで動作します。全二重モードは、最高品質のエコー除去を実現します。このモードでは、高品質のマイクとスピーカーが必要とされ、処理負荷が最も大きくなります。USB マイクではこのモードを使用しないでください。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedMode:HALF_DUPLEX" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">HALF_DUPLEX</apiName><shortdesc class="- topic/shortdesc "> |
| 旧式で高品質ではないスピーカーとマイクには、このモードを使用します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><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 ">halfDuplex</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 旧式で高品質ではないスピーカーとマイクには、このモードを使用します。音声エコー除去機能が半二重モードで動作します。半二重モードでは、一度に一方の話者のみが話すことができます。半二重モードの処理は全二重モードに比べて簡単です。USB マイクデバイスでは、半二重モードがデフォルトのモードです。 |
| |
| <p class="- topic/p ">アプリケーションがデフォルトの <codeph class="+ topic/ph pr-d/codeph ">enhancedOptions</codeph> 設定と USB マイクを使用している場合は、Flash Player によって自動的に <codeph class="+ topic/ph pr-d/codeph ">halfDuplex</codeph> モードに切り替えられます。アプリケーションがデフォルトの <codeph class="+ topic/ph pr-d/codeph ">enhancedOptions</codeph> 設定と内蔵マイクを使用している場合は、Flash Player では <codeph class="+ topic/ph pr-d/codeph ">fullDuplex</codeph> モードが使用されます。</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedMode:HEADSET" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">HEADSET</apiName><shortdesc class="- topic/shortdesc "> |
| 両方の話者がヘッドセットを使用している場合は、このモードを使用します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><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 ">headset</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 両方の話者がヘッドセットを使用している場合は、このモードを使用します。音声エコー除去機能は低エコーモードで動作します。このモードでは、処理負荷が最も小さくなります。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedMode:OFF" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">OFF</apiName><shortdesc class="- topic/shortdesc "> |
| 拡張オーディオ機能はすべて無効になります。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><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 ">off</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 拡張オーディオ機能はすべて無効になります。 |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:MicrophoneEnhancedMode:SPEAKER_MUTE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">SPEAKER_MUTE</apiName><shortdesc class="- topic/shortdesc "> |
| スピーカーをミュートにしている場合は、このモードを使用します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><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 ">speakerMute</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| スピーカーをミュートにしている場合は、このモードを使用します。音声エコー除去機能は無効になります。拡張オーディオでは、ノイズ低減または自動ゲイン制御が実行されます（有効に設定されている場合）。 |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#MicrophoneEnhancedOptions/autoGain" class="- topic/link "><linktext class="- topic/linktext ">flash.media.MicrophoneEnhancedOptions.autoGain</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="flash.media: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 apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Video</apiName><shortdesc class="- topic/shortdesc "> |
| |
| Video クラスは、ビデオを SWF ファイルに埋め込むことなく、ライブビデオまたは録画ビデオをアプリケーションに表示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">Camera, video, NetStream |
| |
| </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 "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">flash.display:DisplayObject</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| |
| Video クラスは、ビデオを SWF ファイルに埋め込むことなく、ライブビデオまたは録画ビデオをアプリケーションに表示します。このクラスは、サーバーまたはローカルに保存された録画済みビデオファイルを再生する Video オブジェクト、またはユーザーによってキャプチャされるライブビデオを再生する Video オブジェクトを作成します。Video オブジェクトは、アプリケーションの表示リスト上の表示オブジェクトであり、ユーザーインターフェイスで実行されるビデオのビジュアルスペースを表します。 |
| |
| <p class="- topic/p "> |
| Flash Media Server で使用する場合、Video オブジェクトにより、ユーザーがキャプチャしたライブビデオをサーバーに送信し、サーバーから他のユーザーにブロードキャストできるようになります。これらの機能を使用することで、単純なビデオプレーヤー、あるサーバーから別のサーバーへのマルチポイントパブリッシュ機能を持つビデオプレーヤー、ユーザーコミュニティ用のビデオ共有アプリケーションなどのメディアアプリケーションを開発できます。 |
| </p> |
| |
| <p class="- topic/p "> |
| Flash Player 9 以降では、Sorenson Spark または On2 VP6 コーデックでエンコーディングされた FLV ファイルのパブリッシュと再生をサポートし、アルファチャンネルもサポートしています。On2 VP6 ビデオコーデックは、古いテクノロジよりも少ない帯域幅を使用し、追加の非ブロックフィルターとリンギング除去フィルターを提供します。 ビデオの再生およびサポートされる形式について詳しくは、flash.net.NetStream クラスを参照してください。</p> |
| |
| |
| <p class="- topic/p "> |
| Flash Player 9.0.115.0 以降では、実行時レンダリングの品質とパフォーマンスを最適化するミップマッピングがサポートされます。ビデオ再生では、Video オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">smoothing</codeph> プロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定すると、Flash Player がミップマッピング最適化を使用します。 |
| </p> |
| |
| <p class="- topic/p "> |
| 表示リスト上の他の表示オブジェクトと同様に、Video オブジェクトの各種プロパティを制御できます。例えば、<codeph class="+ topic/ph pr-d/codeph ">x</codeph> プロパティおよび <codeph class="+ topic/ph pr-d/codeph ">y</codeph> プロパティを使用したステージ上での Video オブジェクトの移動、<codeph class="+ topic/ph pr-d/codeph ">height</codeph> プロパティおよび <codeph class="+ topic/ph pr-d/codeph ">width</codeph> プロパティを使用したサイズの変更などができます。 |
| </p> |
| |
| <p class="- topic/p "> |
| ビデオストリームを再生するには、<codeph class="+ topic/ph pr-d/codeph ">attachCamera()</codeph> または <codeph class="+ topic/ph pr-d/codeph ">attachNetStream()</codeph> を使用して、ビデオを Video オブジェクトに関連付けます。次に、<codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph> を使用して、Video オブジェクトを表示リストに追加します。 |
| </p> |
| |
| <p class="- topic/p "> |
| Flash Professional を使用する場合は、<codeph class="+ topic/ph pr-d/codeph ">addChild()</codeph> を使用して追加するのではなく、次のようにステージに Video オブジェクトを配置することもできます。 |
| </p> |
| |
| <ol class="- topic/ol "><li class="- topic/li ">ライブラリパネルを表示していない場合は、ウィンドウ／ライブラリを選択して表示します。</li><li class="- topic/li ">ライブラリパネルのタイトルバーの右側にある「オプション」メニューをクリックして「新規ビデオ」を選択し、埋め込み Video オブジェクトをライブラリに追加します。</li><li class="- topic/li ">ビデオのプロパティダイアログボックスで、ライブラリで使用する埋め込み Video オブジェクトの名前を付け、「OK」をクリックします。</li><li class="- topic/li ">Video オブジェクトをステージにドラッグし、プロパティインスペクターを使用して一意のインスタンス名（<codeph class="+ topic/ph pr-d/codeph ">my_video</codeph> など）を付けます。"Video" という名前にはしないでください。</li></ol> |
| |
| <p class="- topic/p ">デスクトップの AIR アプリケーションで、フルスクリーンモードでビデオを再生すると、節電機能とスクリーンセーバー機能は無効になります（オペレーティングシステムで許可されている場合）。</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>Video クラスは InteractiveObject クラスのサブクラスではないため、マウスイベントを送出できません。ただし、Video オブジェクトを格納する表示オブジェクトコンテナで <codeph class="+ topic/ph pr-d/codeph ">addEventListener()</codeph> メソッドを呼び出すことができます。 |
| </p> |
| |
| </apiDesc><example conref="examples\VideoExample.as" class="- topic/example "> 次の例では、Video オブジェクトを NetConnection クラスおよび NetStream クラスと共に使用して、FLV ファイルをロードして再生します。この例を実行するには、<codeph class="+ topic/ph pr-d/codeph ">videoURL</codeph> に渡される変数と、ファイル名および場所が一致する FLV ファイルが必要です。この場合は、SWF ファイルと同じディレクトリにある Video.flv という名前の FLV ファイルです。 |
| <p class="- topic/p ">この例では、Video オブジェクトと NetStream オブジェクトを作成し、<codeph class="+ topic/ph pr-d/codeph ">Video.attachNetStream()</codeph> および <codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> メソッドを呼び出すコードがハンドラー関数に配置されます。ハンドラーは、NetConnection オブジェクトへの接続が成功した場合にのみ呼び出されます。つまり、<codeph class="+ topic/ph pr-d/codeph ">netStatus</codeph> イベントが、成功したことを示す <codeph class="+ topic/ph pr-d/codeph ">code</codeph> プロパティと共に info オブジェクトを返す場合です。接続に成功するまで待ってから、<codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> を呼び出すことをお勧めします。 </p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| import flash.events.*; |
| import flash.media.Video; |
| import flash.net.NetConnection; |
| import flash.net.NetStream; |
| |
| public class VideoExample extends Sprite { |
| private var videoURL:String = "Video.flv"; |
| private var connection:NetConnection; |
| private var stream:NetStream; |
| |
| public function VideoExample() { |
| connection = new NetConnection(); |
| connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); |
| connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); |
| connection.connect(null); |
| } |
| |
| private function netStatusHandler(event:NetStatusEvent):void { |
| switch (event.info.code) { |
| case "NetConnection.Connect.Success": |
| connectStream(); |
| break; |
| case "NetStream.Play.StreamNotFound": |
| trace("Unable to locate video: " + videoURL); |
| break; |
| } |
| } |
| |
| private function connectStream():void { |
| stream = new NetStream(connection); |
| stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); |
| stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); |
| var video:Video = new Video(); |
| video.attachNetStream(stream); |
| stream.play(videoURL); |
| addChild(video); |
| } |
| |
| private function securityErrorHandler(event:SecurityErrorEvent):void { |
| trace("securityErrorHandler: " + event); |
| } |
| |
| private function asyncErrorHandler(event:AsyncErrorEvent):void { |
| // ignore AsyncErrorEvent events. |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Video/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">attachCamera()</linktext></link><link href="flash.media.xml#Video/attachNetStream()" class="- topic/link "><linktext class="- topic/linktext ">attachNetStream()</linktext></link><link href="flash.media.xml#Camera/getCamera()" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Camera.getCamera()</linktext></link><link href="flash.net.xml#NetConnection" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetConnection</linktext></link><link href="flash.net.xml#NetStream" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream</linktext></link><link href="flash.display.xml#DisplayObjectContainer/addChild()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.DisplayObjectContainer.addChild()</linktext></link><link href="flash.display.xml#Stage/addChild()" class="- topic/link "><linktext class="- topic/linktext ">flash.display.Stage.addChild()</linktext></link><link href="http://help.adobe.com/en_US/as3/dev/WS5b3ccc516d4fbf351e63e3d118a9b90204-7e1a.html" class="- topic/link "><linktext class="- topic/linktext ">ビデオの操作</linktext></link></related-links><apiConstructor id="flash.media:Video: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 apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Video</apiName><shortdesc class="- topic/shortdesc "> |
| 新しい Video インスタンスを作成します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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, NetStream |
| </keyword></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 ">width</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">320</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ビデオの幅（ピクセル単位）です。 |
| </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><apiData class="- topic/ph reference/ph apiRef/apiData ">240</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ビデオの高さ（ピクセル単位）です。 |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 新しい Video インスタンスを作成します。<codeph class="+ topic/ph pr-d/codeph ">width</codeph> パラメーターと <codeph class="+ topic/ph pr-d/codeph ">height</codeph> パラメーターの値が指定されていない場合は、デフォルト値が使用されます。Video オブジェクトの初期構築後に、<codeph class="+ topic/ph pr-d/codeph ">Video.width</codeph> と <codeph class="+ topic/ph pr-d/codeph ">Video.height</codeph> を使用して幅と高さのプロパティを設定することもできます。新しい Video オブジェクトを作成する際に、幅または高さに 0 は設定できません。0 を渡すと、デフォルト値が適用されます。 |
| |
| <p class="- topic/p ">Video オブジェクトの作成後、<codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChild()</codeph> メソッドまたは <codeph class="+ topic/ph pr-d/codeph ">DisplayObjectContainer.addChildAt()</codeph> メソッドを呼び出して、親 DisplayObjectContainer オブジェクトに Video オブジェクトを追加できます。</p> |
| |
| </apiDesc><example conref="examples\Video_new.as" class="- topic/example "> 次の例は、外部 FLV ファイルをロードする方法を示しています。 |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var MyVideo:Video = new Video(); |
| addChild(MyVideo); |
| |
| var MyNC:NetConnection = new NetConnection(); |
| MyNC.connect(null); |
| |
| var MyNS:NetStream = new NetStream(MyNC); |
| MyNS.play("http://www.helpexamples.com/flash/video/clouds.flv"); |
| |
| MyVideo.attachNetStream(MyNS); |
| |
| //the clouds.flv video has metadata we're not using, so create |
| //an error handler to ignore the message generated by the runtime |
| //about the metadata |
| MyNS.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); |
| |
| function asyncErrorHandler(event:AsyncErrorEvent):void |
| { |
| //ignore metadata error message |
| } |
| </codeblock></example></apiConstructorDetail></apiConstructor><apiOperation id="flash.media:Video:attachCamera" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">attachCamera</apiName><shortdesc class="- topic/shortdesc "> |
| アプリケーション内の Video オブジェクトの境界内に表示するカメラからのビデオストリームを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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, Video.attachCamera, attachCamera() |
| </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 ">camera</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.media:Camera</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">ビデオデータをキャプチャする Camera オブジェクトです。Video オブジェクトへの接続を閉じるには、<codeph class="+ topic/ph pr-d/codeph ">null</codeph> を渡します。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| アプリケーション内の Video オブジェクトの境界内に表示するカメラからのビデオストリームを指定します。 |
| |
| <p class="- topic/p "> |
| このメソッドは、ユーザーがキャプチャしたライブビデオを Video オブジェクトに添付するために使用します。ライブビデオをキャプチャした同じコンピューターまたはデバイスで、ローカルにライブビデオを再生することも、Flash Media Server に送信し、サーバーを使用して、他のユーザーにストリームすることもできます。 |
| </p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">注意：</b>iOS AIR アプリケーションでは、アプリケーションが GPU レンダリングモードを使用している際にはカメラビデオは表示されません。</p> |
| |
| </apiDesc><example class="- topic/example ">このメソッドの使用方法について詳しくは、<xref href="Camera.html#getCamera()" class="- topic/xref ">Camera.getCamera()</xref> メソッドの例を参照してください。 |
| </example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Video/attachNetStream()" class="- topic/link "><linktext class="- topic/linktext ">Video.attachNetStream()</linktext></link><link href="flash.media.xml#Camera" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Camera</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Video:attachNetStream" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attachNetStream</apiName><shortdesc class="- topic/shortdesc "> |
| アプリケーション内の Video オブジェクトの境界内に表示するビデオストリームを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">NetStream, video, Video.attachNetStream, attachNetStream() |
| |
| </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 ">netStream</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">flash.net:NetStream</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">NetStream オブジェクトです。Video オブジェクトへの接続を閉じるには、<codeph class="+ topic/ph pr-d/codeph ">null</codeph> を渡します。 |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| アプリケーション内の Video オブジェクトの境界内に表示するビデオストリームを指定します。ビデオストリームは、<codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> で再生されるビデオファイル、Camera オブジェクト、または <codeph class="+ topic/ph pr-d/codeph ">null</codeph> です。ビデオファイルを使用する場合、ファイルはローカルファイルシステムまたは Flash Media Server に保存できます。<codeph class="+ topic/ph pr-d/codeph ">netStream</codeph> 引数の値に <codeph class="+ topic/ph pr-d/codeph ">null</codeph> を指定すると、Video オブジェクト内でビデオが再生されなくなります。 |
| |
| <p class="- topic/p "> |
| ビデオファイルにオーディオしか含まれない場合、このメソッドを使用する必要はありません。ビデオファイルのオーディオ部分は、<codeph class="+ topic/ph pr-d/codeph ">NetStream.play()</codeph> を呼び出すと自動的に再生されます。ビデオファイルに関連付けられたオーディオを制御するには、ビデオファイルを再生する NetStream オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">soundTransform</codeph> プロパティを使用します。 |
| </p> |
| |
| </apiDesc><example class="- topic/example ">このメソッドの使用方法の詳細については、このクラスの末尾の例を参照してください。 |
| |
| </example></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Video/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">Video.attachCamera()</linktext></link><link href="flash.net.xml#NetStream/soundTransform" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.soundTransform</linktext></link><link href="flash.net.xml#NetStream/play()" class="- topic/link "><linktext class="- topic/linktext ">flash.net.NetStream.play()</linktext></link><link href="flash.media.xml#SoundTransform" class="- topic/link "><linktext class="- topic/linktext ">SoundTransform</linktext></link></related-links></apiOperation><apiOperation id="flash.media:Video:clear" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (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 ">clear</apiName><shortdesc class="- topic/shortdesc "> |
| Video オブジェクトに現在表示されているイメージ（ビデオストリームではない）をクリアします。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">Camera, video, Video.clear, clear |
| |
| </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></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Video オブジェクトに現在表示されているイメージ（ビデオストリームではない）をクリアします。このメソッドは、現在のイメージを処理する場合に便利です。例えば、最後のイメージをクリアしたり、Video オブジェクトを非表示にせずにスタンバイ情報を表示したりできます。 |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Video/attachCamera()" class="- topic/link "><linktext class="- topic/linktext ">Video.attachCamera()</linktext></link></related-links></apiOperation><apiValue id="flash.media:Video:deblocking: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 ">deblocking</apiName><shortdesc class="- topic/shortdesc "> |
| 事後処理中に、デコードされたビデオに適用されるフィルターのタイプを示します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">Camera, video, Video.deblocking, deblocking |
| |
| </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 "> |
| 事後処理中に、デコードされたビデオに適用されるフィルターのタイプを示します。デフォルト値の 0 に設定すると、ビデオコンプレッサは必要に応じて非ブロックフィルターを適用します。 |
| |
| <p class="- topic/p ">ビデオの圧縮によって、好ましくない生成結果となる場合があります。<codeph class="+ topic/ph pr-d/codeph ">deblocking</codeph> プロパティを使用して、ブロッキングと、On2 コーデックを使用して圧縮されたビデオのリンギングを低減するフィルターを設定できます。</p> |
| |
| <p class="- topic/p "><i class="+ topic/ph hi-d/i ">ブロッキング</i>とは、各ビデオフレームを構成するブロックの境界と境界の間に見られる不具合のことです。<i class="+ topic/ph hi-d/i ">リンギング</i>とは、ビデオイメージ内の要素の周囲が歪曲することです。</p> |
| |
| <p class="- topic/p ">次の 2 つの非ブロックフィルターを使用できます。1 つは Sorenson コーデックにあり、もう 1 つは On2 VP6 コーデックにあります。さらに、On2 VP6 コーデックを使用する際にはリンギング除去フィルターを使用できます。フィルターを設定するには、次のいずれかの値を使用します。</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">0 - ビデオコンプレッサは必要に応じて非ブロックフィルターを適用します。</li><li class="- topic/li ">1 - 非ブロックフィルターを使用しません。</li><li class="- topic/li ">2 - Sorenson 非ブロックフィルターを使用します。</li><li class="- topic/li ">3 - On2 ビデオにのみ、On2 非ブロックフィルターを使用し、リンギング除去フィルターは使用しません。</li><li class="- topic/li ">4 - On2 ビデオにのみ、On2 非ブロックフィルターとリンギング除去フィルターを使用します。</li><li class="- topic/li ">5 - On2 ビデオにのみ、On2 非ブロックフィルターとパフォーマンスが向上した On2 リンギング除去フィルターを使用します。</li></ul> |
| |
| <p class="- topic/p ">Sorenson コーデックの使用時にビデオに 2 より大きい値を選択すると、Sorenson デコーダはデフォルトで 2 になります。</p> |
| |
| <p class="- topic/p ">非ブロックフィルターを使用すると、全体的な再生のパフォーマンスに影響します。高帯域幅のビデオには、通常は必要ありません。非ブロックフィルターを有効にしたビデオは、処理能力の低いシステムでは再生が困難なことがあります。</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Video:smoothing: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 ">smoothing</apiName><shortdesc class="- topic/shortdesc "> |
| ビデオを拡大 / 縮小する際にスムージング（補間）するかどうかを指定します。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">Camera, video, Video.smoothing, smoothing |
| |
| </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 "> |
| ビデオを拡大 / 縮小する際にスムージング（補間）するかどうかを指定します。スムージングを行うには、ランタイムが高品質モード（デフォルト）である必要があります。デフォルト値は <codeph class="+ topic/ph pr-d/codeph ">false</codeph>（スムージングなし）です。 |
| <p class="- topic/p ">Flash Player 9.0.115.0 以降のバージョンを使用するビデオ再生では、このプロパティを <codeph class="+ topic/ph pr-d/codeph ">true</codeph> に設定して、ミップマッピングイメージ最適化を利用します。</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="flash.media:Video:videoHeight:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">videoHeight</apiName><shortdesc class="- topic/shortdesc "> |
| ビデオストリームの高さをピクセル単位で指定する整数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">Camera, video, Video.height, height |
| |
| </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 "> |
| ビデオストリームの高さをピクセル単位で指定する整数です。ライブストリームの場合、この値はビデオストリームをキャプチャしている Camera オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">Camera.height</codeph> プロパティと同じです。録画済みビデオファイルの場合、この値はビデオの高さです。 |
| <p class="- topic/p ">このプロパティは、ステージ上の実際の Video オブジェクトのサイズとは関係なく、キャプチャしたのと同じサイズでユーザーに対してビデオを表示する場合などに使用します。</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/height" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Camera.height</linktext></link></related-links></apiValue><apiValue id="flash.media:Video:videoWidth:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">videoWidth</apiName><shortdesc class="- topic/shortdesc "> |
| ビデオストリームの幅をピクセル単位で指定する整数です。</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-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 "><keyword class="- topic/keyword ">Camera, video, Video.width, width |
| |
| </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 "> |
| ビデオストリームの幅をピクセル単位で指定する整数です。ライブストリームの場合、この値はビデオストリームをキャプチャしている Camera オブジェクトの <codeph class="+ topic/ph pr-d/codeph ">Camera.width</codeph> プロパティと同じです。録画済みビデオファイルの場合、この値はビデオの幅です。 |
| |
| <p class="- topic/p ">このプロパティは、ステージ上の実際の Video オブジェクトのサイズとは関係なく、キャプチャしたのと同じサイズでユーザーに対してビデオを表示する場合などに使用します。</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="flash.media.xml#Camera/width" class="- topic/link "><linktext class="- topic/linktext ">flash.media.Camera.width</linktext></link></related-links></apiValue></apiClassifier></apiPackage> |
