release_notes.txt

这是一个介绍关于symbian的浏览器的非常好的源代码

S60 Platform: Video Example v2.0
--------------------------------------------------------------------------------

This C++ code example demonstrates how to play and record video files.

CVideoRecorderUtility and CCamera classes are used to record a video clip, and the 
CVideoPlayerUtility class is used to play, stop, and pause video clips and show the
video clip information. In addition, playing a video clip in an external viewer using 
a document handler method is demonstrated in this example.

Video APIs are part of the Multimedia Framework (MMF) that is supported from Symbian 
OS v7.0s (S60 2nd Edition) onwards. Note that on the Nokia 6600 it is only possible to play video (see Known Issues).

--------------------------------------------------------------------------------

PREREQUISITES

Symbian C++ basics

--------------------------------------------------------------------------------

IMPORTANT FILES

src\VRexPlayerAdapter.cpp		| Used to handle video player specific tasks.
src\VRexRecorderAdapter.cpp		| Used to handle video recorder specific tasks.
src\VRexViewFinder.cpp			| Declares the video view finder control.
src\VRexFileDetailsDialog.cpp		| A dialog used to list the detailed information. regarding a video file.
src\VRexFileDetails.cpp			| Contains the video clip file detailed information.

Main classes:
CVideoRecorderUtility, CVideoPlayerUtility, CCamera, CFeatureDiscovery

--------------------------------------------------------------------------------

KNOWN ISSUES

- Nokia 6600: There are no public MMF APIs for video recording. However, this 
application has been designed so that it is still possible to install and run the 
application on the Nokia 6600 mobile phone to play already existing video clips. 

The CVRexEngine member CVideoRecorderAdapter* iVRecorder can't be initialized. It is 
checked when the recording is started in CVRexVideoView::DoRecordL(), and the 
function leaves with KErrNotSupported if the member is NULL. 

In the example application, a simple "Feature not supported" error message is 
shown. In commercial applications, a better user experience could be achieved by 
leaving the recording option completely out of the Nokia 6600 mobile phone. This could be done by
checking the phone model at run time using the MachineUid:
    TInt uid;
    HAL::Get(HAL::EMachineUid, uid); //for Nokia 6600 machine uid is 0x101FB3DD


- Nokia N90: There are random problems with the camera preview. Sometimes the camera doesn't 
start, showing only a white preview. If the clip is recorded with white preview window,
it will only record sounds to the clip.

- Nokia E70: The viewfinder has an incorrect layout/orientation after starting it in 
  portrait mode and then switching to landscape mode by opening the cover.

-Nokia N91: The recording counter does not show completely. This concerns S60 3rd Edition devices with a 176x208 display.

-Nokia N93(i): Trying to record a video clip using CVideoRecorderUtility fails on Nokia N93 and on  some software builds of Nokia N93i, if the application does not have MultimediaDD capability. See the known issue CVideoRecorderUtility requires MultimediaDD capability on Nokia N93 and Nokia N93i available at http://www.forum.nokia.com/document/Forum_Nokia_Technical_Library/contents/FNTL/CVideoRecorderUtility_requires_MultimediaDD_capability_on_Nokia_N93_and_Nokia_N93i.htm for more information.


- Emulator: This example is not fully functional in the emulator environment.

--------------------------------------------------------------------------------

IMPROVEMENT IDEAS

- In the initial state, the example shows video clips that are saved in the default video folder PathInfo::VideosPath). 
Video clips saved in any folder are not listed. Note that some devices such as the Nokia N70 multimedia device do not save
video clips in the video folder but in a subfolder (e.g., \video\200610). In order to use the video clips in the memory 
card, the calls to PathInfo::PhoneMemoryRootPath() should be changed to
PathInfo::MemoryCardRootPath(). The subfolder issue could be solved by displaying the files in the subfolder, but this 
requires significant changes to CVRexEngine and is therefore beyond the scope of this example. 

--------------------------------------------------------------------------------

RUNNING THE EXAMPLE

After the application is launched, a list of available videos is shown (the most 
recent clip recorded using the VRex application and all video clips saved in the default video folder on the c:\ drive 
are listed).

The menu options are:

Start Recorder
	-Launches the viewfinder.
	-Record the video by selecting "Record" (or the scroller key).
	-Stop recording by selecting "Stop" (or the scroller key).

Play
	-Plays any clip of the list in the player of the example application.

Embedded Player
	-Plays any clip of the list in the RealPlayer.

File Info
	-File name, format, resolution, duration, and bit rate are shown.


In S60 3rd Edition devices and later, the Feature Discovery API is used to 
check if there is a camera in the device. If there is no camera, the message "There's 
no camera in this device" is shown if you try to launch the viewfinder in order to
record.

In the Nokia 6600, a simpler "Feature not supported" error message is shown if you try 
to record (there are no video recording APIs available in the Nokia 6600). See 
Known Issues for more information.


--------------------------------------------------------------------------------

BUILD & INSTALLATION INSTRUCTIONS

Steps for building and installing the application to a device depend on the S60 platform version:

- Install Extensions Plug-in for S60 3rd Edition SDK when using S60 3rd Edition SDK (Symbian OS v9.1).

- Install Nokia 6600 Camera Plug-in for Series 60 SDK 2.0 for Symbian OS when using S60 2nd Edition (Symbian OS v7.0s)

--Mobile device (S60 3rd Edition)
    cd to /VRex/group
    bldmake bldfiles
    abld build gcce urel
    cd to /VRex/sis
    Edit the VRex_s60_3rd_ed_selfsigned.pkg's paths to match those on your system.
    makesis VRex_s60_3rd_ed_selfsigned.pkg

    Sign the SIS package 
      - See the SDK Help for information about self-signed .sis packages, or
	www.symbiansigned.com for information about Developer Certificates.

    Install the signed .sis file to an S60 3rd Edition device.
      - If you get a "Certificate error" during installation of a self-signed 
	package, check that App.Manager -> Settings -> Software Installation is 
	set to "All". This concerns at least the Nokia Eseries devices.

--Mobile device (S60 2nd Edition)
    cd to /VRex/group
    bldmake bldfiles
    abld build armi urel
    cd to /VRex/sis
    Edit the VRex.pkg's paths to match those on your system.
    makesis VRex.pkg
    Install the SIS file to the device.

--Emulator (WINSCW)
    cd to /VRex/group
    bldmake bldfiles
    abld build winscw udeb
    Start the emulator.

--Carbide.c++ IDE

    1. Make sure that the path for the current Carbide workspace does not contain any white-space characters. 
       If necessary, select a new workspace folder in Carbide (File -> Switch workspace