User:Pline - Revision history

Pline: Blanking this, since I moved it to Audio/Video tutorial

2013-12-18T00:33:48Z

Blanking this, since I moved it to Audio/Video tutorial

2013-12-18T00:21:57Z

Adding context menus

← Older revision		Revision as of 00:21, 18 December 2013
Line 194:		Line 194:
	= Adding context menus =		= Adding context menus =

	~~TODO~~		In addition to the default action for a list item (e.g. playing the video), your add-on can provide additional actions for an item in the context menu. Note that this only applies to list items in ''your'' add-on. Currently, you're not able to modify the context menu for movies in the user's library. To add a context menu item, you need to give it a label and a [[List of built-in functions\|built-in function]] as a string:

			<source lang="python">
			li.addContextMenuItems([ ('Refresh', 'Container.Refresh'),
			('Go up', 'Action(ParentDir)') ])
			</source>

			You can also elect to show ''only'' your context menu items:

			<source lang="python">
			li.addContextMenuItems([ ('Refresh', 'Container.Refresh') ], replaceItems=True)
			</source>

2013-12-18T00:08:20Z

Working with user settings

@@ Line 115: / Line 115: @@
 {{See also|Add-on settings}}
-TODO
+Your add-on may require some configurable options for the user (e.g. login credentials for a service). These can be stored as settings. To use settings with your add-on, you'll need to make a file defining the settings in <code>resources/settings.xml</code>. For example:
 = Showing additional metadata =

2013-12-14T21:47:51Z

Working with user settings

2013-12-14T21:32:51Z

← Older revision		Revision as of 21:32, 14 December 2013
Line 111:		Line 111:

	plugin://plugin.video.myaddon/?mode=folder&foldername=Folder+One		plugin://plugin.video.myaddon/?mode=folder&foldername=Folder+One

			= Working with user settings =

			TODO

	= Showing additional metadata =		= Showing additional metadata =
Line 174:		Line 178:
	= Adding context menus =		= Adding context menus =

	~~= Working with user settings =~~		TODO

2013-12-14T21:31:37Z

Stream info

← Older revision		Revision as of 21:31, 14 December 2013
Line 160:		Line 160:

	== Stream info ==		== Stream info ==

			In addition to metadata about the file's contents, you can add information about the audio/video streams themselves. For a video, you might do the following:

			<source lang="python">
			li.addStreamInfo('video', { 'codec': 'h264', 'aspect': 1.78, 'width': 1280,
			'height': 720, 'duration': 60 })
			li.addStreamInfo('audio', { 'codec': 'dts', 'language': 'en', 'channels': 2 })
			li.addStreamInfo('subtitle', { 'language': 'en' })
			</source>

			For complete documentation about this function, see <code>[http://mirrors.xbmc.org/docs/python-docs/12.2-frodo/xbmcgui.html#ListItem-addStreamInfo ListItem.addStreamInfo]</code>.

	= Adding context menus =		= Adding context menus =

	= Working with user settings =		= Working with user settings =

2013-12-13T03:28:25Z

Showing additional metadata

← Older revision		Revision as of 03:28, 13 December 2013
Line 148:		Line 148:

	== Info labels ==		== Info labels ==

			XBMC also lets you add useful information about each list item, like the cast, episode number, play count, and duration. The specific fields available depend on whether your list item is video, audio, or a picture. In all cases though, the format is roughly the same. For example, to add info labels to a movie, you might do the following:

			<source lang="python">
			li.setInfo('video', { 'genre': 'Horror',
			'year': 1979,
			'title': 'Alien' })
			</source>

			For a full list of the available info labels, consult the documentation for <code>[http://mirrors.xbmc.org/docs/python-docs/12.2-frodo/xbmcgui.html#ListItem-setInfo ListItem.setInfo]</code>.

	== Stream info ==		== Stream info ==

2013-12-13T03:17:47Z

Icons and thumbnails

@@ Line 129: / Line 129: @@
 li.setIconImage('icon.png')
 li.setThumbnailImage('thumbnail.png')
 </source>

2013-12-13T03:11:30Z

Icons and thumbnails

← Older revision		Revision as of 03:11, 13 December 2013
Line 117:		Line 117:

	== Icons and thumbnails ==		== Icons and thumbnails ==

			Our previous examples already showed how to set an icon, but you can also set a larger thumbnail for each list item. Both of these can be set in the <code>ListItem</code> constructor:

			<source lang="python">
			li = xbmcgui.ListItem(label='My video', iconImage='icon.png', thumbnailImage='thumbnail.png')
			</source>

			You can also set these ''after'' creating the list item:

			<source lang="python">
			li.setIconImage('icon.png')
			li.setThumbnailImage('thumbnail.png')
			</source>

	== Info labels ==		== Info labels ==

2013-12-13T03:08:16Z

Showing additional metadata

← Older revision		Revision as of 03:08, 13 December 2013
Line 116:		Line 116:
	We've already seen how to show some basic metadata, like the icon image and the type of the item (<code>'video'</code> in our case). However, there are many more pieces of metadata that XBMC understands, and adding them can make life easier on your users. We'll take a look at some of the more important ones. You can also find a full list in the [http://mirrors.xbmc.org/docs/python-docs Python documentation] for <code>[http://mirrors.xbmc.org/docs/python-docs/12.2-frodo/xbmcgui.html#ListItem xbmcgui.ListItem]</code>.		We've already seen how to show some basic metadata, like the icon image and the type of the item (<code>'video'</code> in our case). However, there are many more pieces of metadata that XBMC understands, and adding them can make life easier on your users. We'll take a look at some of the more important ones. You can also find a full list in the [http://mirrors.xbmc.org/docs/python-docs Python documentation] for <code>[http://mirrors.xbmc.org/docs/python-docs/12.2-frodo/xbmcgui.html#ListItem xbmcgui.ListItem]</code>.

	~~TODO: examples~~		== Icons and thumbnails ==

			== Info labels ==

			== Stream info ==

	= Adding context menus =		= Adding context menus =

	= Working with user settings =		= Working with user settings =