QMediaMetaData Class
미디어 파일에 대한 메타데이터를 제공합니다. 더 보기...
| 헤더: | #include <QMediaMetaData> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake: | QT += multimedia |
공개 유형
| enum | Key { Title, Author, Comment, Description, Genre, …, HasHdrContent } |
공개 함수
(since 6.9) auto | asKeyValueRange() const |
| void | clear() |
| void | insert(QMediaMetaData::Key k, const QVariant &value) |
| bool | isEmpty() const |
| QList<QMediaMetaData::Key> | keys() const |
| void | remove(QMediaMetaData::Key k) |
| QString | stringValue(QMediaMetaData::Key key) const |
| QVariant | value(QMediaMetaData::Key key) const |
| QVariant & | operator[](QMediaMetaData::Key k) |
정적 공용 멤버
| QString | metaDataKeyToString(QMediaMetaData::Key key) |
보호된 변수
| QHash<QMediaMetaData::Key, QVariant> | data |
정적 보호 멤버
| QMetaType | keyType(QMediaMetaData::Key key) |
관련 비멤버
| bool | operator!=(const QMediaMetaData &a, const QMediaMetaData &b) |
| bool | operator==(const QMediaMetaData &a, const QMediaMetaData &b) |
상세 설명
참고: 모든 식별자가 모든 플랫폼에서 지원되는 것은아닙니다 .
| 일반적인 속성 | ||
|---|---|---|
| 값 | 설명 | 유형 |
| 제목 | 미디어의 제목입니다. | QString |
| 저자 | 미디어의 작성자. | QStringList |
| 댓글 | 미디어에 대한 사용자의 코멘트. | QString |
| 설명 | 미디어에 대한 설명. | QString |
| 장르 | 미디어의 장르. | QStringList |
| 날짜 | 미디어 파일의 기록 날짜 및 시간, 또는 미디어 스트림의 인코딩 날짜 및 시간. | QDateTime. |
| 언어 | 미디어의 언어. | QLocale::Language |
| 게시자 | 미디어의 게시자. | QString |
| 저작권 | 해당 미디어의 저작권 고지. | QString |
| URL | 미디어의 출처를 가리키는 URL. | QUrl |
| 미디어 속성 | ||
| MediaType | 미디어의 유형(오디오, 비디오 등). | QString |
| FileFormat | 미디어의 파일 형식. | QMediaFormat::FileFormat |
| 재생 시간 | 미디어의 재생 시간(밀리초 단위). | qint64 |
| 오디오 속성 | ||
| AudioBitRate | 미디어 오디오 스트림의 비트 전송률(초당 비트 단위). | int |
| AudioCodec | 미디어 오디오 스트림의 코덱입니다. | QMediaFormat::AudioCodec |
| 비디오 속성 | ||
| VideoFrameRate | 미디어의 비디오 스트림의 프레임 속도. | qreal |
| VideoBitRate | 미디어 비디오 스트림의 비트 전송률(초당 비트 수). | int |
| VideoCodec | 미디어 비디오 스트림의 코덱. | QMediaFormat::VideoCodec |
| HasHdrContent | 비디오가 HDR 디스플레이용으로 제작된 경우 true입니다(FFmpeg 및 Darwin 미디어 백엔드에만 해당). | bool |
| 음악 속성 | ||
| AlbumTitle | 미디어가 속한 앨범의 제목입니다. | QString |
| AlbumArtist | 미디어가 속한 앨범의 주 아티스트. | QString |
| ContributingArtist | 미디어에 참여한 아티스트. | QStringList |
| TrackNumber | 미디어의 트랙 번호. | int |
| 작곡가 | 미디어의 작곡가. | QStringList |
| LeadPerformer | 미디어의 주연 연주자. | QStringList |
| CoverArtImage | 삽입된 커버 아트 이미지. | QImage |
| ThumbnailImage | 삽입된 썸네일 이미지. (6.12부터 사용 중단됨, 대신 CoverArtImage 을 사용하십시오) | QImage |
| 이미지 및 동영상 속성 | ||
| 방향 | 이미지 또는 동영상의 회전 각도입니다. | int |
| 해상도 | 이미지 또는 동영상의 크기입니다. | QSize |
멤버 유형 설명서
enum QMediaMetaData::Key
다음 메타데이터 키를 사용할 수 있습니다:
| 상수 | 값 | 설명 |
|---|---|---|
QMediaMetaData::Title | 0 | 미디어 제목 |
QMediaMetaData::Author | 1 | 미디어 작성자 |
QMediaMetaData::Comment | 2 | 코멘트 |
QMediaMetaData::Description | 3 | 간략한 설명 |
QMediaMetaData::Genre | 4 | 미디어가 속한 장르 |
QMediaMetaData::Date | 5 | 제작일 |
QMediaMetaData::Language | 6 | 미디어 언어 |
QMediaMetaData::Publisher | 7 | 미디어 발행자 정보 |
QMediaMetaData::Copyright | 8 | 미디어 저작권 정보 |
QMediaMetaData::Url | 9 | 발행인 웹사이트 URL |
QMediaMetaData::Duration | 10 | 미디어 재생 시간 |
QMediaMetaData::MediaType | 11 | 미디어 유형 |
QMediaMetaData::FileFormat | 12 | 파일 형식 |
QMediaMetaData::AudioBitRate | 13 | |
QMediaMetaData::AudioCodec | 14 | |
QMediaMetaData::VideoBitRate | 15 | |
QMediaMetaData::VideoCodec | 16 | |
QMediaMetaData::VideoFrameRate | 17 | |
QMediaMetaData::AlbumTitle | 18 | 앨범 제목 |
QMediaMetaData::AlbumArtist | 19 | 아티스트 정보 |
QMediaMetaData::ContributingArtist | 20 | |
QMediaMetaData::TrackNumber | 21 | |
QMediaMetaData::Composer | 22 | 미디어 작곡가 정보 |
QMediaMetaData::LeadPerformer | 23 | |
QMediaMetaData::ThumbnailImage | 24 | 미디어 썸네일 이미지 (6.12 버전부터 사용 중단되었으나, 하위 호환성을 위해 CoverArtImage와 동일하게 처리됨) |
QMediaMetaData::CoverArtImage | LeadPerformer + 2 | 미디어 커버 아트 |
QMediaMetaData::Orientation | 26 | |
QMediaMetaData::Resolution | 27 | |
QMediaMetaData::HasHdrContent (since Qt 6.8) | 28 | 비디오에 HDR 콘텐츠가 포함될 수 있음 (읽기 전용, FFmpeg 및 Darwin 미디어 백엔드에서만 지원) |
멤버 함수 문서
[since 6.9] auto QMediaMetaData::asKeyValueRange() const
이 해시를 키/값 쌍으로 반복 처리할 수 있는 범위 객체를 반환합니다.
이 함수는 Qt 6.9에서 도입되었습니다.
[invokable] void QMediaMetaData::clear()
메타데이터 객체에서 모든 데이터를 제거합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QMediaMetaData::insert(QMediaMetaData::Key k, const QVariant &value)
키에 value 를 삽입합니다: k.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하십시오.
[invokable] bool QMediaMetaData::isEmpty() const
메타데이터에 항목이 포함되어 있지 않으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[static protected] QMetaType QMediaMetaData::keyType(QMediaMetaData::Key key)
key 키에 대한 데이터를 저장하는 데 사용되는 메타 타입을 반환합니다.
[invokable] QList<QMediaMetaData::Key> QMediaMetaData::keys() const
QMediaMetaData::Keys의 QList 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[static invokable] QString QMediaMetaData::metaDataKeyToString(QMediaMetaData::Key key)
key 의 문자열 표현을 반환하며, 이는 사용자에게 메타데이터를 표시할 때 사용할 수 있습니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QMediaMetaData::remove(QMediaMetaData::Key k)
키에서 메타데이터를 제거합니다: k.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] QString QMediaMetaData::stringValue(QMediaMetaData::Key key) const
key 키에 대한 메타데이터를 QString 형식으로 반환합니다.
이는 주로 사용자에게 메타데이터를 표시하는 과정을 간소화하기 위한 것입니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] QVariant QMediaMetaData::value(QMediaMetaData::Key key) const
key 키에 대한 메타데이터 값을 반환하거나, 해당 키에 대한 메타데이터가 없는 경우 null QVariant 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
QVariant &QMediaMetaData::operator[](QMediaMetaData::Key k)
k 키에 저장된 데이터를 반환합니다.
QMediaMetaData rockBallad1;
rockBalad[QMediaMetaData::Genre]="Rock"멤버 변수 문서
QHash<QMediaMetaData::Key, QVariant> QMediaMetaData::data
이 변수에는 메타데이터가 저장됩니다.
참고: 이 변수는 해당 클래스의 ` protected ` 멤버입니다.
관련 비멤버
bool operator!=(const QMediaMetaData &a, const QMediaMetaData &b)
두 메타데이터 객체 a 와 b 를 비교하여, 둘이 동일하면 false 를, 서로 다르면 true 를 반환합니다.
bool operator==(const QMediaMetaData &a, const QMediaMetaData &b)
두 메타데이터 객체 a 와 b 를 비교하여, 둘이 동일하면 true 를 반환하고, 서로 다르면 false 를 반환합니다.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
