Media.setItemInfo 메서드

  • 아티클

[이 페이지와 연결된 기능인 Windows 미디어 플레이어 SDK는 레거시 기능입니다. MediaPlayer로 대체되었습니다. MediaPlayer는 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 Windows 미디어 플레이어 SDK 대신 MediaPlayer를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

setItemInfo 메서드는 현재 미디어 항목에 대해 지정된 특성의 값을 설정합니다.

구문

Media.setItemInfo(
  attribute,
  value
)

매개 변수

특성 [in]

특성 이름을 포함하는 문자열입니다. Windows 미디어 플레이어 지원하는 특성에 대한 자세한 내용은 Windows 미디어 플레이어 특성 참조를 참조하세요.

value [in]

새 값을 포함하는 문자열입니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

attributeCount 속성에는 지정된 Media 개체에 사용할 수 있는 특성 수가 포함됩니다. 그런 다음, 인덱스 번호를 getAttributeName 메서드와 함께 사용하여 이 메서드와 함께 사용할 수 있는 기본 제공 특성의 이름을 확인할 수 있습니다.

이 메서드를 사용하기 전에 isReadOnlyItem 메서드를 사용하여 특정 특성을 설정할 수 있는지 여부를 확인합니다.

이 메서드를 사용하려면 라이브러리에 대한 모든 권한이 필요합니다. 자세한 내용은 라이브러리 액세스를 참조하세요.

참고

애플리케이션에 Windows 미디어 플레이어 컨트롤을 포함하는 경우 사용자가 Windows 미디어 플레이어 실행할 때까지 변경한 파일 특성이 디지털 미디어 파일에 기록되지 않습니다. C++로 작성된 원격 애플리케이션에서 컨트롤을 사용하는 경우 변경한 파일 특성은 변경한 직후 디지털 미디어 파일에 기록됩니다. 두 경우 모두 라이브러리를 통해 코드에서 변경 내용을 즉시 사용할 수 있습니다.

Windows 미디어 플레이어 10 Mobile: 이 메서드는 구현되지 않습니다.

예제

다음 JScript 예제에서는 미디어를 사용합니다. setItemInfo - 현재 미디어 항목의 Genre 특성 값을 변경합니다. genText라는 HTML TEXT 입력 요소를 사용하면 사용자가 텍스트 문자열을 입력한 다음 특성 정보를 변경하는 데 사용됩니다. Player 개체는 ID = "Player"로 만들어졌습니다.

<!-- Create the button element. -->
<INPUT type = "BUTTON"  id = "NEWGEN"  name = "NEWGEN"  value = "Change Genre" 
onClick = "
    /* Store the current media item. */
    var cm = Player.currentMedia;

    /* Get the user input from the text box. */
    var atValue = genText.value;

    /* Test for read-only status of the attribute. */
    if(cm.isReadOnlyItem('Genre') == false){

        /* Change the attribute value. */
        cm.setItemInfo('Genre' ,atValue);
    } 
">

요구 사항

요구 사항 값
버전
 Windows 미디어 플레이어 버전 7.0 이상.
DLL
Wmp.dll

추가 정보

Media 개체

Media.getItemInfo

Media.isReadOnlyItem

Settings.mediaAccessRights

Settings.requestMediaAccessRights