카메라가 검지하고 있는 모션량을 나타내는 수치입니다. 0 (모션은 검지되어 있지 않다)에서 100 (대량의 모션이 검지되고 있다)까지의 값이 설정됩니다. 이 property의 값은,setMotionLevel() Methods로 설정을 건네줄 필요가 있을지 어떨지를 판단하는데 도움이 됩니다.

Video.attachCamera() Methods가 불려 가지 않기 때문에, 사용 가능한 카메라가 아직 사용되어 있지 않은 경우는, 이 property가 -1 로 설정됩니다.

압축되어 있지 않은 로컬 비디오만을 스트리밍 하는 경우, 이 property는 event 핸들러에 함수를 할당이 끝난 상태일 때 한계 설정됩니다. 그 이외의 경우는 undefined 가 됩니다.

See also

현재의 송신 비디오 피드로 사용할 수 있는 최대 대역폭 (바이트 단위)을 지정하는 정수입니다. 0 은, 비디오의 프레임 품질을 유지하기 위해서 필요한 대역폭을 사용할 수 있는 것을 나타냅니다.

이 property의 값을 설정하려면 ,setQuality() Methods를 사용합니다.

See also

현재의 데이터 capther 레이트 (1 초 쯤의 프레임수)입니다. 이 property를 설정할 수 없습니다. 다만,setMode() Methods를 사용하면, 이것에 관계하는 fps property를 설정할 수가 있습니다. 이 property는, 데이터를 capther 할 때의 희망 최대 frame rate를 지정합니다.

See also

희망하는 최대 데이터 capther 레이트 (1 초 쯤의 프레임수)입니다. 사용할 수 있는 최대 레이트는, 카메라의 성능에 따라서 다릅니다. 이 property로 설정한 값을 카메라가 지원(support)하고 있지 않는 경우는, 이 frame rate는 달성되지 않습니다.

• 이 property에 필요한 값을 설정하려면 ,setMode() Methods를 사용합니다.
• 현재의 데이터 capther 레이트를 조사하려면 ,currentFPS property를 사용합니다.

See also

현재의 capther의 높이 (픽셀 단위)입니다. 이 property에 값을 설정하려면 ,setMode() Methods를 사용합니다.

See also

카메라의 인덱스를 지정하는 제로로부터 시작되는 정수입니다. 이것은,names property로부터 돌려주어지는 배열의 인덱스와 같습니다.

See also

비디오 압축 알고리즘에 의해 보간 되는 것이 아니라,(키 프레임으로 불린다) 완전 송신되는 비디오 프레임을 지정합니다. 디폴트치는 15 로, 15 의 프레임 마다 프레임이 키 프레임이 됩니다.

카메라가 취득하는 로카르뷰를, Flash Media Server 를 사용한 라이브 송신으로 사용되도록(듯이) 압축 및 해동하는지 (true), 또는 압축되어 있지 않은 상태로 하는지 (false)를 지정합니다. 디폴트치는 false 입니다.

이 값을 설정하려면 ,Camera.setLoopback() 를 사용합니다. 이 property가 true 인 경우에 사용하는 압축율을 설정하려면 ,Camera.setQuality() 를 사용합니다.

See also

activity 이벤트를 호출하는데 필요한 모션량을 지정하는 수치입니다. 지정할 수 있는 값은 0 ~ 100 입니다. 디폴트치는 50 입니다.

비디오는 motionLevel property의 값에 관계없이 표시할 수 있습니다. 상세한 것에 대하여는, setMotionLevel()를 참조해 주세요.

See also

카메라가 모션 검지를 정지하고 나서,activity 이벤트가 불려 갈 때까지의 시간 (밀리 세컨드 단위)입니다. 디폴트치는 2000 (2 초)입니다.

이 값을 설정하려면 ,setMotionLevel() 를 사용합니다.

See also

유저가 [Macromedia Flash Player 설정] 패널의 [프라이버시] 로 카메라에의 액세스를 금지했는지 (true), 또는 허가했는지 (false)를 나타내는 불리언 값입니다. 이 값이 바뀌면,status 이벤트가 dispatch됩니다.

See also

현재의 카메라의 이름을 나타내는 string입니다. 카메라의 하드웨어로부터 돌려주어지는 것입니다.

See also

[Macromedia Flash Player 설정] 패널의 [프라이버시] 를 표시하지 않고 , 사용할 수 있는 모든 카메라의 이름이 포함되는 string 배열을 취득합니다. 이 배열은 ActionScript 외 배열과 같이 동작합니다. 이 배열을 사용해, 각각의 카메라의 제로로부터 시작되는 인덱스와 시스템상의 카메라의 수 (names.length)를 조사할 수가 있습니다. 상세한 것에 대하여는, Array 클래스의 names 를 참조해 주세요.

names property가 불려 가면, 하드웨어를 광범위하게 걸쳐 조사할 필요가 있습니다. 이 때문에, 배열을 작성하기까지 몇초간 걸리는 일이 있습니다. 대부분의 경우는, 디폴트의 카메라를 사용할 수 있습니다.

See also

필요한 화질 레벨을 지정하는 정수입니다. 각 비디오 프레임에 적용되는 압축율에 의해 정해집니다. 지정할 수 있는 품질치는 1 (최저 품질, 최대 압축율)에서 100 (최고 품질, 압축 없음)까지입니다. 디폴트치는 0 입니다. 이것은, 사용할 수 있는 대역폭을 넘는 것이 없게, 화질이 필요에 따라서 변경되는 것을 나타냅니다.

이 property의 값을 설정하려면 ,setQuality() Methods를 사용합니다.

See also

현재의 capther의 폭 (픽셀 단위)입니다. 이 property에 필요한 값을 설정하려면 ,setMode() Methods를 사용합니다.

See also

비디오를 capther 하는 Camera object에의 참조를 돌려줍니다. 비디오의 capther를 실제로 개시하려면 , Camera object를 Video object에 관련지을 필요가 있습니다. 상세한 것에 대하여는,Video.attachVideo() (을)를 참조해 주세요.

getCamera() Methods를 여러 차례 호출했을 경우는, 같은 카메라에의 참조가 돌려주어집니다. 따라서,firstCam:Camera = getCamera() 와 secondCam:Camera = getCamera() 와 같은 코드가 포함되어 있는 경우,firstCam 와 secondCam 는 어느쪽이나 같은 유저의 디폴트의 카메라를 참조합니다.

일반적으로는,name Parameters의 값은 지정하지 않고, 단지 getCamera() 를 사용해 디폴트의 카메라에의 참조를 취득합니다. 유저는, 이 섹션으로 후술 하는 [카메라] 박스로, Flash 로 사용하는 디폴트의 카메라를 지정할 수 있습니다.

SWF 파일로 getCamera() 로부터 돌려주어진 카메라에 액세스 하려고 하면, 그 카메라에의 액세스를 허가할지 어떨지를 유저가 선택하기 위한 다이알로그 박스가 표시됩니다. 어플리케이션 윈도우의 크기는 반드시 215×138 픽셀 이상으로 설정해 주세요. 이것은, 다이알로그 박스를 표시하기 위해서 필요한 Flash 의 최소 크기입니다. 유저가 이 다이알로그 박스에 응답하면, Flash Player 는 유저의 응답을 나타내는 status 이벤트로 정보 object를 돌려줍니다. Camera.muted 는 유저가 카메라에의 액세스를 금지한 것을 나타내,Camera.unmuted 는 그것을 허가한 것을 나타냅니다. status 이벤트를 사용하지 않고 유저가 카메라에의 액세스를 허가했는지 어떠했는지를 판단하려면 ,muted property를 사용합니다.

유저는, 재생중의 SWF 파일을 오른쪽 클릭 (Windows) 또는 Control 키를 누르면서 클릭 (Macintosh)해,[설정] 을 선택해 [프라이버시] 패널을 열어,[다음에 확인] 을 선택하면, 특정의 도메인에 대한 영속적인 프라이버시 설정을 지정할 수 있습니다.

ActionScript 로부터 유저에 대해서 허가 또는 거부를 설정할 수 없습니다. 다만,Security.showSettings(SecurityPanel.PRIVACY) 를 호출하는 것으로, 유저의 [프라이버시] 패널을 표시할 수 있습니다. 유저가 [다음에 확인] 을 선택하고 있었을 경우, SWF 파일이 이 도메인으로부터 카메라에 액세스 하는 것을 허가하는지 금지하는지를 확인하는 메세지는 표시되지 않습니다.

getCamera() 가 null 를 돌려주었을 경우, 카메라는 다른 어플리케이션에 의해 사용되고 있는지, 그 시스템에는 카메라가 설치(Install) 되고 있지 않습니다. 카메라가 설치(Install) 되고 있는지 어떤지를 조사하려면 ,names.length property를 사용합니다. getCamera() 가 참조하는 카메라를 유저가 선택하기 위한 [카메라] 박스를 표시하려면 ,System.showSettings(SecurityPanel.CAMERA) 를 사용합니다.

카메라의 하드웨어 스캔에는 시간이 걸립니다. 카메라가 1 개에서도 발견되면, 그 Flash Player 인스턴스의 존속중은, 하드웨어가 다시 스캔 될 것은 없습니다. 그러나, 카메라가 발견되지 않았던 경우는,getCamera 가 불려 갈 때마다 하드웨어가 스캔 됩니다. 이 동작은, 유저가 카메라를 접속하는 것을 잊었을 경우에 편리합니다. getCamera 를 호출하기 위한 [재시행] 버튼을 SWF 파일에 준비하면, 유저가 SWF 파일을 재기동하지 않아도 카메라를 찾아낼 수가 있습니다.

See also

비디오 압축 알고리즘에 의해 보간 되는 것이 아니라,(키 프레임으로 불린다) 완전 송신되는 비디오 프레임을 지정합니다. 일반적으로, 이 Methods는, Flash Media Server 를 사용해 비디오를 송신하고 있는 경우에만 사용합니다.

Flash Video 압축 알고리즘에서는, 비디오의 마지막 프레임으로부터의 변경만을 송신해, 비디오를 압축합니다. 이러한 변경 부분이 보간 프레임이라고 보여집니다. 비디오의 프레임은, 전의 프레임의 내용에 응해 보간 됩니다. 다만, 키 프레임은 완전한 비디오 프레임이기 (위해)때문에, 전의 프레임으로부터 보간 될 것은 없습니다.

keyFrameInterval Parameters의 값을 설정하는 방법을 판별하려면 , 대역폭의 사용량과 비디오 재생 accessibility의 양쪽 모두를 검토합니다. 예를 들어,keyFrameInterval 에 대해서 큰 값을 지정하면 (키 프레임의 송신이 적게 된다), 대역폭의 사용량이 감소합니다. 다만, 이것은 비디오의 특정의 포인트로 재생 헤드의 위치를 지정할 때에 필요로 하는 시간을 늘리게 됩니다. 비디오를 재개하려면 , 전의 비디오 프레임을 보다 많이 보간 할 필요가 있습니다.

반대로,keyFrameInterval 에 대해서 작은 값을 지정하면 (키 프레임의 송신이 많아진다), 비디오 프레임 전체의 송신이 많아지기 (위해)때문에, 대역폭의 사용량이 증가합니다만, 녹화 끝난 비디오내에서 특정의 비디오 프레임을 시크 할 때에 필요로 하는 시간은 줄어듭니다.

See also

카메라의 로카르뷰에 대해서 압축한 비디오 스트림(Stream)을 사용할지 어떨지를 지정합니다. 일반적으로, 이 Methods는, Flash Media Server 를 사용해 비디오를 송신하고 있는 경우에게만 사용합니다. compress 를 true 로 설정하면, 리얼타임에 표시했을 경우에, 비디오가 어떻게 유저로 표시될까를 정확하게 확인할 수 있습니다.

압축한 스트림(Stream)은, 비디오의 품질 설정의 preview 등, 테스트 목적으로 사용하는 경우에는 도움이 됩니다만, 로카르뷰는 단순하게 압축되지 않기 때문에, 매우 처리 코스트가 듭니다. 로카르뷰는 압축되면, 송신하기 위해서 라이브 접속으로 사용되는 형식에 편집되어 로컬로 표시하기 위해서 해동됩니다.

compress 를 true 로 설정했을 경우에 사용하는 압축율을 설정하려면 ,Camera.setQuality() 를 사용합니다.

See also

카메라의 capther 모드를 지정의 요건에 가장 가까운 native mode로 설정합니다. 지정한 모든 Parameters에 일치하는 native mode가 카메라에 없는 경우는, 요구한 모드에 가장 가까운 capther 모드가 선택됩니다. 이것에 의해, 화상의 일부가 잘라내지거나 프레임이 삭제될 가능성이 있습니다.

디폴트에서는, 화상의 크기를 유지하기 위해서, 필요에 따라서 프레임이 삭제됩니다. 삭제되는 프레임의 수를 최소한으로 억제하려면 ,favorArea 에 false 를 지정합니다. 다만, 이것에 의해 화상의 크기는 작아집니다.

native mode를 선택했을 경우는, 지정한 종횡비가 생기는 한 유지됩니다. 예를 들어,myCam.setMode(400, 400, 30) 커멘드를 실행해, 그 카메라로 이용할 수 있는 최대의 폭과 높이가 320 및 288 인 경우는, 폭과 높이가 함께 288 으로 설정됩니다. 폭과 높이를 같은 값으로 설정하는 것으로, 요구되었다 1:1 의 종횡비가 유지됩니다.

요구한 값에 가장 가까운 모드가 선택된 후에, 할당할 수 있었던 폭, 높이, 비디오 capther 레이트를 조사하려면 ,width,height, 및 fps property를 사용합니다.

See also

activity 이벤트를 dispatch하기 위해서 필요한 모션의 양을 지정합니다. 액티버티가 없는 경우에, 모션이 정지했다고 판정해 이벤트를 dispatch할 때까지의 시간을 밀리 세컨드 단위로 설정할 수도 있습니다.

메모 :비디오는 motionLevel Parameters의 값에 관계없이 표시할 수 있습니다. 이 Parameters는, 비디오를 실제로 capther 또는 표시할지 어떨지는 아니고, 이벤트를 dispatch하는 타이밍과 상황만을 결정합니다.

• 카메라가 모션을 전혀 검지하지 않게 하려면 ,motionLevel Parameters에 100 을 지정합니다. 이 경우,activity 이벤트는 dispatch되지 않습니다. 이 값은, 통상은 테스트 목적에게만 사용합니다. 예를 들어, 이벤트가 dispatch되었을 때에 통상 방아쇠 되는 핸들러를 일시적으로 무효로 하는 경우 등에 사용합니다.
• 카메라가 현재 검지하고 있는 모션의 양을 조사하려면 ,activityLevel property를 사용합니다.
  
  모션의 정밀도 (sensitivity)의 값이 액티버티의 값에 직접 대응합니다. 모션이 전혀 존재하지 않는 경우, 액티버티치는 0 입니다. 계속적으로 모션이 발생하고 있는 경우, 액티버티치는 100 입니다. 이동하고 있지 않는 경우, 액티버티치는 모션 정밀도치보다 낮아집니다. 이동하고 있는 경우, 액티버티치는 빈번하게 모션 정밀도치를 넘습니다.

이 Methods의 목적은 Microphone.setSilenceLevel() Methods를 닮아 있습니다. 어느 쪽의 Methods도,activity 이벤트의 dispatch 방법을 지정하기 위해서 사용합니다. 다만, Publish 하는 스트림(Stream)에 대한 영향이라고 하는 점에서는, 이 2 개의 Methods는 크게 다릅니다.

• Microphone.setSilenceLevel() 는 대역폭을 최적화하도록(듯이) 설계되고 있습니다. 오디오 스트림(Stream)을 무음이라고 생각되는 경우에는, 오디오 데이터는 송신되지 않습니다. 대신에, 무음 상태가 시작된 것을 나타내는 메세지가 송신됩니다.
• setMotionLevel() 는 모션을 검지해, 사용하는 대역폭에는 영향을 주지 않게 설계되고 있습니다. 비디오 스트림(Stream)로 모션이 검지되지 않는 동안도, 비디오는 송신됩니다.

See also

현재의 송신 비디오 피드의 1 초 쯤의 최대 대역폭, 또는 필요한 화질을 설정합니다. 일반적으로, 이 Methods는, Flash Media Server 를 사용해 비디오를 송신하고 있는 경우에만 사용합니다.

이 Methods를 사용해, 송신 비디오 피드의 요소로서 대역폭과 화질의 어느 쪽이 그 어플리케이션에 있어 중요한가를 지정합니다.

• 대역폭의 사용량을 우선하는 경우는,bandwidth 에 수치를,quality 에 0 을 지정합니다. 이렇게 하면, 지정한 대역폭내에서 최고 품질의 비디오가 송신됩니다. 필요하면, 지정의 대역폭을 넘는 것을 막기 위해서(때문에), 화질을 내릴 수 있습니다. 일반적으로는, 모션이 증가하는 만큼, 화질은 내립니다.
• 화질을 우선하는 경우는,bandwidth 에 0 을,quality 에 수치를 지정합니다. 이렇게 하면, 지정한 화질을 유지하기 위해서 필요한 만큼의 대역폭이 사용됩니다. 필요하면, 화질을 유지하기 위해서 frame rate를 내릴 수 있습니다. 일반적으로는, 모션이 증가하는 만큼, 사용하는 대역폭도 증가합니다.
• 대역폭과 품질의 양쪽 모두의 중요성이 동일한 정도인 경우는, 양쪽 모두의 Parameters에 수치를 지정합니다. 지정의 품질을 달성할 수 있어 지정의 대역폭을 넘지 않는 범위의 비디오가 송신됩니다. 필요하면, 지정의 대역폭을 넘는 일 없이 화질을 유지하기 위해서, frame rate를 내릴 수 있습니다.

See also

카메라가 세션을 개시 또는 종료했을 때에 dispatch됩니다.

ActivityEvent.ACTIVITY 정수는,activity event object의 type property치를 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

카메라가 그 스테이터스를 리포트했을 때에 dispatch됩니다. code property의 값이 "Camera.muted" 인 경우, SWF 파일의 카메라에의 액세스 허가를 거부한 것이 됩니다. code property의 값이 "Camera.unmuted" 인 경우, SWF 파일의 카메라에의 액세스를 허가하게 됩니다.

status event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

메모: 이 예에서는, 올바르게 기능시키기 위해서(때문에) 컴퓨터에 카메라를 접속해 둔다 필요가 있습니다.

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);
        }
    }
}