references.md

PythonIDE Native References

Machine-readable contracts and the full schema-backed routing table for pythonide-native.

Canonical URLs

• iOS native index
• Native capabilities schema
• llms-full.txt
• miniapp native capabilities

Persistence Boundary

• Use database for queryable records, caches, favorites, history, playlists, and SQL transactions.
• Do not import CPython sqlite3 directly in MiniApps; database is the supported host-backed SQLite bridge.
• Keep small non-secret preferences in storage, and credentials in keychain.

Music Playback Preloading

• music_player.set_queue(..., preload_count=N), music_player.prefetch_next(N), and music_player.prepare(song) only work with songs that already contain a real audio url.
• Resolve provider IDs, search-result IDs, signed URLs, or aggregation-service records in the MiniApp/data layer first, cache the playable URL with an expiry, then hand the resolved song to music_player.
• Use music_player.preload_state() to inspect prepared items when next-track playback still feels slow.

Entry Routing

Route by schema entry kind before importing.

Kind	Key	Import / component	Doc	Notes
module	alarm	import alarm	alarm-module	api
module	assistant	import assistant	assistant-module	api
module	audio_recorder	import audio_recorder	audio-recorder-module	api
module	audio_session	import audio_session	audio-session-module	api
module	avplayer	import avplayer	avplayer-module	api
module	background	import background	background-module	api
module	background_download	import background_download	background-download-module	api
module	biometric	import biometric	biometric-module	blocking_sheet
module	ble_peripheral	import ble_peripheral	ble-peripheral-module	api
module	bluetooth	import bluetooth	bluetooth-module	api
module	c_extensions	import c_extensions	c-extensions-module	reference
module	calendar_events	import calendar_events	calendar-events-module	system_picker
module	clipboard	import clipboard	clipboard-module	api
module	console	import console	console-module	blocking_sheet
module	contacts	import contacts	contacts-module	system_picker
module	coreml	import coreml	coreml-module	api
module	database	import database	database-module	api
module	device	import device	device-module	api
module	dialogs	import dialogs	dialogs-module	blocking_sheet
module	font_picker	import font_picker	font-picker-module	blocking_sheet
module	foundation_models	import foundation_models	foundation-models-module	api
module	haptics	import haptics	haptics-module	api
module	health	import health	health-module	api
module	http_server	import http_server	http-server-module	api
module	keyboard	import keyboard	keyboard-module	api
module	keychain	import keychain	keychain-module	api
module	live_activity	import live_activity	live-activity-module	api
module	location	import location	location-module	api
module	mail	import mail	mail-module	compose_sheet
module	media_composer	import media_composer	media-composer-module	api
module	message	import message	message-module	compose_sheet
module	motion	import motion	motion-module	api
module	music	import music	music-module	api
module	music_player	import music_player	music-player-module	api
module	network	import network	network-module	api
module	nfc	import nfc	nfc-module	system_picker
module	notification	import notification	notification-module	api
module	now_playing	import now_playing	now-playing-module	api
module	objc_util	import objc_util	objc-util-module	api
module	pdf	import pdf	pdf-module	api
module	permission	import permission	permission-module	api
module	photos	import photos	photos-module	api
module	qrcode	import qrcode	qrcode-module	api
module	shazam	import shazam	shazam-module	api
module	shortcuts	import shortcuts	shortcuts-module	api
module	sound	import sound	sound-module	api
module	speech	import speech	speech-module	api
module	speech_recognition	import speech_recognition	speech-recognition-module	api
module	ssh	import ssh	ssh-module	api
module	storage	import storage	storage-module	api
module	storekit	import storekit	storekit-module	api
module	translation	import translation	translation-module	api
module	video_recorder	import video_recorder	video-recorder-module	api
module	vision	import vision	vision-module	api
module	vision_helper	import vision_helper	vision-helper-module	api
module	weather	import weather	weather-module	api
module	websocket	import websocket	websocket-module	api
appui_bridge	camera_picker	appui.CameraPicker	camera-module	AppUI-first; see pythonide-appui
appui_bridge	file_importer	appui.FileImporter	file-picker-module	AppUI-first; see pythonide-appui
appui_bridge	map_view	appui.MapView	location-module	AppUI-first; see pythonide-appui
appui_bridge	photo_picker	appui.PhotoPicker	photos-module	AppUI-first; see pythonide-appui
appui_bridge	player_controller	appui.PlayerController	appui-ref-media	AppUI-first; see pythonide-appui
appui_bridge	share_link	appui.ShareLink	share-module	AppUI-first; see pythonide-appui
appui_bridge	video_player	appui.VideoPlayer	appui-ref-media	AppUI-first; see pythonide-appui
appui_bridge	web_view	appui.WebView	appui-ref-media	AppUI-first; see pythonide-appui
topic	camera	photos	camera-module	Camera capture via photos.capture_image or AppUI CameraPicker.
topic	file_picker	appui	file-picker-module	File selection has no import module; use AppUI FileImporter.
topic	share	appui	share-module	System share sheet has no import module; use AppUI ShareLink.