OLD | NEW |
1 <h2 id="usage">Usage</h2> | 1 <h2 id="usage">Usage</h2> |
2 | 2 |
3 <p>The mediaGalleries API lets you prompt the user for permission to access | 3 <p>The mediaGalleries API lets you prompt the user for permission to access |
4 media galleries on the user's computer. The permission dialog contains common | 4 media galleries on the user's computer. The permission dialog contains common |
5 media locations for the platform and allows the user to specify additional | 5 media locations for the platform and allows the user to specify additional |
6 locations. From those locations, only media files will be present in the file | 6 locations. From those locations, only media files will be present in the file |
7 system objects.</p> | 7 system objects.</p> |
8 | 8 |
9 <h2 id="manifest">Manifest</h2> | 9 <h2 id="manifest">Manifest</h2> |
10 | 10 |
(...skipping 26 matching lines...) Expand all Loading... |
37 <tr> | 37 <tr> |
38 <td>"allAutoDetected"</td> | 38 <td>"allAutoDetected"</td> |
39 <td> | 39 <td> |
40 Grants your app access to all auto-detected media galleries on the | 40 Grants your app access to all auto-detected media galleries on the |
41 user's computer. This permission causes an install-time prompt to be | 41 user's computer. This permission causes an install-time prompt to be |
42 displayed indicating that the app will have access to the user's media | 42 displayed indicating that the app will have access to the user's media |
43 files. | 43 files. |
44 </td> | 44 </td> |
45 </tr> | 45 </tr> |
46 <tr> | 46 <tr> |
47 <td rowspan="2">Access type</td> | 47 <td rowspan="3">Access type</td> |
48 <td>"read"</td> | 48 <td>"read"</td> |
49 <td>Grants your app the right to read files in media galleries.</td> | 49 <td>Grants your app the right to read files in media galleries.</td> |
50 </tr> | 50 </tr> |
51 <tr> | 51 <tr> |
52 <td>"delete"</td> | 52 <td>"delete"</td> |
53 <td> | 53 <td> |
54 Grants your app the right to delete files from media galleries. | 54 Grants your app the right to delete files from media galleries. |
55 "read" permission is a prerequisite for "delete". Specify both "read" | 55 "read" permission is a prerequisite for "delete". Specify both "read" |
56 and "delete" to obtain both types of permissions to media galleries. | 56 and "delete" to obtain both types of permissions to media galleries. |
57 </td> | 57 </td> |
(...skipping 53 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
111 <p>If present, the user's iTunes library can be accessed as a media gallery. | 111 <p>If present, the user's iTunes library can be accessed as a media gallery. |
112 In addition to the media files in the library, the "iTunes Music Library.xml" | 112 In addition to the media files in the library, the "iTunes Music Library.xml" |
113 file is also presented. Regardless of where the music files are actually on the | 113 file is also presented. Regardless of where the music files are actually on the |
114 disk (and where the xml file says they are), they are mapping into an | 114 disk (and where the xml file says they are), they are mapping into an |
115 Artist/Album/Track hierarchy like iTunes does by default. This mapping doesn't | 115 Artist/Album/Track hierarchy like iTunes does by default. This mapping doesn't |
116 always work perfectly, so there are two things to note for Apps trying to match | 116 always work perfectly, so there are two things to note for Apps trying to match |
117 the xml file with files in the gallery. If the filenames for tracks within an | 117 the xml file with files in the gallery. If the filenames for tracks within an |
118 album are not unique, they will be uniquified by adding the track id in | 118 album are not unique, they will be uniquified by adding the track id in |
119 parentheses before the extension, and if there is a colon or a slash in the | 119 parentheses before the extension, and if there is a colon or a slash in the |
120 artist, album, or track name, they are turned into underscore characters.</p> | 120 artist, album, or track name, they are turned into underscore characters.</p> |
OLD | NEW |