MPMediaQueryクラス

2010. 10. 18
●概要

MPMediaQueryオブジェクトまたはメディアクエリは、iPodライブラリからフィルタとグルーピングをしたメディアアイテムの設定を行います。

どちらもオプションで、クエリを指定しない場合はライブラリに登録されている全てになります。

クエリはグルーピングタイプを一つ持つ必要があります。

クエリのフィルタはいくつかのメディアプロパティ述語を構成することができます。

フィルタを使った構築のメソッドについては『MPMediaPropertyPredicateクラス』をプロパティキーの基礎については『MPMediaItemクラス』を参照してください。

クエリの生成と構成が終わったら、メディアアイテムまたはメディアアイテムのコレクションの取得に使用します。

コレクションについては『MPMediaItemCollection Class Reference』を参照してください。

このクラスはグルーピングタイプを適用する便利なコンストラクタを含んでおり、ほとんどの場合iPodライブラリのサブセットと適合します。

表1にコンストラクタの特徴を要約します。

フィルタについては『MPMediaItemクラス』を参照してください。

グルーピングタイプについては『Media Item Collection Grouping Keys』を参照してください。

表1 MPMediaQueryクラスの便利なコンストラクタ

コンストラクタ名iPodライブ
ラリとの一致
フィルタグルーピングタイプ
albumsQuery-MPMediaTypeMusicMPMediaGroupingAlbum
artistsQuery-MPMediaTypeMusicMPMediaGroupingArtist
audiobooksQuery-MPMediaTypeAudioBookMPMediaGroupingTitle
compilationsQuery-MPMediaTypeAny with
MPMediaItemPropertyIsCompilation
MPMediaGroupingAlbum
composersQueryYesMPMediaTypeAnyMPMediaGroupingComposer
genresQueryYesMPMediaTypeAnyMPMediaGroupingGenre
playlistsQueryYesMPMediaTypeAnyMPMediaGroupingPlaylist
podcastsQuery-MPMediaTypePodcastMPMediaGroupingPodcastTitle
songsQuery-MPMediaTypeMusicMPMediaGroupingTitle



●タスク

●メディアクエリの生成

+ albumsQuery
+ artistsQuery
+ songsQuery
+ playlistsQuery
+ podcastsQuery
+ audiobooksQuery
+ compilationsQuery
+ composersQuery
+ genresQuery
– init
– initWithFilterPredicates:

●メディアクエリの設定

  filterPredicates    property
  groupingType    property
– addFilterPredicate:
– removeFilterPredicate:

●メディアクエリの実行

  items    property
  collections    property



●プロパティ

collections

@property (nonatomic, readonly) NSArray *collections;

クエリのメディアプロパティ述語と適合するアイテムを含む、メディアアイテムコレクションの配列です。

メディアクエリのgroupingTypeでソートされた、グループ化されたコレクションの配列を返します。

このプロパティを使ったコードを以下に示します。

// メディアクエリの指定:
// メディアプロパティ述語を含まないため、iPodライブラリ全体になります
MPMediaQuery *everything = [[MPMediaQuery alloc] init];

// メディアクエリにメディアアイテムのグループを構成:ここではアーティストでグループ化
[everything setGroupingType: MPMediaGroupingArtist];

// キューからメディアアイテムコレクションの取得
NSArray *collections = [everything collections];

collections配列の各要素は、現在メディアアイテムコレクションが含まれます。

各コレクションは、特定のアーティストによるiPodライブラリのメディアアイテムが含まれます。

配列の要素はアーティスト名でソートされています。

使用できるグループタイプはについては『Media Item Collection Grouping Keys』を参照してください。



●クラスメソッド

artistsQuery

+ (MPMediaQuery *)artistsQuery

アーティスト名で適合する音楽アイテムとグループ、ソートコレクションによるメディアクエリを生成します。

戻り値は、適合するMPMediaTypeMusicのメディアアイテムとMPMediaGroupingArtistのグルーピングタイプのメディアクエリです。

メディアアイテムは、『music』と『podcast』といった一つ以上のメディアタイプを持ちます。

artistsQueryクエリは全てのMPMediaTypeMusicアイテムに適合し、必ず他のメディアタイプにも属します。


playlistsQuery

+ (MPMediaQuery *)playlistsQuery

プレイリスト名で適合するiPodライブラリとグループ、ソートコレクションによるメディアクエリを生成します。

戻り値は、適合する全てのメディアアイテムとMPMediaGroupingPlaylistのグルーピングタイプのメディアクエリです。



●インスタンスメソッド

addFilterPredicate:

- (void)addFilterPredicate:(MPMediaPredicate *)predicate

クエリにメディアプロパティ述語を追加します。

predicate:クエリに述語を追加設定するためのメディア述語を指定します。



●定数



参考文献

MPMediaQuery Class Reference






SoundSport Pulse wireless headphones
0 Comments
Leave a comment
管理者にだけ表示を許可する
Top
0 Trackbacks
Top
Calendar
04 | 2017/05 | 06
Sun Mon Tue Wed Thu Fri Sat
- 1 2 3 4 5 6
7 8 9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30 31 - - -
Recent Articles
iTunes


Swift
Categories
Tips
Profile

水月杏香

Author:水月杏香
永遠の初心者プログラマ。

Wish List
WACOM


ARC
Technical Q&A
情報プロパティリストキー
Start Developing iOS Apps Today
BOSE

SoundSport Pulse wireless headphones
Reference
NSApplicationDelegateプロトコル
NSArrayクラス
NSAutoreleasePoolクラス
NSBundleクラス
NSBundle UIKit追加分
NSCalendarクラス
NSCoderクラス
NSCodingプロトコル
NSCopyingプロトコル
NSDataクラス
NSDateクラス
NSDateFormatterクラス
NSDictionaryクラス
NSEntityDescriptionクラス
NSEnumeratorクラス
NSErrorクラス
NSExceptionクラス
NSFetchRequestクラス
NSFileHandleクラス
NSFileManagerクラス
NSIndexPathクラス
NSIndexPath UIKit追加分
NSKeyedArchiverクラス
NSKeyedUnarchiverクラス
NSKeyValueCodingプロトコル
NSLocaleクラス
NSManagedObjectクラス
NSManagedObjectContextクラス
NSManagedObjectModelクラス
NSMutableArrayクラス
NSMutableCopyingプロトコル
NSMutableDictionaryクラス
NSMutableSetクラス
NSNotificationクラス
NSNotificationCenterクラス
NSNullクラス
NSNumberクラス
NSObjectクラス
NSObject UIKit追加分
NSObjectプロトコル
NSPersistentStoreクラス
NSPersistentStoreCoordinatorクラス
NSPredicateクラス
NSPropertyListSerializationクラス
NSRunLoopクラス
NSSetクラス
NSStringクラス
NSString UIKit追加分
NSTimerクラス
NSTimeZoneクラス
NSURLクラス
NSURLProtectionSpaceクラス
NSURLRequestクラス
NSUserDefaultsクラス
NSValueクラス

UIActionSheetクラス
UIActionSheetDelegateプロトコル
UIActivityIndicatorViewクラス
UIAlertViewクラス
UIAlertViewDelegateプロトコル
UIApplicationクラス
UIApplicationDelegateプロトコル
UIBarButtonItemクラス
UIBarItemクラス
UIButtonクラス
UIColorクラス
UIControlクラス
UIDatePickerクラス
UIDeviceクラス
UIEventクラス
UIFontクラス
UIGestureRecognizerクラス
UIImageクラス
UIImageViewクラス
UIKit Function
UILabelクラス
UINavigationControllerクラス
UINavigationItemクラス
UIPickerViewクラス
UIPickerViewDataSourceプロトコル
UIPickerViewDelegateプロトコル
UIPinchGestureRecognizerクラス
UIResponderクラス
UIScreenクラス
UIScrollViewクラス
UISearchBarクラス
UISearchBarDelegateプロトコル
UISegmentedControlクラス
UISliderクラス
UISwipeGestureRecognizerクラス
UISwitchクラス
UITableViewクラス
UITableViewCellクラス
UITableViewControllerクラス
UITableViewDataSourceプロトコル
UITableViewDelegateプロトコル
UITapGestureRecognizerクラス
UITextFieldクラス
UITextFieldDelegateプロトコル
UITextInputTraitsプロトコル
UITextViewクラス
UITextViewDelegateプロトコル
UIToolbarクラス
UITouchクラス
UIViewクラス
UIViewControllerクラス
UIWebViewクラス
UIWebViewDelegateプロトコル
UIWindowクラス

AVAudioPlayerクラス
AVAudioPlayerDelegateプロトコル

CADisplayLinkクラス
CAEAGLLayerクラス
CALayerクラス

CGAffineTransform
CGBitmapContext
CGColor
CGColorSpace
CGContext
CGGeometry
CGImage
CGPath

EAGLContextクラス
EAGLDrawableプロトコル

Foundation Constants
Foundation Data Types
Foundation Functions

MPMediaItemクラス
MPMediaItemArtworkクラス
MPMediaPlaylistクラス
MPMediaPropertyPredicateクラス
MPMediaQueryクラス
MPMusicPlayerControllerクラス

Randomization Services

System Sound Services
Amazon


OpenGL ES
SQLite
Monthly Archives
Recent Comments
Recent TrackBacks
RSS Link
Visitors
QR Code
QR